Skip to content

Pensieve 深度解析

📖 完整 HTML 可视化版本:pensieve-deep-dive.html

什么是 Pensieve

Pensieve 是一个为 AI Agent(特别是 Claude Code)设计的项目级持久记忆系统。名字来自《哈利波特》中的冥想盆——一个可以存储和提取记忆的容器。

它解决的核心问题:LLM 有卓越的推理能力,但没有持久记忆。 每次新会话开始,Agent 对项目的认知归零。Pensieve 通过结构化的 Markdown 知识库,让经验从一次会话传递到下一次。

文章索引

#文档主题
1架构与设计哲学双层架构、系统代码与数据隔离、manifest 锚点
2四层语义模型MUST/WANT/IS/HOW 分层、short-term 缓冲机制
3双系统检索与 pensieve-wand快思考/慢思考、认知预算、知识升级路径
4工具链与 Pipeline七大工具职责、Pipeline 骨架、commit/refactor/review 工作流
5知识图谱与生命周期[[...]] 链接系统、状态机、refine 五问法
6实践指南与对比安装配置、日常使用、vs RAG/Vector DB

快速导航

核心文件

设计原则

  • 最少上下文:通过 skill 渐进式披露,避免 token 浪费
  • 全工具兼容:不依赖特定 AI 工具,任何支持 Skill/MCP 的工具均可使用
  • 自增长:每次对话后自动沉淀知识,越用越精准
  • 双轨记忆:short-term(会话内)+ long-term(持久化)

元信息

Released under the MIT License.