Files
lc-mcp/INSTALL_TEST_REPORT.md
T

5.7 KiB
Raw Blame History

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,并用持久保存的白色地图节点截图替换已轮转的旧测试截图。最终仓库回归:40 项全部通过,无跳过;原机器上的执行器源码保留于反馈目录快照,便于对比。测试输出见 docs/feedback/2026-10-02/test-results.txt。

复测命令:

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