# NXAI 项目总览（一页看清）· 2026-10-21

> 这几天做了很多，这里按"是什么 / 有什么 / 能不能用 / 下一步"四块讲清。
> 详细记录见 `10_状态台账.md`、`18_验收结论与已知缺陷.md`、`20_修复记录_20261021.md`。

---

## 一、这个项目是什么

**UG/NX 全版本 AI 辅助编程外挂**（独立软件，不是 NX 插件）
- 自动识别本机所有 NX 版本、可切换、断网可用
- 三个 exe：`NXAI.exe`（安装/升级）、`NXAI工作台.exe`（功能面板）、`NXAI启动器.exe`（启动 UG + 全部功能）
- 云端：`https://ldeh.asia/files/`（帖子式下载站）、`/nxai/v1/update/latest`（升级检查）
- 已放弃：机床仿真（无许可）、NX 内部菜单插件（方向不符）

## 二、现在有什么（按模块清点）

### 1. 程序与工具（D:\NX_AI\tools\，460+ 个 .py）
| 类别 | 代表文件 | 作用 |
|---|---|---|
| 出工序单 | `core\propose_plan.py`、`rule_engine.py` | 按材料+刀具算 S/F/ap/ae，出工序单 |
| 建工序 | `cam_ops.py`、`cam_create_op.py`、`cam_build_local.py` | 在 NX 里建工序/刀具/程序组 |
| 三阶段 | `stage_gen.py` + `stage_override.py` + `stage_comp.py` | 粗/半精/精拆程序、M01、测尺寸补偿 |
| 模板 | `gen_templates.py`、`template_check.py` | 生成/校验 NX 工序模板 |
| 刀具库 | `make_tool_lib.py`、`tool_lib_check.py` | 生成/校验 20 把刀具 |
| 自检 | `nc_check.py`、`nc_toolfix.py` | NC 自检（空程/行程/T0/重复/抬刀）+ 刀号修正 |
| 归档学习 | `op_archive.py`、`usage_profile.py` | 刀路档案、操作习惯统计 |
| 发布 | `packaging.py`、`publish_update.py`、`cloud_sync.py`、`site_publish.py` | 打包/上传/建站 |

### 2. 数据（D:\NX_AI\data\std\）
```
tools.json             48 把刀（其中 20 把带 T1-T20）
materials.json         材料 + 别名（6061-T6 / 06Cr19Ni10 / 1.2311 / NAK80 / DC11 都能解析）
material_families.json 7 族：AL/ST/STH/SS/HRC/CI/TI（含 Vc/fz/ap/ae 区间）
cutting_params.json    11 模板 × 6 材料类 × S/F/ap/ae
template_defs.json     15 个模板定义
stage_overrides.json   半精/精加工 S/F 修正（铝精铣 Vc 94→250）
tapping_speed.json     攻牙 N 组 12.5 m/min（你的车间值，M8→497 转/621.7 进给）
```

### 3. NX 模板与后处理（D:\NX_AI\nx_templates\ + nx_post_lib\）
```
nx_templates\NXAI_工序模板.prt   15 个模板，11 个能真建工序
nx_templates\NXAI_刀具库.prt     20 把刀，T1-T20 唯一，刀柄全引用
nx_post_lib\fanuc_dual_table\    法那科双转台 3A/4A/5A 三套（.cdl/.def/.pui/.tcl）
```

### 4. 网站（https://ldeh.asia/）
```
/                    → 自动跳转 /files/（资源站，主页）
/files/              → 74 个帖子式资源，11 个分类，可搜索、可评论、可下载
/dashboard.html      → 你原来的量化仪表盘（保留）
/nxai/v1/update/latest → 升级检查（当前 1.9.4）
```

### 5. 云端（43.167.209.150）
```
/C:/nxai-cloud/memory/     6 份记忆文档（项目总览/经验/验收/修复/模板/刀具）
/C:/nxai-cloud/outbox/     81 条成果索引（模板/后处理/数据/NC/报告）
/C:/nxai-cloud/updates/    安装包 + latest.json
```

## 三、能不能用（如实说）

