在一台无人在场的远程 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 渲染自检)。
14 KiB
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,防强杀丢失)。
仍未验证 / 已知限制
- 分辨率中途变化会重现问题 5,目前无自动纠正机制。
foreground模式在无人值守下不可用(见上),已改用background。- 多局连刷的稳定性未验证:只完整跑通 1 局;
count=3的批处理两次都在中途被打断(第一次因问题 5,第二次因问题 1)。 - 未使用 Jev / 决策模型:全部走 AALC 内置规则流程,
decisionEngine未接入。 - 账号为 LV 37 早期账号,主线未通关(镜牢界面可见
Clear Canto 8等解锁条件), 因此结论只覆盖普通镜牢,不覆盖困难镜牢与主线。 - 看门狗只覆盖"桌面变黑"这一类故障。识别失败、卡在未知界面等其他问题 仍需人工介入——问题 5 就是例子。
720p下模板缩放为720/1440 = 0.5。实测战斗界面匹配正常, 但未做过全流程的识别成功率对比,小图标场景可能劣于 1080p。
本次导出排除的内容
API key、MCP token(~/lc_mcp/token)、私有配置文件、完整会话转录、
以及账号 UID 可见的底部栏截图。