成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Whirlwind:用 SQLite FTS5 给编码 Agent 可检索课次

对照个人实践:在本地编排器里把课次做成可检索记录,用 FTS5+加权 BM25、项目/角色作用域、源锚过期与 MCP on-demand 搜索,并在 SQLite 里持久化阅读额度;不代你灌全库进提示、不外推准确率。

飞书DeepSeekClaudeChatGPT⚡ 效率办公🛠️ 开发者工具

场景说明

面向自建编码编排器:把「把旧笔记全塞进上下文」写成可对账的检索+额度记忆,区别于笔记库 CLI 摘要与意图评审壳。

案例叙事

01他们做了什么

作者 Nirmal Khedkar 在个人站《I Gave Coding Agents a Search Engine with SQLite FTS5 and MCP》(meta/JSON-LD datePublished=2026-10-21)写明:为本地工程编排器 Whirlwind(Ideation/Planner/Coding/Reviewer 四角色)加项目记忆时,若把既往笔记全塞进每次提示,只是昂贵阅读作业。他把检索放在 Go 后端:先搜笔记本、交一小撮结果,任务中途再允许再搜——落地为 SQLite FTS5、排序策略与 MCP 工具 `search_lessons`。

课次记录含触发、应避免的错误、纠正与证据,并可带路径/符号/错误签名/源锚以便对照代码是否已变。检索按当前项目与角色作用域,作用域来自运行中的 operation,不由模型在搜索参数里自选。FTS5 虚拟表对标识符与纠正加权高于散文;精确路径/符号/错误签名优先于散文 BM25。索引可重建,触发器与主表同步;退役状态不得占候选窗。自动检索查询收窄为任务事实,避免角色说明书与已召回课次自我强化。交付前用工作树指纹核对源锚,不匹配则标 stale。

MCP 路径只收 query,项目/角色/operation 由服务端注入;标注只读但实际由服务端强制作用域。额度也在 SQLite:自动召回最多约 3 条且约 2KiB 块;on-demand 每 operation 约 2 次、单次约 2KiB、合计约 4KiB——字节限制而非 token。预算键含项目/任务/计划版本/角色/operation 等,重启 attempt 不刷新额度;失败搜索仍占调用次数。可选语义路径默认关,需有评估结果才开,失败回落 FTS5。作者重跑 race 测试覆盖检索/额度/MCP,但明确未跑 live model probes,故不声称任务更快或更准。本场景据此输出「可检索课次记忆」提纲。禁止建议把全库笔记灌进系统提示。

02实际效果

  • 源披露机制上限(自动约 3 条/2KiB、on-demand 约 2 次与字节帽等)与测试范围,并声明未做 live 准确率对比;属源披露设计量级,不可外推为你的召回率或省时。
  • 能把「再加一个 RAG」与「作用域+源锚+持久额度的检索记忆」拆开。
  • 为查询构造(任务事实 vs 说明书)与并发预订额度提供提问清单。

03值得知道

  • 权重与额度是作者策略选择,不是相关性基准结论。
  • 凭证检测器不是证明所有敏感串都能识别;嵌入路径需额外谨慎。
  • 上面写的是个人编排器实践,不是通用记忆 SaaS 承诺。

04可复制提示词

FTS5 课次记忆简报

你是编码 Agent 记忆设计助手。只根据用户约束写检索记忆提问清单,不要编造已上线。

课次是否已结构化:{{lesson_schema}}
项目/角色隔离:{{scope_rules}}
自动召回额度:{{auto_budget}}
on-demand 次数:{{ondemand_calls}}

输出 Markdown:
1. 课次必填字段与源锚
2. FTS 加权与标识符优先规则
3. 额度键应包含哪些维度以免重启刷预算
4. 人工抽检 stale 课次的方法
禁止建议全量塞进系统提示;禁止声称召回率已达某%。

记忆污染排查提纲

Agent 反复召回过期或跨项目建议,请写排查提纲。

现象:{{symptom}}
近期变更文件:{{changed_files}}
是否有 MCP 搜索:{{used_mcp_search}}

输出:
1. 是作用域泄漏、源锚未校验,还是额度未持久
2. 最小补丁
3. 应用哪条回归测试锁住
4. 人工确认清单
不要伪造「记忆已永久净化」。

怎么做

  1. 粘贴是否已有课次结构、多项目/多角色是否隔离、以及自动召回 vs on-demand 额度上限
  2. Agent 按实践帖输出:课次字段→FTS5 加权与标识符优先→源锚过期→MCP 搜索与 SQLite 额度记账提问清单
  3. 人工在本机落地;Agent 不把密钥送进嵌入端点、不声称已提高任务通过率

实用提示

  • 源帖核心句:笔记本只有找得到才有用;自动检索应搜任务事实,而不是把角色说明书整段当查询
  • 与 notes-vault-cli-summarize-agent / repo-adr-madr-memory-for-coding-agents / melon-coding-agent-prove-claims 不同:本条是编排器内 FTS5 课次检索+源锚失效+跨重启持久额度,不是笔记库摘要 CLI、ADR 记忆文件或可核验声明门禁
#FTS5#Agent 记忆#MCP#上下文预算#个人开源