# UG/NX 全版本 AI 外挂 —— 规划与 Trae CN 施工包

生成日期：2026-10-16　机器：本机（NX 2212 + NX 2412 双版本共存）

## 这个包里有什么

| 文件 | 作用 | 给谁看 |
|---|---|---|
| `00_总规划与范例调研.md` | 长期规划：范例调研、架构决策、路线图、风险登记册 | 你（决策参考） |
| `01_资产盘点与优化评估.md` | Trae CN 既有产出的家底盘点 + 优化决策（保留/重构/废弃） | 你 + Trae |
| `02_TraeCN施工任务书.md` | **17 张任务卡** + 公共约束 + 交接协议 | **Trae CN** |
| `queue\*.txt` | 已抽好的投喂文件（每张卡自带公共约束），共 17 个 | 投喂器 |
| `tools\trae_feeder.ps1` | 自动投喂器：把 queue 里的卡逐个送进 Trae，靠 done.json 判断进度 | 你运行 |
| `tools\run_feeder.bat` | 包装脚本（绕过执行策略 + UTF-8 控制台），**双击即用** | 你运行 |
| `tools\make_queue.py` | 修改任务书后重新生成 queue | 你运行 |

## 快速开始

```bat
:: 1) 先看它会做什么（不发任何按键）
tools\run_feeder.bat -DryRun

:: 2) 校准：只投一张卡，确认能正常粘贴并等到 done.json
tools\run_feeder.bat -MaxCards 1

:: 3) 无人值守跑到额度用完
tools\run_feeder.bat
```

**跑之前的三个前提**：
1. Trae CN 已打开，工作区是 `D:\NX_AI`，聊天输入框点一下让它获得焦点。
2. 在 Trae 设置里把 `D:\NX_AI\` 加入免打扰白名单，否则权限弹窗会卡住流程。
3. 把 `00`、`02` 两份文档拷到 `D:\NX_AI\docs\`，让 Trae 能读到。

## 交接契约

每张任务卡完成后，Trae 必须写 `C:\NX_AI\状态\<任务编号>.done.json`。
没写这个文件 = 这一轮没结束，投喂器不会发下一张卡。

## 先做人做的事（不依赖 Trae）

1. **杀掉幽灵进程**：任务管理器里结束 `python.exe` / `pythonw.exe` / `ugraf.exe` / `run_journal.exe` 残留。本机确实有一个在跑（`bridge.log` 每 4 秒写 30 条心跳）。
2. **作废凭据**：`连接云服务器\UG连云端_oneclick\nx_id` 是明文 SSH 私钥，视同已泄露 —— 移除 `administrators_authorized_keys` 对应项、关闭 sshd 自启、改掉 `AUDJ\tmp_*.py` 里出现过的口令。
3. **清环境残留**：`UGII_VENDOR_DIR` / `UGII_LOCAL_USER_DEFAULTS`（见 `01` 第 4 节，任务卡 P0-05 会生成清理脚本）。
4. 新工程一律落在 `D:\NX_AI\`，**不要动 `C:\NxCamToolkit` 和 `C:\NX_Plugins`**。