Files
lc-mcp/docs/BACKLOG.md
T
ywsandClaude Opus 5.5 51525722cd P2-8 镜牢局内决策写入审计日志
- 新增 lc_mcp/decisions.py:每个决策追加一行 JSON(time/stage/choice/reason + 细节),
  写失败只丢该行;summarize 按 stage/reason 计数
- TaskRunner 用 LCP_DECISIONS 把 task_*.decisions.jsonl 路径交给子进程,
  task_status 返回 decisions.counts,清理旧日志时一并删除
- 选队/键盘寻路/饰品/事件补丁记录各自决策;商店购买与卡包选择用只观察的补丁记录
  (购买按钮点中前的商品;卡包取自上游日志里的选择结果与权重)
- 抽出 _override 统一临时替换 auto 方法并在结束时还原

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-14 07:11:30 +00:00

17 KiB
Raw Blame History

待开发计划(BACKLOG)

按「收益 / 风险」排序。每条都带证据和验收标准,云端改完直接照着验。 最近一次实测记录见 feedback/2026-11-14/README.md, 接口与队名表见 feedback/2026-11-14/HANDOVER.md。

图例:P0 = 现在是坏的/每天都在浪费;P1 = 明显影响质量;P2 = 打磨。


P0-1 商店「必买 / 必卖 / 公式合成」清单恒为空

现状:tasks/mirror/__init__.py 用旧路径加载模板:

must_purchase_path = "./assets/images/share/mirror/shop/must_purchase"

实际图片在 ./assets/images/default/share/mirror/shop/must_purchase/(5 张:carmilla、homeward、 lithograph、phlebotomy_pack、piece_of_relationship),assets/images/share 根本不存在。 运行时实测:

must_purchase 0
must_be_abandoned 0
fusion_result 0

后果:in_shop.py:157 的购买循环、:564 的废弃识别、公式合成全部空转。2026-11-14 进店 51 秒、 打印了三次「开始购买必买项」却没买一件。

目标:三个清单按当前 path_manager 的图片根(default/share、dark/share…)加载,且支持中英文资源目录。

验收:

  • python -c "import tasks.mirror as m; print(len(m.must_purchase), len(m.must_be_abandoned), len(m.fusion_result))" → 5 19 31
  • 单测覆盖:清单非空、路径含 default/share、dark 主题下也能解析
  • 实机进店日志能看到真正的购买动作(购买 后出现 ego_gift_get_confirm),且余额变化

涉及:tasks/mirror/__init__.py(vendor!)→ 若要遵守「不改 vendor」,就在 lc_mcp/aalc_patches.py 里于 import 后重建这三个列表,并加一条注释说明上游路径缺陷。

风险:低。纯路径/清单;不改判定逻辑。

状态(2026-11-14 云端):已实现,待实机验收。

  • 根因:上游 ebb6629(调整图片路径)把图片挪到 assets/images/<主题>/<语言>/,tasks/mirror/__init__.py 没跟着改。 按名字找图那一层(path_manager 依次搜各主题/语言目录)没坏,只是列目录列空了。
  • 修法:install_shop_lists() 在 mirror / all 任务里按 AALC 的六个图片根(dark|default × zh_cn|en|share) 合并去重,原地 extend 这三个列表——in_shop.py 用 from tasks.mirror import ... 在导入时绑定了列表对象, 重新赋值对它无效。上游清单已非空时不动。
  • 补丁只在任务进程里生效,上面那条 python -c 仍会打印 0 0 0。离线等价验证是 tests/test_shop_lists.py (执行上游真实 __init__.py 得到 0 0 0,补丁后为 5 19 31)。实机看任务日志里这一行: [lc_mcp] patch: 镜牢商店清单按 assets/images/<主题>/<语言> 补齐: must_purchase=5, must_be_abandoned=19, fusion_result=31

P0-2 镜牢走位被配置降级成「只按 ↑」

现状:config.yaml 里 mirror_keyboard_navigation: true + mirror_keyboard_simple_pathfinding: true, mirror.py:1128 因此走 search_road_simple_keyboard():每层按两次 ↑ 进最上面的节点,不看节点类型。 Dijkstra 那套(search_road.py:735,代价 event 1 / shop 2 / battle 4 / boss·focused 6 / risky 7)完全没跑。

目标(二选一,云端定):

  • A:默认改用 Dijkstra,只在检测到「鼠标拖地图卡死」时降级为简单键盘;
  • B:保留简单键盘,但把「↑ 的第一个节点」换成「按节点类型挑可达节点」。

