ramakay/claude-self-reflect

这是什么？

核心功能

• 01基于本地嵌入模型对过去的 Claude Code 对话进行语义搜索
• 02单一 Rust 二进制，使用 SQLite 与 HNSW 索引，无需外部服务
• 03六个生命周期钩子自动注入相关历史上下文
• 04提供 15 个 MCP 工具，支持按文件、概念、时间线和完整对话查询
• 05代码图谱可将函数或文件关联到影响其演变的对话
• 06安装需用户确认，仅在激活时注册 MCP 并安装钩子

适用场景

• 回忆之前会话中某个 bug 的修复方式或组件的设计思路
• 查找促使某个文件或函数当前实现形成的历史对话
• 在多次会话之间保留长期项目的决策记录

快速上手

1. 1

   运行 README 中的官方安装脚本（下载二进制文件，激活前会先询问）

2. 2

   通过 npm 安装（仅下载二进制文件，不激活）

   npm install -g claude-self-reflect
3. 3

   执行设置（注册 MCP 服务器、安装钩子、导入对话）

   csr-engine setup
4. 4

   重启 Claude Code

使用前须知

• !预编译二进制文件支持 macOS Apple Silicon、Linux x86_64/WSL 和 Linux ARM64；Intel Mac 需要从源码构建。
• !AI 叙述功能为可选，但会通过 claude -p 使用你的 Claude 订阅并消耗 token。

收录于专题

标签

常见问题

claude-self-reflect 是什么？

一个本地运行的 Rust 工具，通过语义搜索让 Claude Code 记住过去的对话，以 MCP 服务器形式提供。 Claude Self-Reflect 是为 Claude Code 设计的记忆层。它会索引 ~/.claude/projects 中过去的对话记录并支持语义检索，使之前会话中的解决方案、设计决策和调试过程在相关时可以被找回。项目以单个 Rust 二进制文件发布，使用 SQLite 存储文本块、向量和增强状态，用 HNSW 索引做向量搜索，并配有本地 FastEmbed 嵌入模型。核心检索无需数据库服务、容器或 API 密钥。

claude-self-reflect 可以免费使用吗？用的什么许可证？

claude-self-reflect 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

claude-self-reflect 还在维护吗？

活跃维护中。claude-self-reflect 最近一次提交是在 2026年11月2日。

claude-self-reflect 适合用来做什么？

回忆之前会话中某个 bug 的修复方式或组件的设计思路 查找促使某个文件或函数当前实现形成的历史对话 在多次会话之间保留长期项目的决策记录

claude-self-reflect 怎么安装和运行？

运行 README 中的官方安装脚本（下载二进制文件，激活前会先询问） 通过 npm 安装（仅下载二进制文件，不激活）: npm install -g claude-self-reflect 执行设置（注册 MCP 服务器、安装钩子、导入对话）: csr-engine setup 重启 Claude Code

在哪里获取 claude-self-reflect？

源代码和安装说明在 GitHub 上：https://github.com/ramakay/claude-self-reflect