Files
lc-mcp/docs/feedback/2026-10-13/TEST_PLAN.md
2026-10-13 03:15:58 +00:00

154 lines
6.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 <lc-mcp 仓库目录>
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
```