### ✅ 能用的（验证过）
```
刀具库 20 把 —— 独立进程读回，T1-T20 唯一、刀柄全引用
工序模板 15 个，其中 11 个能在 NX 里真正建出工序
8 个铣类模板进刀全部螺旋（.prt 读回验证）
材料分族 7 类 —— 304 vs 6061 参数差 9 倍（手算核对过）
三阶段拆程序 —— A01/A02/A03 三个独立 NC，M01、余量 0.2/0.05/0，半精与精同刀
刀路自检 —— 空程/时间/行程/T0/重复/抬刀 + 三联预览图
后处理三套已归档（4A 的 A 轴 plane=YZ 已确认）
网站：74 个资源可下载、可评论、有分类
```

### ⚠️ 有缺陷（别硬上机）
```
🔴 后处理注册未完成：NX 里还是旧条目（3Zdbzq/4Zdbzq，打不开）
   需管理员跑 tools\post_register_local.bat 一次
🟠 型腔铣/剩余铣/引导曲线/侧铣 4 个模板建不出工序（NX 限制，参数已预置，需手建）
🟠 层间斜进刀未落地（现在层间是 Direct 直下）
🟠 半精/精进给修正只验证到参数层，还没重新生成 NC 验证实际时间
🟠 全自动选面已暂停（P10-07，改模板式半自动）
```

### 数据流现状
```
你能做的：选零件 → 出工序单（参数正确）→ 用模板带刀具/工序 → 手选区域 → 生成刀路
           → 自检 + NX 模拟 → 后处理（需先注册后处理）
不能做的：一键出完整零件程序（几何识别未通）
```

## 四、这几天的时间线

| 日期 | 做了什么 |
|---|---|
| 10-19 白天 | 授权体系、云端、安装器、工作台 exe |
| 10-19 晚 | 工作台增强（P9-02/03）、零件过期检测（P10-01）、9 种工序（P10-02） |
| 10-20 上午 | 一键准备（P10-03）、工序单编辑器（P10-04）、三阶段（P10-05）、材料分族（P10-06） |
| 10-20 下午 | 模板 11 个（P10-07B）、刀具材料参数三库（P10-07C）、刀具库 20 把（P10-07F）、螺旋进刀全通过（P10-07G） |
| 10-20 晚 | 刀路自检（P10-08）、打包 1.8.2、上传云端 |
| 10-21 凌晨 | 修半精进给（6.6 倍）、修自检误报、打包 1.9.0 |
| 10-21 上午 | 帖子式下载站 + 评论 + 分类 + 设为主页、型腔铣/剩余铣/侧铣/引导曲线 4 模板、刀具模板文档、打开模板按钮 + 操作记录、打包 1.9.4 |

## 五、下一步（按优先级，我建议的顺序）

### 第一优先：让它"能上机"
```
1. 注册后处理（你右键管理员跑一次 bat）
2. 重新生成一次三阶段 NC，验证半精/精时间真的从 306 降到 ~46 分钟
3. 层间斜进刀落地（改 gen_templates 的 TransferBetweenLevelsType）
```

### 第二优先：让"学习"成型
```
4. 档案补全字段（材料/刀径/S/F）—— 改 NX 里的生成脚本
5. 攒够样本后做 op_learn.py（建议值，不自动应用）
```

### 第三优先：云端一体化（暂缓）
```
6. 本地↔Hermes↔QQ 打通（P10-11/12）
7. 2GB 内存预算（P10-13）、迁移准备（P10-14）
```

## 六、文件在哪（速查）

```
本机工程      D:\NX_AI\
  模板        D:\NX_AI\nx_templates\
  后处理      D:\NX_AI\nx_post_lib\fanuc_dual_table\
  参数数据    D:\NX_AI\data\std\
  工具        D:\NX_AI\tools\
  文档        D:\NX_AI\docs\
  安装包      D:\NX_AI\dist\ + 桌面 NXAI-1.9.4-成品.zip
  运行记录    D:\NX_AI\状态\（各卡 done.json、自检、档案、日志）

网站          https://ldeh.asia/（自动跳 /files/）
云端记忆      /C:/nxai-cloud/memory/
```

## 七、一句话总结

```
这三天从"什么都没有"到"有一套能半自动用的工具 + 一个能下载的资源站"。
核心资产：15 个工序模板、20 把刀、7 类材料参数、三阶段拆程序、刀路自检。
最大短板：后处理注册没做、4 个模板建不出工序、全自动选面没通。
现在最该做的一件事：把后处理注册跑通，然后重新生成一次三阶段 NC 验证时间。
```
