Files
lc-mcp/docs/BACKLOG.md
T
ywsandClaude Opus 5.5 e08edda27d P1-5 镜牢选队容忍 OCR 误读与队名后缀
- 队名先归一:去空白、NFKC 全角转半角、改回实测误读(震颐→震颤、沉论→沉沦、编#→编队#)
- 精确匹配优先;否则接受这一屏唯一的「名字+后缀」(流血队、流血(X)),多条不点
- 顶栏确认只认精确,避免把 流血2 当成 流血
- 没命中时日志打印每屏看到的名字,点了没变时打印顶栏读到的文字

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

212 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 待开发计划(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/<task>.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 的自动寻路是两套,别混 |