Files
lc-mcp/docs/feedback/2026-10-02/README.md
T

55 lines
6.2 KiB
Markdown

# 2026-10-02 镜牢 MCP 修复与真实反馈
此记录来自用户授权的 Windows 后台游戏实测。数据导出时间以 `manifest.json` 为准;本次导出时镜牢仍在第五层推进,未确认最终通关。操作日志保留失败、重复输入和错误选择,不以工具返回 `ok` 代替游戏实际生效。
后续补充:13:59:23 已观察到第五层“探索完成”,截图见 `final_completion.png`。助手点击“领取”后,由用户按回车确认;14:00:08 已观察到主界面。此局已完成并领取奖励,但含人工纠正,不能记为全自动速通。见 `final_result.json`。下一次固定领取流程已加入“点击领取 → 回车确认”的执行动作与回归检查。
## 修复文件
- `lc_mcp/aalc_engine.py`:后台按键保持 0.12 秒后释放;长按拖动与客户区边界检查;按实际截图比例缩放模板,并在异常后恢复原配置与缓存。
- `lc_mcp/engine.py`、`fake_engine.py`、`protocol.py`:拖动接口、参数校验、完整任务期间输入互斥。
- `lc_mcp/server.py`:pythonw 日志流、导入前隔离 stdio 输出、UTF-8、客户端断线处理。
- `lc_mcp/bridge.py`:中文离线错误输出统一 UTF-8。
- `scripts/mcp_probe.py`、`mcp_session.py`、`battle_batch.py`:实际 bridge 握手、复用调用、有界战斗批次。
- `scripts/jev_mirror_agent.py`、`jev_decision_client.mjs`:受限候选动作、Jev 分支决策、固定快捷流程和场景故障修正。
- `tests/`:真实场景与传输回归;最终 41 项全部通过,详见 `test-results.txt`。
## 实际问题与反馈
| 观察 | 原因与处理 | 验证状态 |
| --- | --- | --- |
| 自动拖动曾无法选卡包;用户指出需要长按 | 新增保持左键并缓慢移动的 MCP 接口,时长 0.1–10 秒;卡包使用 1.8 秒 | 地图往返拖动生效;13:33:54 下拉卡包,13:33:57 已进入第五层地图。对应过程在 Jev 日志中 |
| 后台快捷键有时不生效 | 原按下/松开可能落在同一 Unity 帧;改为保持 0.12 秒并确保释放 | 后台按键、异常释放回归通过;实际战斗批次有持续结算记录 |
| 模板在 1278×731 客户区失配 | 旧窗口配置与截图不一致;按 718.875/1440 比例匹配,保留小数 | 设置及胜率模板实际匹配成功,原配置恢复测试通过 |
| 商店刷新时已出现角色技能,却再次刷新或退出 | CONNECTING 时旧库存仍在屏幕上;执行器未阻断输入 | 新增加载期间只等待,以及有出战技能/可刷新时排除离开;场景回归通过。后续完整商店流程尚需持续实测 |
| 辛克莱替换曾选错楼层规则 | 候选入口没有按楼层限制;确认窗口回车也有未生效情况 | 1–2F 限定 1→2,3–5F 限定 1→3;奥提斯 2→3;只在目标选中后提供确认,购买用按钮。测试通过,3F 辛克莱 1→3 购买已核对 |
| 已购买技能又被识别成可买 | OCR 仍识别底部替换标题 | 同卡“已购买”标识排除;场景回归通过 |
| 白色地图节点未提供路线 | 依赖 OCR 楼层标题与红/绿节点;标题漏识别后只有等待候选 | 新增白色高亮节点及图标匹配;取消对楼层标题 OCR 的强依赖,真实截图回归通过 |
| 奖励弹窗遮挡后仍点背景卡 | 奖励处理早于嵌套弹窗,背景确认也被 OCR 识别 | 上层弹窗优先,仅提供较上方确认;测试通过 |
| 层末奖励误点“拒绝饰品”,未手动选择苦难 | 未为四卡饰品/苦难画面提供独立入口,混用额外观测按钮 | 已加入层末候选,禁止默认拒绝;发生的错误选择无法追溯撤销。修正后的完整层末选择尚未实测 |
| 事件反复滚动或回车后停在结果页 | 未给模型关联选项结果;结果页遮蔽“继续”,动态录像时间破坏重复识别 | 已关联结果文字,有直接领取选项时不提供滚动;结果页优先点击可见继续。测试通过,事件结束并进入后续节点已观察到 |
| 离线连接测试表面通过,但 stderr 解码线程报错 | Windows cp936 错误文本被按 UTF-8 读取 | bridge 统一 UTF-8;设置 cp936 的复测已无异常 |
用户另已指定:开局恩惠 1、3、10 不强化;起始荆棘套索/荧光灯;三级电池;保留出战顺序;关卡选路回车、编队回车、战斗 P+回车;事件先 SKIP;快捷键未生效即点按钮;第五层优先“2号线”,刷新次数为零时允许卡包观测。完整配置见 `source_snapshots/mirror_dungeon_speedrun_notes.md` 和 `skill/`。
## 数据与复现
- `logs/*.jsonl`:旧执行器、MCP 执行器、Jev 执行器及烟雾检查的完整现存记录。
- `logs/server.txt`、`logs/runs/`:常驻服务与完整任务的现存日志;不能将未成功的尝试当作已通关。
- `logs/jev_mirror_status.json`、`jev_shop_context.json`:导出时的状态快照。
- `source_snapshots/`:实际机器上修改后的执行器、测试、客户端和笔记快照。路径已占位处理,供追溯对比;可运行的相对路径版本位于仓库 `scripts/`。
- `skill/`:整理后的镜牢速通 skill 和参考文件。
- `game-captures.zip`:所有现存相关游戏截图和裁剪图;`capture_manifest.json` 记录名称、大小、SHA-256。
- `manifest.json`:导出时间、文件来源占位、原文件与导出文件哈希、记录数、排除范围;`metrics.json` 是该快照的汇总。
本次数据已排除 API 密钥、MCP 认证令牌、本机配置、Codex 聊天/会话转储、无关资源提取文件和虚拟环境。MCP 仅保留最近 30 张截图,早期删除帧无法补回;截图清单不意味着覆盖每次操作。战斗日志按批次记录 P+回车次数,没有每一按键的单独时间戳。失败暂停会写入状态文件,未必追加到动作日志,因此动作日志中的失败计数不是全部失败次数。
复现命令(需已安装 AALC 依赖):
```powershell
vendor\aalc\.venv\Scripts\python.exe -X utf8 -m unittest discover -s tests -v
vendor\aalc\.venv\Scripts\python.exe -X utf8 scripts\mcp_probe.py get_state
```
Jev 执行器另需 `OPENCODE_API_KEY`,使用方法见仓库 README。仅在用户授权的游戏会话中运行输入类工具。