Eo Recall

eo-recall — 回忆与解释

项目记忆与代码的只读检索入口：把「我忘了当初……」变成一次有出处、分口径的检索问答。严格只读——除 tmp/eo/explain/ 的一次性解释页外不写任何文件。

核心原则

1. 查了才答：答案必须来自本次检索到的文档/代码，每个论断带出处（文档路径或 file:line）
2. 无记载不编造：文档里查不到就明说「文档无记载，以下是我从代码现读的」——把「回忆」和「现场推断」显式分开
3. 口径分层：需求设计视角与代码实现视角分开作答，不搅在一起
4. 定位纪律：.codegraph/ 索引存在则 codegraph explore 优先；不存在则走 INDEX 收敛 + 源码直读，不全局盲扫

前置

必须能找到 .eo-project.json。同目录存在 .eo-project.local.json 时顶层字段覆盖合并（local 优先）。找不到 → 报错退出，提示运行 /eo-project-init。

工作流程

第一步：问题分类（可复合）

复合问题（最常见：「这个系统当时怎么设计的」= 现状 + 缘由）按需叠加信源。

第二步：检索瀑布

• 现状/实现：state/ 已启用（配置 state.enabled）时先读 eo-doc/state/ 对应现状篇（派生快照；篇≠码以代码为准，并提示可跑 /eo-doc-manager sync 刷新）；随后 .codegraph/ 索引存在则 codegraph explore "<自然语言问题>" 优先召回相关符号源码与调用链；不存在则按目录结构收敛、直读源码相关段落（不通读文件）
• 缘由：eo-doc/changes/INDEX.md 找相关 change → 读其 §1 意图与已钉决策；再查 <project_root>/decisions/（扫其 INDEX.md，无 INDEX 则按文件名收敛）与 <project_root>/brainstorm/ 的相关记录；涉及外部世界（第三方 API / 平台规则 / 竞品 / 选型）→ 按 ../eo-shared/research.md 消费规则查 <project_root>/research/；lessons 若 trigger 命中也一并带上（踩坑背景常常就是「为什么后来改成这样」）
• 候选 >3 或全无命中 → 追问关键词，不硬猜

第三步：分层作答

## 需求上（设计口径）
<规则/流程/边界，出处：change <id> §1、decisions/2026-xx.md>

## 代码上（实现口径）
<入口、关键路径、数据流，出处：src/xx.ts:120-160>

## 当时为什么这么定（若问及）
<已钉决策 + 理由，出处>

⚠️ 文档与代码不一致处 / 文档无记载处，单独列出（以代码为准）

• 不确定的就说不确定，不填补空白

第四步：富输出（按需，默认不产文件）

• 流程 / 状态机 / 多角色交互类逻辑 → 主动提议：「画个 mermaid？」（对话内直接给，规范见 ../eo-doc-manager/references/mermaid.md）
• 盘根错节的大逻辑（多系统联动、你需要反复对照的）→ 提议生成一次性自包含 HTML 解释页：tmp/eo/explain/<date>-<topic>.html，零外部依赖、用项目真实名词与数据、可交互（点击展开/分步演示）；它是可丢弃工件（见 ../eo-shared/conventions.md），有长期价值的结论应沉淀到 decisions/lessons（提示用户走 /eo-project-record）而不是留在 tmp

第五步：顺手指路（一行，可选）

回答末尾按语境补一句出口：「想改这个行为 → /eo-change」「这看着像 bug → /eo-fix」。不自动派发。

关键约束