154 lines
6.8 KiB
Markdown
154 lines
6.8 KiB
Markdown
# 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
|
||
```
|