diff --git a/docs/feedback/2026-10-13/TEST_PLAN.md b/docs/feedback/2026-10-13/TEST_PLAN.md new file mode 100644 index 0000000..37669f2 --- /dev/null +++ b/docs/feedback/2026-10-13/TEST_PLAN.md @@ -0,0 +1,153 @@ +# 2026-10-13 Windows 实机测试计划 + +本计划给在 Windows 游戏机上执行测试的人或 agent 用。被测内容是提交 `2190f57` 及之前的 +`6b129dd`(分支 `codex/feedback-unattended-setup-20261004`),这两个提交只在 Linux 上跑过单元测试 +(201 项),**还没有在游戏里跑过**。 + +按顺序执行。每一步都写了"通过标准",不满足就停下,记录现象,跳到最后一节"回传"。 +**不要为了让测试通过去改代码。** 发现问题如实记录,代码由另一端修。 + +## 硬性规则 + +- **不得消耗狂气(Lunacy)。** 预检如果报 `set_lunacy_to_enkephalin`,就把配置改成 0, + 不要设置 `LCP_ALLOW_LUNACY=1` 去绕过。 +- **不要在主界面点左上角返回键**,会进入剧情 Drive(见 `../2026-10-05/PITFALLS.md` 坑 7)。 +- 测试期间只能有一个操作者。不要同时用 RDP 手动操作游戏;需要看画面时用 `get_state`。 +- 测试期间不要从 RDP 断开(会话会掉到 Disc)。如果必须断开,把断开时间记下来, + 正好可以用来验证看门狗。 + +## 0. 拉取与部署 + +```powershell +cd +git fetch origin +git checkout codex/feedback-unattended-setup-20261004 +git pull +git log --oneline -3 # 第一行应为 2190f57 或更新的提交 +git submodule update --init vendor/aalc # AALC 7452fad -> b0f4393 +cd vendor\aalc; uv sync; cd ..\.. +Stop-ScheduledTask LcMCPServer; Start-ScheduledTask LcMCPServer # 让服务加载新代码 +``` + +> AALC 的 `config.yaml` 被它自己的 `.gitignore` 排除,submodule 更新不会覆盖它。 +> 但升级前请先备份一份:`copy vendor\aalc\config.yaml $env:USERPROFILE\lc_mcp\config.yaml.bak-20261013` + +**通过标准**:`vendor\aalc\.venv\Scripts\python.exe scripts\mcp_probe.py get_state` 返回 `"ok": true`,并且带有 `items`。 + +## 1. 记录当前配置(只读) + +把以下几项的当前值记进结果里,不需要改: + +```text +set_win_size / win_input_type / background_click / set_windows +select_team_by_order / daily_teams / teams_active_queue +set_lunacy_to_enkephalin +teams 里 teams_active_queue 对应队伍的 sinner_order +桌面分辨率与游戏客户区尺寸(get_state 返回的 screen.w / screen.h) +``` + +## 2. 坐标缩放:网格识别 + +先手动进入 罪人 → Identities 网格,然后执行: + +```powershell +vendor\aalc\.venv\Scripts\python.exe scripts\levelup.py list +``` + +**通过标准**:能列出队内人格(`inTeam = Y`),等级大致正确(网格 OCR 本身会有误读, +见 PITFALLS 坑 6)。客户区不是 1600×900 时也应能列出来——这一步验证的就是坐标缩放。 +如果输出 `[warn] 客户区 ... 不是 16:9`,记录下来。 + +## 3. 配置预检 + +```powershell +vendor\aalc\.venv\Scripts\python.exe scripts\mcp_probe.py run_task --% {\"task\":\"reward\"} +# 等约 10 秒 +vendor\aalc\.venv\Scripts\python.exe scripts\mcp_probe.py task_status --% {\"lines\":20} +``` + +> `--%` 让 PowerShell 把后面的内容原样传给 python。不加 `--%` 的话, +> Windows PowerShell 5.1 会吃掉 JSON 里的双引号。 + +**通过标准**(二选一,都算通过,记录是哪一种): + +- `reward` 正常跑起来或跑完:说明预检放行; +- `state=failed`、`exit_code=3`,`errors` 里带 `preflight:`:说明预检拦下了。把原因原样记录下来。 + 如果原因是真实的配置问题,按提示在 AALC 界面里改好后重试; + 如果你认为是误报,**不要改配置**,直接记录,跳到"回传"。 + +日志里应能看到 `[lc_mcp] patch: 队伍名改为编号精确匹配`。 + +## 4. 手动跑完整一轮 + +```powershell +vendor\aalc\.venv\Scripts\python.exe scripts\auto_cycle.py --mirror 1 +``` + +预计 1–1.5 小时:daily 约 20 分钟,镜牢一局约 40 分钟。运行期间不要操作游戏。 + +**通过标准**: + +- 退出码 0,并且最后一行是 `=== 一轮结束 ...`; +- `~\lc_mcp\cycles\` 下生成了同名的 `cycle_*.log` 与 `cycle_*.json`; +- daily 对应的任务日志里,`配队人数OCR得到` 出现 0 次,选队成功 6 次; +- 确实选中了 TEAMS #1(不是 #10)。日志行号 `team_formation.py:188` 表示按名字查找, + `:163` 表示按位置查找(`select_team_by_order: true`)。记录走的是哪一条: + 名字查找这条路径正是精确匹配补丁覆盖的地方; +- 升级/同步一步:报 OK 的项在游戏里确实生效了(等级变化、同步阶数变化), + 报 FAIL 的项在游戏里确实没生效。**这是验证新判定逻辑的关键,请逐项核对。** + +体力不足导致镜牢失败是预期情况,脚本只会记一条警告,然后继续往下跑。这种情况下记录下来,不算失败。 + +## 5. 窗口守护(可选,有条件再做) + +在第 4 步运行期间,如果遇到 RDP 重连或分辨率变化,检查任务日志里有没有: + +```text +[lc_mcp] window guard: 客户区 AxB 已调回 CxD +``` + +不要为了触发它故意去改分辨率;没遇到就记"未触发"。 + +## 6. 注册计划任务 + +第 4 步通过后再做: + +```powershell +powershell -ExecutionPolicy Bypass -File scripts\install_unattended.ps1 -At 05:30 -Mirror 1 +Get-ScheduledTask LcMCPKeepDisplay, LcMCPDailyCycle | Format-List TaskName, State +``` + +**通过标准**:两个任务的状态都是 `Ready`;`install_unattended.ps1` 没有报 PowerShell 语法错误。 +如果报的语法错误行号对不上(10-04 坑 6),检查文件是不是带 BOM:开头 3 个字节应为 `EF BB BF`。 + +之后让它在第二天 05:30 自动跑一轮,不要人为干预。 + +## 7. 看门狗 + +计划任务装好后,至少等到看门狗触发一次(会话掉到 Disc 时)。看 `~\lc_mcp\keep_display.log`: + +**通过标准**:新的日志行格式为 `tscon exit=N said: ... | session S now: ...`。 +不再出现 `(no output file)`;会话号 `S` 应等于游戏进程所在的会话。 +就算 tscon 仍然失败也照实记录,这一步的目的是拿到真实的退出码和错误输出。 + +## 回传 + +在本目录下新建 `results/`,放入以下内容,提交并推送到同一分支: + +| 文件 | 内容 | +|---|---| +| `RESULTS.md` | 第 0–7 步每步写:通过/失败/未执行 + 现象,外加第 1 步记录的配置 | +| `cycles/` | `~\lc_mcp\cycles\cycle_*.log` 与 `cycle_*.json`(手动那轮 + 第二天自动那轮) | +| `runs/` | 对应时段的 `~\lc_mcp\runs\task_*.log`,大文件先 gzip | +| `keep_display.log` | `~\lc_mcp\keep_display.log` | +| `captures/` | 失败现场截图(可选),**截图不能露出账号 UID 底栏** | + +**不要提交**:`~\lc_mcp\token`、API key、`config.yaml` 原文件(只在 RESULTS.md 里摘抄上面列的那几项)、 +完整的会话转录。 + +```powershell +git add docs/feedback/2026-10-13/results +git commit -m "2026-10-13 实机测试结果" +git push origin codex/feedback-unattended-setup-20261004 +```