Files
lc-mcp/docs/feedback/2026-10-04
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
..

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 的早期账号,首次进入镜牢,因此触发了大量一次性新手引导。

结果

一局完整镜牢: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 报

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 会拆掉该会话的显示表面。 进程还活着、日志还在滚,但:

BitBlt(screenDC)   → ret=0  err=6 (ERROR_INVALID_HANDLE)
OpenInputDesktop   → 0 (失败)
GetForegroundWindow→ 0
qwinsta            → >  YWS-HHH  2  Disc

这不是权限问题,是根本没有显示设备。 一开始误判成权限/沙箱问题,绕了弯路。

修复:把会话挂到物理控制台,之后无人连接也持续渲染。

tscon 2 /dest:console    # 需要管理员

tscon 需要 SeTcbPrivilege;普通令牌只有 SeShutdownPrivilege,直接跑报 Error 5: Access is denied。

⚠️ 会反复:之后再 RDP 连上又断开,会话被拉回 RDP,断开后又变黑。 因此新增了看门狗任务(见下),已实测能自愈。

2. sinner_order 全 0 —— 编队死循环 ★最隐蔽

症状:日志里每 2 秒一次 开始执行 罪人编队 → 结束执行 罪人编队,永远不出结果; 游戏停在配队界面。

根因:tasks/teams/team_formation.py

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':):

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 由它派生:

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():

if not cfg.background_click:
    self.handle.setForeground()    # 后台进程抢前台会抛 pywintypes.error

会话状态不健康时这里抛异常 → init_game() 崩 → 任务秒退:

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 指的是客户区高度,但窗口还要加上标题栏和边框:

set_win_size: 900 → 客户区 1600×900 → 窗口需要 1616×939

在 1600×900 的桌面上,939 > 900,窗口装不下,Windows 会把高度压到 877:

game client: 1600x877  ratio=1.824   *** 不是 16:9 ***

而 set_win() 的校正循环只在任务启动那一刻跑一次,之后没人纠正。

修复:改用 set_win_size: 720(客户区 1280×720,窗口 1296×759), 在 1600×900 及以上的桌面上都装得下。

实测确认:

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:

模板缩放 = 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 解析失败 ★

症状:脚本报出莫名其妙的语法错误,且行号对不上:

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)解码,中文注释变成乱码:

原: # 看门狗: 会话掉回 "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("从不通知")的机器上 提权静默通过、不弹框。

实测验证(两条路径都跑过):

正常路径  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 可以静默提权——这是看门狗能工作的前提。用一个临时任务验证后已清理。

当前生效配置

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 可见的底部栏截图。