在一台无人在场的远程 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 渲染自检)。
332 lines
14 KiB
Markdown
332 lines
14 KiB
Markdown
# 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 可见的底部栏截图。
|