用途
CocoRecall 是 CocoPlus 的会话历史检索命令。其定位严格:检索带引用的证据,不做综合或解读。返回改写或摘要内容会让查询方当前的判断框架影响对“过去”的呈现,因此始终返回带完整引用元数据的原轮次摘录。
使用前需确认 .cocoplus/ 目录存在;若不存在,应提示“CocoPlus is not initialized. Run $pod init first.”并停止。
数据与隐私
CocoRecall 完全在本地运行,不向任何位置传输会话数据。recall.db 位于 .cocoplus/recall.db(已加入 gitignore),可从 ~/.snowflake/cortex/conversations/ 的源会话记录通过 $recall import 在任意机器上重建。
主要命令
$recall search <query> [--all] [--session <id>] [--function <name>] [--outcome-type <type>]:按词法匹配、时效衰减、阶段上下文三项相关度评分检索索引。默认按会话多样化返回,每个匹配会话返回一条最高相关轮次,避免单一长会话占据结果;--all返回全部匹配轮次;--session限定单一会话;--function按涉及的函数过滤;--outcome-type按结果契约证据过滤。每条结果必须包含四项引用字段:会话 ID、轮次 ID、Source Exists(检索时对照真实记录路径检查)、Suggested Follow-Up(基于实体标签的后续查询建议)。结果按原文呈现,不改写。$recall show <session-id>:加载并显示指定会话的完整轮次序列,高亮匹配轮次,并支持配置前后上下文行数。$recall import [--since <date>]:从配置的本地会话来源重建或增量更新 recall.db,--since仅扫描指定日期之后开始的会话。$recall sources:列出 cocoplus/recall-sources.json 中配置的会话来源路径、各来源已索引会话数及最近导入时间。$recall status:报告已索引会话总数、轮次总数、索引新鲜度,以及来源路径中尚未索引的会话。
索引结构
recall.db 将会话数据规范化为多个表:sessions(会话 ID、起止时间、阶段上下文、关键实体标签、源路径)、turns(轮次 ID、会话外键、说话角色、序号、非 LLM 提取摘要、全文哈希、标签集)、tool_calls / function_touches / evaluation_results / outcome_contracts / strategy_usage / key_decisions(面向定向检索的规范化切面)、entities(实体名、类型、出现位置)、citations(每次搜索结果对应的查询文本、匹配会话/轮次、源存在标记、引用时间)。
自动化维护
在 Stop 时,钩子执行轻量的 .last-consolidation 年龄检查;若已过 24 小时,则在 .cocoplus/lifecycle/consolidation-log.json 记录一次 Dream Cycle 请求并更新 .cocoplus/.last-consolidation。整合周期分四阶段:ORIENT(盘点 MEMORY.md、recall 状态、CocoWisdom、CocoGrove 及人设历史文件)、GATHER SIGNAL(对近期会话窗口做定向 JSONL 模式提取,在 LLM 处理前搜索模式修正、SQL 性能发现、工作流偏好与治理决策)、CONSOLIDATE(去重、依据出处解决矛盾、保留来源引用)、PRUNE & INDEX(执行热路径行数上限,归档而非删除陈旧条目,保持 MEMORY.md 有界)。若 .last-consolidation 超过 48 小时,CocoConsole 应显示琥珀色维护提示。
Pre-Mortem 检索
将 .cocoplus/session/PROGRESS.md 中 ## Pre-Mortem: <stage-id> <timestamp> 段落索引为会话上下文,存储阶段 ID、失败场景文本、预防状态、操作员确认与来源路径,使 $wisdom recall 与 $recall search 可为相似未来阶段呈现过往分析意图风险。
设计约束与限制
- 不摘要、不改写检索到的轮次,原文检索是核心设计。
- 不隐藏 source_exists 为 false 的结果:源记录在索引后被删除时应报告 source_exists: false,而不是省略标记或隐藏结果。
- 默认会话多样化,防止单一冗长会话排挤其他相关历史。
- 不自动同步 recall.db 到共享位置;共享需通过 recall-sources.json 显式配置。
- 具体要求与架构细节可参考 cocorecall/recall-import 契约;版本兼容性、平台支持等细节暂未提供。