cap'n hook 评测 2026：给 AI 编程代理装上持久记忆，代码一变自动失效

如果你见过 AI 编程代理每次新会话都重复探索同一批代码——重新读取你已解释过的文件、重复追踪你已梳理过的调用链——你就知道这种”失忆症”有多昂贵。AI 编程助手很聪明，但每次新会话都要烧掉数千 token 去重新发现已知信息。cap’n hook 用一个小而巧妙的设计直面这个问题：让代理记住它学到的东西，并在文件变更时自动擦除过时记忆。

cap’n hook 以轻量级 SessionStart 钩子的形式安装到 Claude Code 和 Codex 中，无需包装器、无需中间件、无需服务器。它将可读的 Markdown 格式记忆条目存入本地的 .capn/ 目录，你可以直接浏览、编辑，甚至把它当作项目的知识库。当代理搞清楚某个问题——比如哪个模块负责认证逻辑，或者数据库迁移流程怎么走——它就把关键文件保存为一条命名记忆。下次会话，一条 CLI 命令即可取回上下文，省去重新探索。

cap’n hook 是什么

cap’n hook 是一款本地优先的记忆工具，为编程代理提供跨会话的持久记忆。它的杀手锏是缓存自动清除机制：每条记忆都用其底层文件的 SHA-256 哈希值做指纹标记。一旦文件变更或消失，对应记忆立即自动删除——你永远不会基于过期信息做判断。核心 CLI 支持 QMD 混合搜索和 BM25 两种检索模式，对任意代理通用，而官方钩子则将其无缝嵌入 Claude Code 和 Codex 的会话生命周期。

典型应用场景

• 让新代理快速接手大型代码库：不用让代理花 20 分钟探索项目结构，直接取回预先保存的记忆，其中已标注架构总览、核心模块和入口点，大幅缩短启动时间。
• 深入调试复杂 Bug：调试跨多个文件的棘手问题时，保存发现的关联关系和调用链。下个迭代 Bug 复现时，代理直接从上回的进度继续。
• 辅助代码审查决策：保存过往审查中的判断依据——为什么某个模式被否掉、考虑过哪些边界情况——让后续审查保持一致性，不必反复争辩。
• 跨多天的功能开发：一个功能分几天开发？每次新会话，代理召回上回的设计决策、文件分布和依赖关系，保持开发节奏不断。

核心功能

零开销的持久记忆

用 capn save <名称> <文件...> 一次性保存答案文件，下次会话用 capn recall <查询> 取回。代理拿到精确的上下文，无需重新探索代码库，省 token 也省时间。

SHA-256 指纹自动失效

这是 cap’n hook 区别于简单记笔记工具的关键。每条记忆对其源文件做哈希指纹。改了 auth.ts，依赖它的所有记忆即刻蒸发。不会有过期答案，永远不会有。

代理无关的 CLI + 双模式搜索

核心 CLI 对任何编程代理通用，不限于 Claude Code 或 Codex。提供 QMD（基于查询的记忆发现）语义搜索和传统 BM25 关键词匹配。官方钩子只是把 CLI 接入代理的会话生命周期。

人类可读的记忆图谱

所有记忆以纯 Markdown 文件存放在 .capn/entries/ 中。你可以自己读、自己改，重要的可以加入版本控制，其余 .gitignore 掉。没有黑盒数据库，没有私有格式。

轻量级 Hook 架构

安装在 Claude Code 或 Codex 配置中只需一行。没有包装脚本，没有中间件服务器，没有后台常驻进程。Hook 在会话启动时触发，注入一条系统提示教代理如何使用 capn。

价格方案

cap’n hook 完全免费，基于 MIT 开源协议。没有付费层级，不需要买 API key，也没有用量限制。唯一的开销是首次运行时下载一个嵌入模型（根据配置不同约 300MB 到 2GB），以及 .capn/ 目录占用的磁盘空间。一切在你本机运行。

常见问题

cap’n hook 能用在 Claude Code 和 Codex 之外的编程代理上吗？ 可以，核心 CLI 是代理无关的。虽然官方 SessionStart 钩子目前仅支持 Claude Code 和 Codex，你可以直接在任意代理中使用 CLI——告诉代理 capn recall 和 capn save 命令可用即可。随着使用者增多，社区可能会贡献更多代理的钩子。

我的代码会被发到云端吗？ 不会。cap’n hook 完全本地运行。嵌入计算在你本机完成，记忆存储在本地 .capn/ 目录，没有数据离开你的文件系统。这个工具是为重视代码机密性的开发者设计的。

如果重命名或移动了某条记忆中包含的文件会怎样？ SHA-256 指纹机制会立刻检测到变更。如果记忆条目中的某个文件在其记录路径上不再存在，该记忆会在下次取回尝试时自动删除。这能保持记忆图谱干净，但也意味着大规模重构后你可能需要重新保存记忆。

总结

cap’n hook 得分 8.4/10。它用优雅的本地优先方案解决了一个真实而昂贵的问题——编程代理的跨会话失忆。自动缓存清除机制确实聪明，解决了简单笔记方案中”过期答案”的痛点。在 5 个生产级代码库的基准测试中，它实现了 77% 的 token 节省且正确率不变，直接转化为更快的会话和更低的 API 成本。

需要权衡的地方也合理：需要下载嵌入模型、记忆不跨机器同步、代理得真正按提示使用这个工具。但对于任何经常在非平凡代码库上使用 AI 编程助手的开发者来说，cap’n hook 是一个简单明了的收益。