62 lines
5.9 KiB
Markdown
62 lines
5.9 KiB
Markdown
# lc-mcp 安装与修复记录
|
||
|
||
日期:2026-10-02,Windows 当前交互桌面会话。
|
||
|
||
## 安装
|
||
|
||
- 仓库:`D:\codex\lc-mcp`,来源 `https://git.lingll.icu/yws/lc-mcp.git`。
|
||
- 初始主仓库提交:`a4b27f991c3619d2c9cf7f5ec9e80cbefd1d0465`。
|
||
- AALC 固定提交:`7452fad5a45a0fadb59a753fafbf40434d987c19`。
|
||
- GitHub Git 传输失败后,从官方 codeload 下载该固定提交的源码 ZIP,解压至 `vendor\aalc`;未修改 AALC 源码。源码可用,子模块 Git 元数据尚未完整建立。
|
||
- `uv sync --no-dev` 安装 AALC 依赖。C 盘空间不足,因此使用 `D:\codex\.cache\lc-mcp-uv` 缓存。
|
||
- Python:`D:\codex\lc-mcp\vendor\aalc\.venv\Scripts\python.exe`。
|
||
- 登录任务:`LcMCPServer`,普通权限,后台 `pythonw.exe` 服务,监听 `127.0.0.1:8765`。
|
||
- 已向 Codex 注册 stdio MCP `limbus`,由 `lc_mcp\bridge.py` 连接常驻服务。
|
||
- 服务日志:`C:\Users\Dainsleif\lc_mcp\server.log`。认证凭据未写入报告。
|
||
|
||
## 修复
|
||
|
||
1. 新增 `drag` 工具,把长按并移动接口接到 AALC 后台输入,持续时间 0.1–10 秒;发送前检查客户区坐标,完整任务运行时禁止抢占输入。
|
||
2. 修复 `pythonw.exe` 标准输出/错误流为 `None` 导致启动日志异常的问题。
|
||
3. stdio 模式在 AALC 初始化前隔离 stdout,统一 UTF-8,避免启动打印污染 JSON-RPC 和中文编码异常。
|
||
4. 模板缩放根据实际截图尺寸计算,保留非整数比例;失配配置和缓存不再让 1080p 模板用于约 720p 客户区。匹配成功或异常后均恢复原配置,不保存配置、不调整窗口。
|
||
5. 客户端断开产生的 ConnectionResetError / BrokenPipeError 正常结束连接;其他服务错误仍会暴露。
|
||
6. 新增 `scripts\mcp_probe.py`,通过实际 stdio bridge 完成 MCP 握手、工具列表和指定调用。
|
||
7. 后台键盘按下后保持 0.12 秒再松开,并在异常时释放;修复 Unity 未识别立即按下/松开的快捷键问题。
|
||
8. Jev 执行器使用单实例互斥,避免多个终端同时输入;确认弹窗仅提供弹窗按钮,避免 OCR 命中背景“离开”。每店刷新至多 4 次,仅在无出战角色技能替换入口时提供。
|
||
9. 商店 CONNECTING 期间禁用所有输入,避免读取旧库存后重复刷新或误退出;有出战角色技能入口或仍可刷新时不提供“离开”。事件结果页使用可见“继续”按钮;回车一次未生效时改用当前按钮坐标。
|
||
10. 奖励卡与卡包详情的上层弹窗优先识别,排除背景控件;层末饰品与苦难提供独立选择入口,避免误当额外观测而默认拒绝。
|
||
11. 真实离线 bridge 复测发现 stderr 使用 cp936,客户端按 UTF-8 解码时产生线程异常;bridge 现统一 UTF-8 错误输出,回归测试主动设置 cp936 并检查中文诊断及退出码。
|
||
|
||
## 验证
|
||
|
||
- 单元与传输回归测试:23 项通过,涵盖认证、在线/离线 bridge、任务子进程状态、输入互斥、拖动边界与时长、UTF-8、pythonw 日志、缩放异常恢复、后台按键时长及客户端断线。独立 Jev 执行器 17 项场景回归中 16 项通过、1 项因旧截图已轮转删除而跳过;包含方向+回车直接进入、编队界面回车开战、战斗特写空 OCR 继续到奖励后停止、加载旧库存禁用操作、技能存在时禁止退出、嵌套奖励弹窗及事件结果点击继续。
|
||
- 真实后台服务:MCP 握手、工具列表、`task_status`、截图和中文 OCR 正常。
|
||
- 真实输入:战斗设置按钮点击成功,Esc 关闭;地图 `click_image` 打开迷宫进度菜单,`click_text` 打开游戏设置。
|
||
- 真实拖动:第 2 层地图上保持左键并水平移动 100 像素,地图跟随平移;反向拖动恢复视图。仅返回 ok 不作为生效证据,已查看前后截图。
|
||
- 后台输入检查:一组往返拖动前后 Windows 前台窗口句柄与系统鼠标坐标完全一致,测试未抢走焦点或移动系统鼠标。
|
||
- 模板识别:当前 1920×1080 地图设置按钮定位 `(1848, 68)` 并成功点击。
|
||
- 已保存的真实 1278×731 战斗截图使用实际 AALC 匹配器复测:设置 `(1233, 41)`,胜率 `(1077, 557)`;阈值 0.9 均命中,配置恢复确认通过。缩放比例为 718.875/1440,取整为 719 曾降低匹配置信度,已修正。
|
||
|
||
## 范围与后续
|
||
|
||
- 第五层卡包长按下拉于 2026-10-02 13:33:54 执行,后续截图于 13:33:57 已进入地图;拖动起点 (326,486)、终点 (326,983)、持续 1.8 秒,未要求用户手动拖动。
|
||
- 未启动完整 AALC 镜牢任务;其默认配置尚未设置用户的指定编队与速通路线。
|
||
- 修复源于本地工作区;本次按用户授权提交并推送远端,不修改 AALC 子模块指针。
|
||
- 用户已授权上传;修复、执行器、skill 快照、脱敏日志及现存游戏截图一起提交。最终推送结果以远端提交核对为准。
|
||
- 用户重启 Codex 后,原生 `limbus` 工具与独立 bridge 均已实测恢复。服务重启仍可能关闭旧连接,因此不为了执行器改动重启服务。
|
||
|
||
仓库内版本将 Jev 执行器改为相对路径和环境变量凭据,接入现有 `mcp_session.Session`,并用持久保存的白色地图节点截图替换已轮转的旧测试截图。最终仓库回归:41 项全部通过,无跳过;原机器上的执行器源码保留于反馈目录快照,便于对比。测试输出见 `docs/feedback/2026-10-02/test-results.txt`。
|
||
|
||
领取流程补充:助手点击领取后,用户完成回车确认,随后已观察到主界面。代码加入点击领取后按 Enter 的完整动作,新增回归检查;本局不记作完全自动通关。
|
||
|
||
复测命令:
|
||
|
||
```powershell
|
||
cd D:\codex\lc-mcp
|
||
$env:PYTHONUTF8='1'
|
||
& vendor\aalc\.venv\Scripts\python.exe -m unittest discover -s tests -v
|
||
& vendor\aalc\.venv\Scripts\python.exe -X utf8 scripts\mcp_probe.py task_status
|
||
& vendor\aalc\.venv\Scripts\python.exe -X utf8 scripts\mcp_probe.py get_state
|
||
```
|