验收:

  • 一局里至少 3 层,日志能打印每层选中的节点类型与理由
  • 事件/商店节点占比 ≥ 现状(对比 11-14 这局:3 层只进过 1 次商店)
  • 不出现寻路卡死(连续 60 s 无 enter_assets 即算失败,应回退简单键盘)

涉及:tasks/mirror/search_road.py、tasks/mirror/mirror.py:1128、config.yaml 默认值(assets/config/config.example.yaml)

风险:中。simple_pathfinding 当初是为了规避鼠标拖拽卡死加的,去掉要有回退开关。

状态(2026-11-14 云端):选 B,已实现,待实机验收。

  • 不选 A 的原因:常规寻路(search_road_from_road_map)先用 mouse_drag 把巴士拖到固定位置,第二段拖动只受 超时限制、超时还会 back_init_menu();连线识别 identify_road 依赖 my_crop,HANDOVER 已证实它在本机坐标不对。
  • 做法:install_typed_keyboard_road() 替换 search_road_simple_keyboard(search_road 和 mirror 两个命名空间)。 仍只按键、不拖地图:找到巴士 → 用 AALC 自带 ONNX 模型整屏识别(不裁剪)→ 取巴士右侧一列、按相对行映射成 U/M/D → 按上游 all_node_weight(event 1 < shop 2 < battle 4 < boss/focused 6 < risky 7)依次按 up/right/down, 每按一次都用原来的 _keyboard_enter_succeeded() 确认;都进不去就调用原函数按 ↑。最多 3 次按键,不会循环。
  • 只看下一列,是一步贪心,不是整层最优路线。
  • 回滚:任务环境变量 LCP_TYPED_ROAD=0 不装补丁;或在 AALC 里关掉简单键盘寻路,回到上游常规寻路。
  • 待实机确认的假设:方向上没有连线时按该方向键不会进入别的节点(应当没有"进入"按钮,补丁随即换下一个方向)。 回归时对照日志 [lc_mcp] 键盘寻路: 进入 X 方向的 <类型> 与实际进入的节点类型;若对不上,说明按键语义与假设不符。
  • 日志:每一步打印 下一列 U=event(1) D=shop(2) M=battle(4) 与最终进入的方向、类型和理由。

P1-3 饰品三选一加「体系优先」

现状:mirror.py:1360 acquire_ego_gift() 只看两件事——是不是白棉花、是不是「已持有」, 然后拿第一张。完全不看 team_system。

目标:可配置的关键词优先表(例如流血队:流血 / 出血 / 血迹),命中则加权;仍旧排除已持有与白棉花。

验收:

  • 单测:给定候选文本列表 + 体系,选出预期那一张(含「全部已持有」「全是白棉花」边界)
  • 实机:流血队一局里,三选一命中体系关键词的比例 > 0(日志统计)
  • 关闭该配置时行为与现在完全一致(可回滚)

涉及:tasks/mirror/mirror.py、lc_mcp/aalc_patches.py(建议做成可配置关键词表,放 config.yaml 或独立 yaml)

