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

263 lines
17 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`),关键词要容忍错字。
**状态(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 的自动寻路是两套,别混 |