cap'n hook 评测 2026：为编程代理装上持久记忆，文件一改自动失效

每个用过编程代理的开发者都熟悉这个仪式：每次新会话前 10 分钟，都在重新解释代码库结构、重新发现某段逻辑藏在哪里、重新回答代理昨天已经解决过的问题。代理是健忘症患者——会话结束，一切归零。cap’n hook 用令人愉悦的简洁方式回应了这个痛点。

它的思路很优雅：当编程代理搞清楚某个逻辑在哪里、某个机制如何运作时，把答案存成 Markdown 文件，放在本地的 .capn/ 目录里。下次会话，代理不用重新探索，一条命令就能调出答案。最妙的是缓存清除机制：每条记忆都附带其底层文件的 sha256 指纹。一旦那些文件发生任何变更，对应记忆就被自动删除。你永远不会在过期的上下文上做决策。

核心功能

cap’n hook 是一款轻量级、本地优先的 CLI 工具，以 SessionStart 钩子形式安装到 Claude Code 和 Codex 中。当代理回答了一个问题——比如「认证中间件在哪里？」——cap’n hook 把相关文件和摘要保存下来。下次会话，代理通过 .capn 命令即时取回答案。底层原理很简单：可读的 Markdown 条目存在被 gitignore 的本地目录中，支持混合搜索或 BM25 检索已存记忆，并维护一份「哪些文件回答哪些问题」的关系图。在 5 个生产级代码库、60 个真实开发者问题的基准测试中，使用 cap’n hook 的代理在答案正确率不变的前提下，token 用量比冷探索减少了 77%。

典型应用场景

• 代码库上手记忆持久化：代理花了 20 分钟追踪一个复杂数据流，把结果存下来。下一位开发者（或下一次会话）只需几秒就能拿到答案。
• 周期性调试模式：如果你总在问「支付管道的重试机制怎么处理」，保存一次答案，每次碰那个模块时直接调取。
• 跨会话架构探索：代理在多个会话中逐步绘制大型代码库的地图，持续积累心理模型，而非每次都从零开始。
• 团队知识共享：.capn/ 目录虽是本地化的，但可以选择性提交部分条目作为团队文档。

产品优势

一条命令持久回忆

代理搞清楚某件事后，一条命令保存答案。下次会话，.capn [问题] 即时取出。不用重新探索、不用重读半个代码库。

文件指纹自动缓存清除

每条记忆与其源文件的 sha256 哈希绑定。文件一旦变更，关联记忆自动失效并被删除。永远不会拿到一段已被重构的代码的过期答案。

轻量级，零包装器

以 SessionStart 钩子形式安装——没有中间件、没有 API 服务器、除首次下载的嵌入模型外没有外部依赖。代理自然而然地知道 .capn 并能使用它。

人类可读的记忆图谱

所有条目以纯 Markdown 文件存放在 .capn/entries/ 中。你可以手动浏览、编辑或删除它们。默认被 gitignore，但可选择性分享。

局限性

• 首次运行需下载嵌入模型：300MB–2GB 不等，取决于选择的模型。
• 仅本地有效：记忆不跨机器同步。
• 依赖代理遵守提示：如果代理忽略 .capn 的存在，效果就打了折扣。
• 官方钩子仅支持 Claude Code 和 Codex：其他代理可通过 CLI 调用，但集成体验不如官方钩子。

价格方案

cap’n hook 免费且开源，MIT 协议。没有付费层级、没有 SaaS、没有账号。唯一的成本是首次运行时下载嵌入模型（300MB–2GB）。

常见问题

如果我重构了已保存记忆对应的代码会怎样？ 关联变更文件的记忆会被自动删除。下次代理遇上那段代码时会重新探索并保存新答案。系统偏向正确性——忘记一个答案比用错一个答案好。

除了 Claude Code 和 Codex，其他代理能用吗？ 官方 SessionStart 钩子目前仅支持 Claude Code 和 Codex，但核心 CLI 是代理无关的。任何能调用 shell 命令的代理都可以使用 capn recall 和 capn save。随着项目成熟，更多代理的官方支持预计会跟上。

总结评价

cap’n hook 用令人赞叹的优雅解决了一个狭窄但普遍的 AI 辅助开发痛点。sha256 缓存清除是正确的设计决策——它把记忆从潜在风险（过期答案）变成了可靠资产。基准测试中 77% 的 token 节省与直觉相符：代理确实把大量上下文窗口花在了重新学习它在之前会话中已经「知道」的东西上。对于每天使用 Claude Code 或 Codex 的开发者来说，这是一个不需要犹豫的安装。主要限制都很温和：首次模型下载、仅本地范围、依赖代理实际使用钩子——但都不影响核心价值。简单、专注、立即可用。