Pensieve Skill 技能

Pensieve - 给本地 Agent 接上全机搜索记忆库的跨平台 MCP 后台

技能简介

Pensieve 是一款跑在你 Mac 上的"全机本地搜索引擎 + Agent 上下文增强器"。它索引文档、代码仓库、过往 Agent 会话，并通过 MCP（Model Context Protocol）把"最相关的文件与代码片段"精准推送给 Claude Code、Codex、Cursor、Qwen Code、Windsurf 等 Agent，让 Agent 不必再 grep 你的整块磁盘。Git blame、内向专家、知识盲区这些协作利器也一并奉上。

核心能力

• 全机混合检索：Control+Shift 全局呼出，按"含义"或"精确词"搜索文档、文件夹、代码与历史 Agent 会话。
• Agent MCP 上下文喂料：每个 Agent 连接都限定一个 scope（如"它正在改的 repo"），返回的是少数几个相关文件而非整块 grep 结果，省时间省 token。
• git blame 找专家：看到一段代码就能问"这块是谁写的、谁能解释"，顺手给出 git blame 友好的归属与活跃度统计。
• 知识盲区识别：识别出"那段代码大部分是被已经不在团队的人写的"，给出还能问谁、谁拥有这块领域知识。
• 本地嵌入模型：Qwen3-Embedding-0.6B 文本嵌入 + SQLite（trigram 全文索引） + turbovec 向量索引，全部本地运行。
• 可选内嵌 AI 摘要：内置 Qwen 3.5 9B、LM Studio、Claude Code 或 Codex 任选其一做主题摘要与盲区洞察。
• Agent 行为改造：pensieve-search Skill、pensieve-teammates、pensieve-plan 等附加包让 Agent 主动先搜后写，避免重复造轮子。

安装配置

1. 环境要求：macOS（推荐 Apple Silicon）；或 Linux / Intel Mac（自动从源码安装）。
2. 一键安装：curl -fsSL https://tedhaley.ca/pensieve/install.sh | sh，脚本会自动下载 Pensieve.dmg 并装到 Applications，同时安装 pensieve 后台进程。
3. 连接 Agent：pensieve integrate recommended，它会自动扫描 Claude Code、Codex、Cursor、Gemini CLI、Qwen Code、Windsurf、Claude Desktop、VS Code，并给它们各自加上 Pensieve MCP。
4. 首次启动设置：开 App，按 6 步引导（说明用途 → 选工作类型 → 选要索引的文件夹 → 选择要索引内容 → 选 insight 引擎 → 启动索引）。
5. 作用域 scope：通过 Settings → Scopes 设置不同场景的可见索引，如 payments = repos/~/code/billing + repos/~/code/ledger + files/~/Documents/specs。

使用步骤

1. 首次初始化：执行 pensieve setup recommended，对推荐的文件夹做首次索引（约 500 个代码文件/分钟）。
2. 在 Agent 中搜索：以 Claude Code 为例，输入"我们之前如何处理幂等性？"或"是谁维护 payments pipeline？"，Agent 自动调 MCP 工具返回最相关的代码 + 作者。
3. 定位知识盲区：调用 who_knows 或 knowledge_gaps 工具，分析某个 repo 的活跃度与代码所有权，找到当前最适合问的人。
4. 新代码即时同步：开启 claude-hook（PostToolUse），每次 Claude 编辑代码就自动把新路径同步进索引，搜索永远是新鲜的。
5. Prompt 增强（可选）：装 claude-prompt-search 后每次用户输入 prompt 时自动把 5 段最相关代码贴回到 prompt 里，省去 Claude 的首次搜索。

适用场景

• 多 Agent 协作开发：Claude Code + Codex + Cursor 同时在线，每个 Agent 都拿到"刚好够用"的相关上下文。
• 跨 repo 代码考古：在 monorepo / 多 repo 团队里快速找到"那段实现到底是哪年谁写的、还能不能改"。
• 历史 Agent 会话复用：让新 Agent 直接看到旧 Agent 的工作思路，避免重复试错。
• 团队组织治理：识别"knowledge bottleneck"——某段代码仅有 1 个当前活跃的作者，提早规划交接。
• 本地文档检索：个人 Mac 上的 PDF、笔记、Markdown 全部可索引，省去 OneDrive / Notion 同步延迟。
• MCP 后端集成开发：想自己接入更多 Agent 或 IDE，Pensieve 提供 ?tools=all 全部能力的 HTTP 端点。

适用人群

• 多 Agent 重度用户：Claude Code + Codex + Cursor 都在用，希望它们上下文互补。
• 中大型代码团队：希望新人 / 接手同事能快速找到"懂这块代码的人"。
• 本地优先开发者：不希望自己的代码、个人笔记发到远端。
• 技术博主 / 写作团队：经常跨项目复用旧文与旧 demo。
• 关注 token 成本的团队：通过精准喂料减少 Agent 的"瞎搜"。

工作原理

Pensieve 的核心是一个跑在你 Mac 上的 Python 后台进程：它读 Qwen3-Embedding-0.6B 把文本切成 embedding，连同精确词 trigram 索引一并写入 SQLite + turbovec。它为每个 Agent 提供 scope-aware 的 MCP 工具集（search / read / similar / overview / who_knows / knowledge_gaps / list_repos 等），并通过 claude-hook 等钩子在每次代码变动时立即把新路径同步进索引，让搜索结果始终保鲜。AI 摘要与盲区洞察可选地由本地 Qwen 3.5 9B、LM Studio、Claude Code 或 Codex 离线完成。

官方链接

• 项目仓库：https://github.com/TedHaley/pensieve
• 官网与安装入口：https://tedhaley.ca/pensieve/
• 一键安装脚本：curl -fsSL https://tedhaley.ca/pensieve/install.sh | sh
• 配套生态：pensieve-search / pensieve-teammates / pensieve-plan / claude-hook