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

6.8 KiB
Raw Permalink Blame History

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. 拉取与部署

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. 记录当前配置(只读)

把以下几项的当前值记进结果里,不需要改:

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 网格,然后执行:

vendor\aalc\.venv\Scripts\python.exe scripts\levelup.py list

通过标准:能列出队内人格(inTeam = Y),等级大致正确(网格 OCR 本身会有误读, 见 PITFALLS 坑 6)。客户区不是 1600×900 时也应能列出来——这一步验证的就是坐标缩放。 如果输出 [warn] 客户区 ... 不是 16:9,记录下来。

3. 配置预检

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. 手动跑完整一轮

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 重连或分辨率变化,检查任务日志里有没有:

[lc_mcp] window guard: 客户区 AxB 已调回 CxD

不要为了触发它故意去改分辨率;没遇到就记"未触发"。

6. 注册计划任务

第 4 步通过后再做:

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 里摘抄上面列的那几项)、 完整的会话转录。

git add docs/feedback/2026-10-13/results
git commit -m "2026-10-13 实机测试结果"
git push origin codex/feedback-unattended-setup-20261004