# 验收结论与已知缺陷（2026-10-20 收尾）

> 这是第一天（2026-10-19 ~ 10-20）的收官记录。给下一个 agent / 未来的自己看。
> 结论：**可用的半自动辅助编程工具**，不是无人值守全自动系统。

## 一、交付物（已打包上云）

```
版本：1.8.2
本机：C:\Users\Administrator\Desktop\NXAI-1.8.2-成品.zip   3.00 MB
云端：/C:/nxai-cloud/updates/NXAI-1.8.2-*.zip             3,149,794 B
      /C:/nxai-cloud/updates/latest.json                  版本 1.8.2
公网：https://ldeh.asia/nxai/v1/update/latest
包内容：473 个文件（含模板/刀具库/后处理/数据/文档/工具）
安装：解压后双击根目录 NXAI.exe → 选目标目录
```

## 二、已验证可用（有实测证据）

| 能力 | 证据 |
|---|---|
| 刀具库 20 把 | 独立进程读回 tools=20、T=1..20 唯一、holder BT40-ER32 全引用 |
| 工序模板 11 道 | .prt 200.8 KB，独立读回 ops=11 |
| **8 个铣类全螺旋进刀** | .prt 读回：FACE/SIDE/ZLEVEL=helical；POCKET_R/S/F/SURFACE=helical_clw；HOLEMILL=helical |
| 材料分族 7 类 | 304 vs 6061：Vc 62.9 vs 325（rpm 差 5.2 倍、F 差 9.2 倍），手算核对 2 组 |
| 三阶段拆程序 | A01_粗/A02_半精/A03_精 三个独立 NC；余量 0.2/0.05/0；半精结尾有 M01+测量提示；半精与精同一把 D8 |
| 刀路自检 | nc_check.py 29.7 KB：空程占比、时间估算、行程越界、T 号、重复刀路、抬刀次数 + 三联预览 PNG |
| 后处理三套 | 法那科双转台 3A/4A/5A 已归档；4A 的 A 轴 plane=YZ 已确认（写 ZX 则永不出 A） |
| 门禁 | 434 个 .py 0 错误；评测 21/21；漂移 0 |

## 三、已知缺陷（必须知道，别当它能直接上机）

### 🔴 1. 刀号仍是 T0（致命）
```
A01/A02/A03 三个 NC 实测 刀号=[0]
→ 上机会 T0 报警或换刀异常
→ 必须先在 NX 里给每把刀设 T 号（T1-T20），再后处理
```

### 🟠 2. 半精/精进给用了钢件参数（严重）
```
A01_粗   F3055.8  → 切削 12.9 分钟    （铝件参数，正确）
A02_半精 F299.2   → 切削 306 分钟     （钢件参数，慢 24 倍）
A03_精   F299.2   → 切削 303 分钟     （同上）
同零件同刀，材料族不一致 → 必须按工序单材料重算半精/精的 S/F
```

### 🟠 3. 抬刀过多，一刀流未做到极致
```
A01 抬刀 216 次（12.9 分钟）
A02 抬刀 319 次
→ 层间斜进刀(ramp) 还没真正落到模板里
```

### 🟠 4. 重复切削告警 99.5%（测量假象，需改算法）
```
nc_check 报"重复切削面积 99.5%"，但它自己注明：
  切削段 XY 中位 3.83mm < 网格 5mm → 网格饱和
→ 网格应改小（2mm）或按刀径自适应，否则告警不可信
```

### ⏸ 5. 全自动选面已暂停（P10-07）
```
原因：几何绑定 API 反复失败（9 种工序只 2 种出刀路）
决策：改模板式半自动 —— 用户手选加工区域，模板提供参数与策略
保留成果：geom_entry_matrix.json（63KB 探测表）、region_plan.py（18.8KB 区域识别）
```

## 四、第二天该先做什么（优先级）

1. **修 T0 刀号**（最危险，一票否决）
2. **修半精/精进给错配**（决定程序能不能用，306 分钟→30-60 分钟）
3. **层间斜进刀落地**（减少抬刀，提升一刀流）
4. 修 nc_check 的网格饱和问题
5. 云端：本地↔Hermes↔QQ 打通（P10-11/12）、2GB 内存预算（P10-13）、迁移准备（P10-14）

## 五、使用建议（给操作者）

```
✅ 该用：
   用 NXAI_刀具库.prt 带 20 把刀进零件（Ctrl+C/Ctrl+V）
   用 NXAI_工序模板.prt 带工序（同上），只选 8 个铣类里进刀已验证的
   出程序后用 nc_check.py 自检 + NX 3D 动态模拟双确认
   材料选对了参数才对（304 和 6061 差 9 倍进给）

❌ 别用：
   别把现在的 NC 直接上机（T0 + 半精进给错配）
   别指望全自动出完整零件程序（几何识别未通）
   别用 P10-07 的自动选面功能（已暂停）
```

## 六、文件位置速查

```
本机
  D:\NX_AI\                          工程根
  D:\NX_AI\nx_templates\             NXAI_工序模板.prt / NXAI_刀具库.prt
  D:\NX_AI\nx_post_lib\fanuc_dual_table\  3A/4A/5A 后处理
  D:\NX_AI\data\std\                 tools/materials/cutting_params/template_defs/tapping_speed
  D:\NX_AI\tools\                    nc_check.py / template_check.py / tool_lib_check.py / cloud_sync.py
  D:\NX_AI\docs\                     00_项目记忆总览.md / 16_工序模板参数表.md / 18_验收结论(本文件)
  D:\NX_AI\状态\                     各卡 done.json、artifacts\check_*.json、preview_*.png

云端 /C:/nxai-cloud/
  memory\    00_项目记忆总览.md / 11_经验总结与交接.md / 18_验收结论与已知缺陷.md
  outbox\    nc/ prt/ templates/ posts/ data/ docs/ reports/ + index.json
  updates\   安装包 + latest.json
```

## 七、红线（延续）

- 不改 `E:\Program Files\Siemens\NX*` 官方文件
- 不改 `C:\HermesAgent` 核心（只按 plugins/tools/skills 扩展）
- 不把密码/token 写进 D:\NX_AI 明文
- 云端永不跑 NX（无许可）
- 不伪造数据：刀路长度、余量、进刀类型必须从 .prt / NC 读回