Files
lc-mcp/docs/feedback/2026-10-04/README.md
T
Codex Agent 3547d9c43f 记录无人值守部署实测: 6 个失败根因与自愈看门狗
在一台无人在场的远程 Windows 机器上从零部署并跑通镜牢, 记录六个真实失败:
会话 Disc 导致桌面不渲染、sinner_order 全 0 导致编队死循环、
set_win_size 未留标题栏导致窗口装不下、窗口非 16:9 导致模板匹配全面崩坏、
background_click 触发 SetForegroundWindow 崩溃、ps1 无 BOM 导致中文注释解析失败。

实测结果: 一局完整镜牢 00:39:28, exit 0, 零 [ERROR]; 单测 171 项通过。

新增 scripts/keep_display.ps1 看门狗: 会话掉到 Disc 时用提权 tscon 重新挂
console 恢复渲染, 无人连接也持续出图。只在 Disc 时动作, 有人在用不插手。
正常路径与修复路径均已实测验证。

另加 session_state.py (WTS API 查会话状态, 替代在计划任务里失灵 qwinsta)
与 render_check.py (BitBlt 渲染自检)。
2026-10-05 01:21:11 +08:00

332 lines
14 KiB
Markdown
Raw 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-04 本机部署实测记录
在一台**远程、无人在场**的 Windows 机器上从零部署 lc-mcp 并跑通镜牢的完整记录。
包含六个真实失败及其根因、验证过的部分、以及**仍未验证的边界**。
上游无此环境的相关文档,所以把踩过的坑写成可复用的形式。
## 环境
| 项 | 值 |
|---|---|
| 系统 | Windows,GPU 为 Intel Iris Xe(集显),另有 ToDesk 虚拟显示器适配器 |
| 会话 | DSH 与 lc-mcp 服务跑在**会话 2**;**无人在物理机前**,全部远程操作 |
| 接入方式 | RDP / ToDesk,**分辨率随客户端变化**(实测 1600×900 / 1872×921 / 1920×1080) |
| 游戏 | Limbus Company,Steam 版,装在 `D:\SteamLibrary`(**非**默认 C 盘路径) |
| Python | 系统只有 3.8.6,AALC 要求 ≥3.12 → 由 uv 装 CPython 3.13.6 |
| 网络 | 直连外网约 12–28 KB/s;Clash 代理 `127.0.0.1:6789` 约 4.18 MB/s(快 11 倍) |
**账号状态**:LV 37 的早期账号,**首次进入镜牢**,因此触发了大量一次性新手引导。
## 结果
```text
一局完整镜牢:2026-10-04 23:49:42 → 2026-10-05 00:29:10
耗时 00:39:28,exit code 0,日志零 [ERROR]
[INFO] 已完成 1 次镜牢
```
单测:`Ran 171 tests ... OK`(见 `test-results.txt`)。
里程碑全文见 `logs/successful-run-milestones.txt`(98 行)。
## 六个失败与根因
### 1. 截图全黑 —— 会话 `Disc` 导致桌面停止渲染 ★
**症状**:`get_state` 返回全黑图、OCR 为空;AALC 报
```text
OpenCV(4.11.0) templmatch.cpp:1175: error: (-215:Assertion failed)
_img.size().height <= _templ.size().height && _img.size().width <= _templ.size().width
```
即**截图比模板图还小**。
**根因**:DSH 与服务跑在会话 2。RDP 一旦断开,Windows 会**拆掉该会话的显示表面**。
进程还活着、日志还在滚,但:
```text
BitBlt(screenDC) → ret=0 err=6 (ERROR_INVALID_HANDLE)
OpenInputDesktop → 0 (失败)
GetForegroundWindow→ 0
qwinsta → > YWS-HHH 2 Disc
```
**这不是权限问题,是根本没有显示设备。** 一开始误判成权限/沙箱问题,绕了弯路。
**修复**:把会话挂到物理控制台,之后无人连接也持续渲染。
```powershell
tscon 2 /dest:console # 需要管理员
```
`tscon` 需要 `SeTcbPrivilege`;普通令牌只有 `SeShutdownPrivilege`,直接跑报
`Error 5: Access is denied`。
**⚠️ 会反复**:之后再 RDP 连上又断开,会话被拉回 RDP,断开后又变黑。
因此新增了看门狗任务(见下),已实测能自愈。
### 2. `sinner_order` 全 0 —— 编队死循环 ★最隐蔽
**症状**:日志里每 2 秒一次 `开始执行 罪人编队` → `结束执行 罪人编队`,永远不出结果;
游戏停在配队界面。
**根因**:`tasks/teams/team_formation.py`
```python
for i in range(1, 13):
if i in sinner_team:
sinner = sinner_team.index(i)
else:
return # 任何一个缺失就立刻返回, 什么都不做
```
而自动生成的 `config.yaml` 里 `chosen_sinners` / `sinner_order` **默认全是 0**
(`module/config/config_typing.py` 里 `[0] * 12`)。于是第一个 `i=1` 就命中 `return`,
队伍永远是空的;`mirror.py` 又检测到 `teams/none_sinner_assets.png`("没有罪人")
再次调用编队,形成无限循环。
**为什么难发现**:配置文件是自动生成的、字段名看起来正常;**AALC 不报任何错**。
**修复**(`vendor\aalc\config.yaml` → `teams: '1':`):
```yaml
sinners_be_select: 12
chosen_sinners: [1,1,1,1,1,1,1,1,1,1,1,1]
sinner_order: [1,2,3,4,5,6,7,8,9,10,11,12]
```
队伍启用队列是单一事实源,`teams_be_select` 由它派生:
```yaml
teams_active_queue: [1]
select_team_by_order: true
```
`select_team_by_order: true` 让选队按列表位置点选,而不是匹配队名
(默认按名字找 `编队#N` / `TEAMS #N`,队名不符就失败)。
### 3. `background_click: false` 会因 `SetForegroundWindow` 崩掉整个任务
`module/game_and_screen/screen.py` 的 `set_win()`:
```python
if not cfg.background_click:
self.handle.setForeground() # 后台进程抢前台会抛 pywintypes.error
```
会话状态不健康时这里抛异常 → `init_game()` 崩 → 任务秒退:
```text
pywintypes.error: (0, 'SetForegroundWindow', 'No error message is available')
```
`background_click` 同时决定截图方式,两者耦合:
| `background_click` | 截图 | 特点 |
|---|---|---|
| `true` | `PrintWindow(hwnd, dc, 3)` | **按窗口抓图**,不受屏幕尺寸/遮挡影响 |
| `false` | `take_screenshot_gdi` | 全屏 BitBlt 再裁窗口,**窗口超出屏幕就被裁掉** |
### 4. 窗口尺寸必须留出标题栏 —— `set_win_size: 900` 在 1600×900 桌面上无法达成 ★
`set_win_size` 指的是**客户区高度**,但窗口还要加上标题栏和边框:
```text
set_win_size: 900 → 客户区 1600×900 → 窗口需要 1616×939
```
在 1600×900 的桌面上,939 > 900,**窗口装不下**,Windows 会把高度压到 877:
```text
game client: 1600x877 ratio=1.824 *** 不是 16:9 ***
```
而 `set_win()` 的校正循环只在任务启动那一刻跑一次,之后没人纠正。
**修复**:改用 `set_win_size: 720`(客户区 1280×720,窗口 1296×759),
在 1600×900 及以上的桌面上都装得下。
实测确认:
```text
window=(0,0,1296,759) client=1280x720 ratio=1.778 OK 16:9
battle/win_rate_card.png → found (1129, 564) ← 720 缩放下模板匹配正常
```
### 5. 窗口被拉伸成非 16:9 → 模板匹配全面崩坏 ★最值得记
**症状**:镜牢跑到一半突然不再推进。日志没有 `[ERROR]`,进程健在,只是永远停在
`mirror.py` 的"防卡死"兜底分支反复 `点击(1,1)空白位置`。
画面是个正常的**战斗部署界面**,右下角 `START` 按钮高亮等着被点。
**根因**:中途 RDP 重连,桌面分辨率变化,**Unity 把游戏窗口自动拉伸填满桌面**,
客户区变成非 16:9(实测 1872×898,比例 2.08:1)。
而 AALC 按 `cfg.set_win_size` **等比**缩放模板,假设客户区是 16:9:
```text
模板缩放 = set_win_size / 1440 → 假设宽 = 高 × 16/9
实际宽 ≠ 高 × 16/9 → 横向差 17%
```
于是**全部模板匹配分数崩塌**(对比同一批模板):
| 模板 | 正常时 | 出问题时 |
|---|---|---|
| `battle/win_rate_card.png` | ~0.9 | **0.68** |
| `battle/turn_assets.png` | ~0.9 | **0.37** |
| `teams/identify_assets.png` | 0.99 | **0.43** |
| `home/first_prompt_assets.png` | 1.00 | **0.56** |
全都在阈值(0.8)以下 → AALC 认不出任何界面元素 → 走兜底分支 → 看起来"卡死"。
**为什么难发现**:日志里**没有任何报错**,只有一堆相似度数字。
不看分数分布,根本看不出这是"全面的、而非局部的"匹配失败。
**修复**:把窗口恢复成 16:9。修复后同一批模板立刻恢复:
`battle/win_rate_card.png` → found (1121, 564);被卡住的那场战斗 78 秒内打完。
**未解决**:运行中若再次发生分辨率变化仍会重现,目前靠人工/重启任务纠正。
根本解法是让 `set_win()` 的校正循环周期性重跑,或监听 `WM_DISPLAYCHANGE`。
### 6. UTF-8 无 BOM 的中文注释会让 Windows PowerShell 5.1 解析失败 ★
**症状**:脚本报出莫名其妙的语法错误,且**行号对不上**:
```text
At keep_display.ps1:9 char:22
+ [switch]$Verbose,
+ ~
Missing expression after ','.
```
第 9 行其实是一句注释,`[switch]$Verbose,` 在第 16 行。
**根因**:文件是 **UTF-8 无 BOM**。Windows PowerShell 5.1 在无 BOM 时按**系统 ANSI
代码页**(本机 936/GBK)解码,中文注释变成乱码:
```text
原: # 看门狗: 会话掉回 "Disc" 时重新挂到物理控制台
GBK 解码: # 鐪嬮棬鐙? 浼氳瘽鎺夊洖 "Disc" 鏃堕噸鏂版寕鍒扮墿鐞嗘帶鍒跺
```
乱码字节序列会在解析层面制造出多余的引号/标记,破坏语法。
**行号错位**正是这个问题的特征信号。
**这个坑我先误判了两次**:一次以为是 here-string 的问题(改掉了写法),
一次以为是 `param()` 里夹注释的问题(删掉了注释)。两次都"绕过"了而不是修好。
**修复**:脚本存成 **UTF-8 with BOM**(`EF BB BF`)。
> 注:仓库里原有的 `install_logon_task.ps1` 同样是无 BOM + 中文,却能正常执行。
> 差异未查明,可能与其注释内容/长度有关。**保险做法是一律加 BOM。**
## 三种输入模式都在抢桌面
| 模式 | 挪什么 | 代价 |
|---|---|---|
| `background` | **真实鼠标指针**(`set_mouse_pos` 后 `move_back` 复位) | 用户点不到别的窗口、抢不到前台 |
| `window_move` | **游戏窗口**(挪到指针底下再挪回) | 窗口剧烈闪烁(每次点击一次) |
| `foreground` | 真实指针(pyautogui 真实点击) | **游戏必须保持前台**,一旦失去焦点,真实点击会落到别的窗口上 |
三者**都会**调 `set_active()` 向游戏窗口发 `WM_ACTIVATE / WA_ACTIVE`
(`input_handlers/input.py:507` 与 `:828`)。AALC 的设计前提是"运行时独占桌面",
**没有配置能关掉**。
**实测结论**:
- `foreground` 在**有人守着**时体验最好(真实光标操作、可观看),但**无人值守时不可用**——
没人保证游戏处于前台,任何抢焦点(包括人工点一下别的窗口)都会让点击落到错误窗口。
- `background` **不依赖前台状态**,最适合无人值守。代价是抢占鼠标指针——
没人在场时无所谓。
**本项目最终选择 `background`**(无人值守场景)。
## 其他环境坑
- **游戏路径**:`config.yaml` 默认指向 `C:\Program Files (x86)\Steam\...`,
实际在 `D:\SteamLibrary`,必须改。
- **AALC 会整份回写 `config.yaml`**:手写的注释会被抹掉,改完要复查。
- **`qwinsta` 在计划任务上下文里没有任何输出**(所以初版看门狗任务失败),
要用 WTS API(见 `scripts/session_state.py`)。
- **游戏窗口最小化后 rect 是 `(-32000,-32000,...)`**,先 `ShowWindow(SW_RESTORE)`。
- **`SetForegroundWindow` 可当健康探针**:会话不渲染时失败,渲染正常时成功。
- **首次进镜牢有约 60 页引导**(两个轮播)。AALC 的兜底分支要求
`home/first_prompt_assets.png` 与 `home/back_assets.png` **同时**命中,
但后者只有 0.43(低于阈值),于是退化成反复点空白。需人工点掉:
右边缘 `(1805,540)` 翻页,翻完点左上角 `(130,70)` 退出。一次性成本。
- **`task_status` 返回 `succeeded` 不等于成功**:AALC 单次战斗失败后会继续跑完并 exit 0,
必须同时看 `errors` 字段。
## 新增的可复用工具
### `scripts/session_state.py`
用 WTS API 查询会话连接状态,输出 `Active` / `Disc` 等。
替代在计划任务上下文里失灵的 `qwinsta`。
### `scripts/render_check.py`
从屏幕 DC 做一次 BitBlt,判断桌面是否正在出图。退出码 0/1。
### `scripts/keep_display.ps1`
看门狗:会话掉到 `Disc` 时用提权 `tscon` 重新挂 console,恢复渲染。
**安全设计**:只在状态为 `Disc`(确认无人连接)时动作。用户正通过 RDP/ToDesk
连着(`Active`/`Connected`)时**绝不插手**,否则会把用户挤下线。
**提权方式**:`tscon` 需要 `SeTcbPrivilege`,普通令牌拿不到,脚本用
`Start-Process -Verb RunAs`。在 `ConsentPromptBehaviorAdmin=0`("从不通知")的机器上
提权静默通过、不弹框。
**实测验证**(两条路径都跑过):
```text
正常路径 session 2 is Active; nothing to do ← 正确跳过,不写日志
修复路径 session 2 is Disc -> re-attaching to console
session 2 now: Active ← tscon 真的生效
render check: BitBlt=1 desktop=1920x1080 ← 渲染恢复
```
修复路径用 `-ForceDisc` 开关验证(跳过状态判断直接跑),
因为会话已在 console 时 `tscon` 是幂等的,不会造成影响。
另外单独验证过:**计划任务上下文(Limited 权限)里 `Start-Process -Verb RunAs`
可以静默提权**——这是看门狗能工作的前提。用一个临时任务验证后已清理。
## 当前生效配置
```yaml
game_path: D:\SteamLibrary\steamapps\common\Limbus Company\LimbusCompany.exe
background_click: true
win_input_type: background
set_win_size: 720
set_windows: true
select_team_by_order: true
teams_active_queue: [1]
```
任务次数由 `run_task` 参数临时覆盖,结束后自动写回原值
(原值落盘在 `~/lc_mcp/runs/*.restore.json`,防强杀丢失)。
## 仍未验证 / 已知限制
1. **分辨率中途变化会重现问题 5**,目前无自动纠正机制。
2. **`foreground` 模式在无人值守下不可用**(见上),已改用 `background`。
3. **多局连刷的稳定性未验证**:只完整跑通 1 局;
`count=3` 的批处理两次都在中途被打断(第一次因问题 5,第二次因问题 1)。
4. **未使用 Jev / 决策模型**:全部走 AALC 内置规则流程,`decisionEngine` 未接入。
5. 账号为 LV 37 早期账号,**主线未通关**(镜牢界面可见 `Clear Canto 8` 等解锁条件),
因此结论只覆盖普通镜牢,不覆盖困难镜牢与主线。
6. **看门狗只覆盖"桌面变黑"这一类故障**。识别失败、卡在未知界面等其他问题
仍需人工介入——问题 5 就是例子。
7. `720p` 下模板缩放为 `720/1440 = 0.5`。实测战斗界面匹配正常,
但**未做过全流程的识别成功率对比**,小图标场景可能劣于 1080p。
## 本次导出排除的内容
API key、MCP token(`~/lc_mcp/token`)、私有配置文件、完整会话转录、
以及账号 UID 可见的底部栏截图。