# 待开发计划(BACKLOG) 按「收益 / 风险」排序。每条都带**证据**和**验收标准**,云端改完直接照着验。 最近一次实测记录见 [`feedback/2026-11-14/README.md`](feedback/2026-11-14/README.md), 接口与队名表见 [`feedback/2026-11-14/HANDOVER.md`](feedback/2026-11-14/HANDOVER.md)。 图例:P0 = 现在是坏的/每天都在浪费;P1 = 明显影响质量;P2 = 打磨。 --- ## P0-1 商店「必买 / 必卖 / 公式合成」清单恒为空 **现状**:`tasks/mirror/__init__.py` 用旧路径加载模板: ```python 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`),关键词要容忍错字。 --- ## 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) **风险**:低-中。选项点错可能拿不到奖励,但不会卡死。 --- ## 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/.decisions.jsonl`:时间、阶段、画面摘要、候选、选中项、理由。 **验收**:一局结束后能直接统计「卡包选择理由 ×N」「三选一命中体系 ×N」「商店购买 ×N」。 **涉及**:`lc_mcp/aalc_patches.py`、`lc_mcp/tasks.py`(结果归档)。 --- ## 已知但暂不做的 | 项 | 原因 | |---|---| | 让 AALC 原生支持自定义队名 | 要改 `vendor/aalc`,submodule 升级会丢;补丁层已够用 | | 自动识别「哪支队是流血队」 | 图像/文本都不可靠,靠命名约定(见 HANDOVER 第 4 节)更稳 | | 改 `mirror_dungeon_speedrun_notes.md` 的路线结论 | 那是人工速通笔记,和 AALC 的自动寻路是两套,别混 |