This website requires JavaScript.
0
Issues
Pull Requests
Milestones
Explore
0
Create…
New Repository
New Migration
New Organization
public
Signed in as
public
Profile
Starred
Subscriptions
Settings
Help
Sign Out
yws
/
lc-mcp
Watch
1
Star
0
Fork
0
Code
Issues
Pull Requests
Actions
Packages
Projects
Releases
Wiki
Activity
Files
lc-mcp
/
docs
/
feedback
/
2026-10-04
/
or
Cancel
Edit File
Preview
Preview Changes
Spaces
Tabs
2
4
8
Wrap
No wrap
# 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 可见的底部栏截图。
Commit Changes
Add a Signed-off-by trailer by the committer at the end of the commit log message.
Commit directly to the
main
branch.
Create a
new branch
for this commit and start a pull request.
Commit Changes
Cancel