Files
lc-mcp/INSTALL_TEST_REPORT.md
ywsandClaude Opus 5.5 5ab5fd9508 文档路径改为仓库相对路径, 去掉个人用户目录
笔记/skill/Jev 说明里指向 C:/Users/<用户名>/.codex 和 D:/codex/limbus_tools
的链接改为仓库内路径; docs/feedback 下的实测记录登记了哈希, 保持原样。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 00:02:37 +00:00

62 lines
5.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 连接常驻服务。
- 服务日志:`%USERPROFILE%\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 <仓库目录>
$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
```