风险:中。OCR 有误读(震颐/沉论/编#16),关键词要容忍错字。

状态(2026-11-14 云端):已实现,待实机验收。

  • 核对上游时发现「完全不看体系」只对一张、两张卡成立:三张卡时 acquire_ego_gift 会用 acquire_ego_gift/<体系>.png 图标模板(阈值 0.85)把命中的卡排前面,只是没有日志能证明它在本机生效。
  • 做法:install_gift_preference() 包住 Mirror.acquire_ego_gift(只管 type=1 的选卡界面,type=2 拒绝饰品原样放行)。 调用期间临时替换 auto.find_element:上游取到卡片列表(acquire_ego_gift_card.png,多目标)时, 整屏 OCR 一次,按坐标把每行文字归到卡上(范围与上游判断白棉花/已持有的一致),命中体系关键词行数多的排前面。 排序稳定,之后上游原逻辑照旧:白棉花跳过、已持有排后、体系图标命中的仍插到最前。调用结束还原 find_element。
  • OCR 直接读引擎的逐行结果,不用 _run_ocr_for_text 的 {文本: 坐标}(两张卡上同一句会被合并成一条)。不用 my_crop。
  • 关键词表 lc_mcp/data/gift_keywords.json(JSON,不加依赖);匹配前做与选队相同的归一(空白/全半角/震颐 等误读), 英文不分大小写。表读不了记 [ERROR] 并不装补丁。
  • 回滚:LCP_GIFT_KEYWORDS=0 不装补丁,行为与上游完全一致;LCP_GIFT_KEYWORDS=<路径> 换表。
  • 只按主体系;第二体系仍只由上游的图标匹配处理。
  • 单测执行上游真实的 acquire_ego_gift(tests/test_gift_preference.py),覆盖两张/三张卡、选一/选二、 已持有、白棉花、全是白棉花、误读、无命中。
  • 实机验收:日志 [lc_mcp] 饰品选择(体系 bleed): 第1张=0 第2张=1(流血) 第3张=0; 命中体系关键词, 先看第2张; 统计「命中体系关键词」与「未命中体系关键词」的行数即得命中比例。

P1-4 事件选项策略可配

现状:mirror.py:1230 event_handling() 固定策略——能点「判定 / check」就点,然后永远点第一个选项, 最后找 continue/继续。跟体系、跟当前血量都无关。

目标:支持一张「事件 → 选项」表(JSON/YAML),未收录的退回「第一个选项」。

验收:

  • 表里命中的事件按配置点;未命中的行为不变
  • 单测:事件文本 → 选项索引映射,含缺省分支
  • 至少录入 5 个高频事件(可从 docs/mirror_dungeon_speedrun_notes.md 的既有结论里抄)

涉及:tasks/mirror/mirror.py、新增数据文件(建议 lc_mcp/data/event_choices.yaml,不要塞进 vendor)

风险:低-中。选项点错可能拿不到奖励,但不会卡死。

状态(2026-11-14 云端):已实现,待实机验收。

  • 做法:install_event_choices() 包住 Mirror.event_handling,调用期间临时替换 auto.click_element。 上游每轮挑选项的第一步是 click_element("event/unknown_event.png"),补丁在这一步之前插一次判断: event/select_first_option_assets.png 多目标匹配到选项框(每项的左边缘)时整屏 OCR,把右侧同一行的文字归到各项; 画面上的文字命中表里某个事件,就点对应选项的左边缘(与上游点第一项的位置一致),并告诉上游"已点"(event_chance -= 1)。 其余情况(不在选项画面、事件没收录、表里的选项不在画面上)照常交给上游。
  • 表 lc_mcp/data/event_choices.json(JSON,不加依赖),10 条,全部取自 docs/skills/limbus-mirror-speedrun/references/event-choices.md 里无判定/无战斗的直出或免费奖励。
    • text(按选项文字)优先:红色坐像「侧耳倾听」、炸鸡对决「鸡肉就是鸡肉」、梦中的电子羊「你不是特别的」、失明巨人「什么都没有写」。
    • index(按第几项)只用于事件的第一屏选项;画面没变时最多重试 3 次,之后的分支交给上游。参考文档提醒过 Wiki 编号可能与当前顺序不同,所以编号规则一律以实机日志核对。
    • 规则按顺序匹配,折射的往昔的睡袋(1)排在 往昔的睡袋(2)前面。
  • 日志:每屏选项只打一次,[lc_mcp] 事件 <名>: 1=… | 2=…; 选第 N 项(理由);没收录时 事件选项: 1=… | 2=…; 表里没有这个事件, 交给 AALC,可直接拿来补表。
  • 回滚:LCP_EVENT_CHOICES=0;表读不了记 [ERROR] 并不装补丁。
  • 单测执行上游真实的 event_handling(tests/test_event_choices.py),覆盖按文字、按编号、编号超出、规则顺序、 第二屏交回上游、点击没生效时重试、未收录与上游一致。
  • 待实机确认:事件名是否出现在选项画面上(不出现则规则永远不命中,只会退回上游,不会点错); 选项文字与左边缘同一行的假设(EVENT_OPTION_ROW)。

P1-5 选队补丁的鲁棒性

现状:_select_team_by_name() 精确匹配 + 4 轮翻页。已知薄弱点:

  • OCR 误读(实测把「震颤」读成「震颐」、「沉沦」读成「沉论」、「编队#16」读成「编#16」)
  • 队名带后缀(「流血队」「流血(X)」)会失配
  • 只按「顶栏名字」确认,若顶栏字号变化会误判

目标:别名表 + 归一化(去空格/全半角/常见误读)+ 失败时输出候选列表便于排查。

验收:

  • 把队名临时改成「流血队」也能选中(别名/前缀匹配,仍需唯一)
  • 误读样本(震颐→震颤、沉论→沉沦)能正确归一
  • 失败日志里打印「这一屏看到了哪些名字」,而不是只说没找到

涉及:lc_mcp/aalc_patches.py、tests/test_system_team_selection.py

风险:低。只是匹配变宽,需保证「唯一命中」才点,避免选错队。

状态(2026-11-14 云端):已实现,待实机验收。

  • 归一化 normalize_team_name():去所有空白,NFKC 全角转半角(#→#、()→()),再按 TEAM_OCR_FIXES 改回实测误读(震颐→震颤、沉论→沉沦、编#→编队#)。新误读往这张表里加。
  • 列表挑选 pick_team_item():先找精确匹配(多个名字时按 SYSTEM_TEAM_NAMES 里的顺序);没有再看前缀匹配 (名字至少两个字,后面带任意后缀),这一屏只有一条才点,两条以上记日志不点、继续翻页。
  • 顶栏确认只认归一后的精确匹配:「已经是这支队」的判断和点完后的确认都一样。顶栏是 流血队 时会回列表里确认唯一再点一次, 避免把 流血2 当成 流血。
  • 日志:每屏没命中时打印 第 N 屏没有 流血; 这一屏的名字: 剧情关卡/斩击/...;点了但顶栏没变时打印顶栏读到了什么。
  • 限制:唯一性只按当前这一屏判断;相似队名分在两屏时(例如 流血队 在第 2 屏、流血2 在第 3 屏)会点先出现的那条。 顶栏位置仍是写死的 TEAM_HEADER,字号/布局变了要按日志里「顶栏读到」调整。
  • 实机验收:把「流血」改名成「流血队」跑一局,日志应出现 编队列表里找到 流血队 @(...), 前缀匹配 流血 和 已按体系名选中编队 流血队。

P2-6 商店必买清单本地化

现状:必买靠 5 张英文/图标模板;汉化后商店里的名称是中文,模板匹配靠图标尚可,但新增饰品无法覆盖。

目标:支持「饰品中文名 → 优先级」的配置表,OCR 命中即买;模板作为兜底。

验收:单测 + 实机一局至少一次由名字命中的购买。

涉及:lc_mcp/aalc_patches.py(包一层购买判定)、新增数据文件。


P2-7 观测饰品按体系自动勾选

现状:observe_ego_gift_selected 要人在 AALC 界面一个个勾;没勾就等于关闭观测。

目标:按 team_system 自动勾一组默认饰品(可覆盖),并在开跑前写回配置。

验收:config.yaml 里 observe_ego_gift_selected 与体系匹配;日志打印勾了哪些。

涉及:lc_mcp/aalc_task.py(apply_overrides 类似机制)、app/observe_ego_gift_selection.py 的序列化格式(只读参考)。


P2-8 决策审计日志

现状:选队/卡包/饰品/商店的决策只散落在 DEBUG 日志里,事后要人肉 grep。

目标:每局写一份 ~/lc_mcp/runs/<task>.decisions.jsonl:时间、阶段、画面摘要、候选、选中项、理由。

验收:一局结束后能直接统计「卡包选择理由 ×N」「三选一命中体系 ×N」「商店购买 ×N」。

涉及:lc_mcp/aalc_patches.py、lc_mcp/tasks.py(结果归档)。

状态(2026-11-14 云端):已实现,待实机验收。

  • 文件与任务日志同名:~/lc_mcp/runs/task_<时间>_<任务>.decisions.jsonl。TaskRunner 通过 LCP_DECISIONS 把路径传给子进程, 清理旧日志时一起删;直接 python -m lc_mcp.aalc_task 运行时不写。写失败只丢那一行。
  • 每行 time/stage/choice/reason + 细节(候选、命中、选项文字…);reason 是用来计数的短类别,表见 README。 task_status 返回 decisions: {path, counts: {stage: {reason: 次数}}}。
  • 来源:选队(P1-5)、键盘寻路(P0-2)、饰品(P1-3)、事件(P1-4)直接在补丁里记; 商店与卡包是只观察的补丁:Shop.buy_gifts 期间看 purchase_assets 是否点中、之前点的是哪件商品; select_theme_pack 期间临时挂一个 logging handler,从上游自己的 此次选择卡包关键词:X 日志取结果和权重列表。
  • 「画面摘要」只记了各决策用到的文字(选项、队名、命中关键词),没存截图。
  • 验收对应:卡包理由 = counts.theme_pack,三选一命中体系 = counts.gift.keyword,商店购买 = counts.shop.purchase_clicked。

已知但暂不做的

项 原因
让 AALC 原生支持自定义队名 要改 vendor/aalc,submodule 升级会丢;补丁层已够用
自动识别「哪支队是流血队」 图像/文本都不可靠,靠命名约定(见 HANDOVER 第 4 节)更稳
改 mirror_dungeon_speedrun_notes.md 的路线结论 那是人工速通笔记,和 AALC 的自动寻路是两套,别混