docs/feedback/2026-11-14/REGRESSION.md: 拉取步骤(含 submodule 升到 2fcb1b4)、 任务开始时应出现的七行补丁日志、跑完一局逐项要看的日志与判断方法、离线确认不了的 假设、各功能的关闭开关和回传内容。交接文档第 5、7 节和 BACKLOG 开头链到它。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
24 KiB
待开发计划(BACKLOG)
按「收益 / 风险」排序。每条都带证据和验收标准,云端改完直接照着验。
最近一次实测记录见 feedback/2026-11-14/README.md,
接口与队名表见 feedback/2026-11-14/HANDOVER.md,
本轮云端交付的实机回归清单见 feedback/2026-11-14/REGRESSION.md。
图例:P0 = 现在是坏的/每天都在浪费;P1 = 明显影响质量;P2 = 打磨。
AALC 上游升级到 V1.6.1(2026-11-14 云端)
vendor/aalc 从 e1d1749(V1.6.1-beta.11)升到 2fcb1b4(V1.6.1,17 个提交)。与本仓库补丁有关的:
| 上游提交 | 改了什么 | 对本仓库的影响 |
|---|---|---|
8196e72 |
商店三个清单改按 assets/images/default/share/... 列目录 |
P0-1 上游已修,本地补丁删掉;tests/test_shop_lists.py 改成守着上游非空(5/19/31) |
18deb77 |
事件里找 "???" 改成 find_element + 自己点;小指良单通模式改点别的选项 |
P1-4 原来挂在 click_element("event/unknown_event.png") 上,升级后会悄悄失效;已改挂 find_element,单通模式也测了 |
3980b58 |
判定成功率徽章识别前先把红色(低/极低)涂黑 | 不涉及补丁;判定选人更准 |
a3b6766 |
饰品奖励"选二"先于"选一"判断 | P1-3 只重排卡片顺序,不受影响(单测执行的就是新版 acquire_ego_gift) |
0f456e3 732002f |
开局饰品按优先级逐个点,模板 0.8→0.7→锚点坐标兜底 | 不涉及补丁 |
fb2ef56 |
check_game_alive 要求进程和窗口(UnityWndClass + game_title_name)都在;进程起来 180 秒还没窗口就杀掉重启 |
实机留意:窗口标题改过或被隐藏时会被当成僵尸进程 |
d4c9004 |
ONNX 寻路模型会话缓存 | P0-2 调的 identify_nodes 变快,接口不变 |
为避免再出现"上游改写法、补丁悄悄失效",事件表、饰品排序、商店按名字三个补丁安装时先查上游源码里还有没有被拦截的那个调用;
没有就记 [ERROR] ... 挂不上 并跳过,task_status 的 errors 里能看到。
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 云端):上游 V1.6.1(8196e72)已修,本地补丁 install_shop_lists() 已删。
tests/test_shop_lists.py 执行上游真实的 tasks/mirror/__init__.py,守着三个清单是 5/19/31 且每张图都找得到。
下面是当初的分析,留作记录。
- 根因:上游
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。 - 三张及以上(2026-11-14 复查修正):上游逐张看卡,认出体系图标的卡
my_list.insert(0, ...),后看的排到最前,其余 append。 最初直接把排好的顺序交给上游,两张命中关键词的卡都带图标时会被它倒过来,反而先拿命中少的那张。现在交给上游的顺序是 「没命中的(原顺序)+ 命中的(倒着)」,上游查体系图标时对命中关键词的卡答"有";拼出来是 命中多的 → 命中少的 → 只认出图标的 → 其余,再按已持有排后。两张卡的分支不看图标,直接按命中多少给。 - OCR 直接读引擎的逐行结果,不用
_run_ocr_for_text的{文本: 坐标}(两张卡上同一句会被合并成一条)。不用my_crop。 - 关键词表
lc_mcp/data/gift_keywords.json(JSON,不加依赖);匹配前做与选队相同的归一(空白/全半角/震颐等误读), 英文不分大小写。表读不了记[ERROR]并不装补丁。 - 回滚:
LCP_GIFT_KEYWORDS=0不装补丁,行为与上游完全一致;LCP_GIFT_KEYWORDS=<路径>换表。 - 关键词按零协汉化核对(
LLC_zh-CN/EgoGiftCategory.json、BattleKeywords.json):烧伤 流血 震颤 破裂 沉沦 呼吸法 充能 斩击 突刺 打击。饰品描述里的[Combustion]等占位符在游戏里就显示成这些名字。原表的出血在汉化里一次都没出现,已删。 - 只按主体系;第二体系仍只由上游的图标匹配处理。
- 单测执行上游真实的
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.find_element和auto.mouse_click。 上游每轮挑选项的第一步是find_element("event/unknown_event.png"),补丁在这一步插一次判断:event/select_first_option_assets.png多目标匹配到选项框(每项的左边缘)时整屏 OCR,把右侧同一行的文字归到各项; 选项对上表里某个事件,就点表里那一项的左边缘,并把这个位置当成 "???" 交还上游(event_chance -= 1, 重新截图)。 上游随后拿这个位置再点一次的那下会被吞掉;小指良单通模式下它会再找一次 "???",这时返回"没有",不会改点别的选项。 其余情况(不在选项画面、没认出事件、要点的那项没读到)照常交给上游。 -
按选项原文认事件,不按事件名:零协汉化的事件数据(
LLC_zh-CN/ActionEvents_*.json)只有叙述和选项,没有标题字段, 画面上也不保证有事件名。每条规则写同一屏其它选项的原文(options,全部出现才算)和要点的那一项(text)。 比较前去空白、全角转半角、去标点。一次事件里按表最多点 5 次,点了没反应就交回上游。 -
表
lc_mcp/data/event_choices.json,6 条,选项原文照抄零协汉化(LocalizeLimbusCompany@231a8bc),带事件 id 便于回查; 选择依据仍是docs/skills/limbus-mirror-speedrun/references/event-choices.md:事件 汉化 id 点哪项 结果(汉化选项说明) 红色坐像 901010 侧耳倾听。 无判定无战斗;2 判定,3 战斗 炸鸡对决 971001 鸡肉就是鸡肉喽。 1 件烧伤 + 1 件破裂饰品 鸡群的激情探戈 971003 视而不见。 1 件泛用饰品 梦中的电子羊 901038 你不是特别的。 1 件泛用饰品 失明巨人递来患者记录 901085 说上面什么都没有写。 判定(忧郁/怠惰);1 也是判定且门槛更高 破碎罗盘(冻僵的尸体指路) 901095 返回。 直接结束(第 4 项) -
核对时删掉的:
往昔的睡袋(2)与折射的往昔的睡袋(1):汉化里只有一个睡袋事件(971058,标题"折射的往昔的睡袋"), 选项是「聆听喘息声」(傲慢/嫉妒判定)和「捂住耳朵」(无说明);参考文档对两个版本的"2"说法相反(回复 / 降 20 理智), 拿不准,交回 AALC 原逻辑(有 "???" 先点 "???",否则点优势判定);实机日志里not_in_table会记下它的选项,再决定要不要补。浸染棉花(3)、终末日历(2):汉化的镜牢事件里找不到对应选项,无法按原文认。- 原来的
index(按第几项)规则全部去掉:有了原文就不需要编号,参考文档也提醒过 Wiki 编号与当前顺序可能不同。
-
原表说明写的"都是无判定/无战斗"不对:失明巨人两项都要判定,已在表里标
check: true。 -
巴士 Wiki(wiki.biligame.com/limbuscompany)的接口查了几次后就返回人机验证页,没法自动核对;事件结果仍以参考文档(灰机 Wiki)为准。
-
日志:每屏选项只打一次,
[lc_mcp] 事件 <名>: 1=… | 2=…; 按表选第 N 项「…」;没收录时事件选项: 1=… | 2=…; 表里没有这个事件, 交给 AALC,可直接拿来补表(写零协汉化的原文)。 -
回滚:
LCP_EVENT_CHOICES=0;表读不了、或上游不再调用find_element("event/unknown_event.png")时记[ERROR]并不装补丁。 -
单测执行上游真实的
event_handling和click_option_avoiding_unknown(tests/test_event_choices.py),覆盖按表点、 只点一次、表优先于 "???"、单通模式、未收录与上游一致、要点的项没读到、第二屏交回上游、点击没反应的次数上限。 -
待实机确认:选项文字与左边缘同一行的假设(
EVENT_OPTION_ROW);not_in_table的日志里选项文字是否完整。
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里的顺序);没有再看前缀匹配 (名字至少两个字,后面带任意后缀),这一屏只有一条才点,两条以上记日志不点、继续翻页。 - 选队 OCR 读引擎的逐行结果(2026-11-14 复查修正):原来经
_run_ocr_for_text的{文本: 坐标},选中某队后顶栏和列表里是同一个名字,顶栏那条会被列表那条覆盖,「已经是这支队」和点完后的确认都会读不到顶栏;旧测试用假的成对结果模拟了重复,真实 dict 做不到,所以没测出来。 - 顶栏确认只认归一后的精确匹配:「已经是这支队」的判断和点完后的确认都一样。顶栏是
流血队时会回列表里确认唯一再点一次, 避免把流血2当成流血。 - 日志:每屏没命中时打印
第 N 屏没有 流血; 这一屏的名字: 剧情关卡/斩击/...;点了但顶栏没变时打印顶栏读到了什么。 - 限制:唯一性只按当前这一屏判断;相似队名分在两屏时(例如
流血队在第 2 屏、流血2在第 3 屏)会点先出现的那条。 顶栏位置仍是写死的TEAM_HEADER,字号/布局变了要按日志里「顶栏读到」调整。 - 实机验收:把「流血」改名成「流血队」跑一局,日志应出现
编队列表里找到 流血队 @(...), 前缀匹配 流血和已按体系名选中编队 流血队。
P2-6 商店必买清单本地化
现状:必买靠 5 张英文/图标模板;汉化后商店里的名称是中文,模板匹配靠图标尚可,但新增饰品无法覆盖。
目标:支持「饰品中文名 → 优先级」的配置表,OCR 命中即买;模板作为兜底。
验收:单测 + 实机一局至少一次由名字命中的购买。
涉及:lc_mcp/aalc_patches.py(包一层购买判定)、新增数据文件。
状态(2026-11-14 云端):已实现,待实机验收。
- 截图
docs/feedback/mirror_20261002_181322/special_shop_missed.png证实商品格下面写着饰品中文名(无头肖像、辉光变动仪…), 不用点开就能 OCR。 - 做法:
install_shop_by_name()包住Shop.buy_gifts,调用期间在must_purchase列表最前面临时插 3 个占位项。 上游for commodity in must_purchase: auto.click_element(commodity, ...)点到占位项时改成:以shop_coins_assets.png(上游re_sort_points用的同一个锚点)为基准,在商品格范围内整屏 OCR,名字与表里完全一致(允许+后缀)就点名字上方 155(1440 标定)的图标;之后"购买 → 确认"仍是上游那段循环。没命中的截图不重复 OCR;同一名字一次进店最多点 4 次 (钱不够时上游会反复重点)。调用结束把占位项拿掉、还原click_element。 - 表
lc_mcp/data/shop_gifts.json:默认就是 AALC 那 5 张必买模板对应的饰品,名字按零协汉化:缘分残片、卡蜜拉、采血包、归途、石版字符 (顺序是建议:立即见效的在前)。核对描述发现 AALC 说的"回血饰品"只有后三个是回血。图标模板仍在后面兜底(名字读错时照样买)。 - 审计:按名字找到记
shop/name_match;随后的购买仍记purchase_clicked,choice是shop_by_name。aalc_task里这个补丁装在商店审计之后,审计才看得到占位项那一下。 - 回滚:
LCP_SHOP_NAMES=0;表读不了、或上游不再逐个click_element(must_purchase)时记[ERROR]并不装补丁。 - 单测执行上游真实的
Shop.buy_gifts(tests/test_shop_by_name.py):名字命中、表顺序、名字读错时模板兜底、买不起时的点击上限、 与审计一起装;坐标按截图实测(金币 (827,206)@1080,名字行在 +409/+716、图标在名字上方 155,均为 1440 标定)。 - 待实机确认:普通商店与截图里的特殊商店布局一致;实机一局至少一次
shop.name_match; 买不起时上游会在购买框开着时重点商品(模板也一样),按名字重点的那几下落在框上是否无害。
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 的序列化格式(只读参考)。
状态(2026-11-14):不做。用户确认观测饰品不需要自动勾选。
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 的自动寻路是两套,别混 |