项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整
数据来源：GitHub API 逐日快照 · 收录于 2026-09-25 · 当前星标 ★ 1320
使用教程
环境要求
- Node.js 22.18+（CI 使用 Node 22 LTS）
- npm（随 Node.js 一起安装）
- 本地回环地址上的浏览器访问权限
- 可选：OpenAI API Key（仅 Live 模式需要）
安装与启动步骤
-
1克隆仓库
从 GitHub 拉取 Pensieve 源码到本地目录。
git clone https://github.com/DrJonaC/Pensieve.git -
2进入项目目录
切换到刚克隆下来的项目根目录，后续命令都在此执行。
cd Pensieve -
3安装依赖
用 npm ci 按锁文件安装全部依赖，保证版本与官方一致。
npm ci -
4启动开发服务
运行开发服务器，命令会绑定到本地回环地址。
npm run dev -
5打开记忆库页面
在浏览器访问该地址。新库自带示例记忆，无需 API Key 即可使用。
-
6配置 Live 模式（可选）
在项目根目录新建 .env.local，写入 API Key。改完服务端配置需重启应用。
-
7生产模式构建与启动
如需正式运行，先构建再启动，同样绑定回环地址。
npm run build npm run start
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OPENAI_API_KEY | 否 | 仅在 Live 模式使用，走 OpenAI Responses API 提交查询 | your_api_key_here |
如何确认成功
浏览器打开 http://127.0.0.1:3000/memories 能看到记忆库页面和自带示例记忆，即启动成功。
常见问题
Q：必须要有 OpenAI API Key 吗？
A：不需要。记忆管理与 Mock 模式都无需 API Key，只有可选 Live 模式才需要在 .env.local 里配置 OPENAI_API_KEY。
Q：访问哪个地址？
A：打开 http://127.0.0.1:3000/memories。服务只绑定回环地址，仅本机可访问。
Q：改了 .env.local 为什么不生效？
A：服务端配置在启动时读取，修改后需要重启应用（重新执行 npm run dev 或 npm run start）。
Q：Pensieve 会读取我 ChatGPT、Claude 里的记忆吗？
A：不会。它管理的是外部结构化记忆，内置适配器只使用 Pensieve 自己的仓库，不会自动读写这些私有记忆。
Q：可以部署到公网吗？
A：不建议。这是单用户应用，并非带鉴权的公共服务，无访问控制时不要对外暴露。
注意事项
- Node.js 需 22.18 及以上，建议使用 Node 22 LTS。
- 切勿把 .env.local 提交到代码仓库。
- 本地命令都绑定回环地址，这是单用户应用，不是带认证的公共服务。
- Live 模式下只有你显式提交查询时，才会把过滤后的查询和选中的记忆上下文发给模型。
核心亮点
- 用可视化把 LLM 记忆与回答之间的因果链路直接呈现，不是抽象指标而是可交互界面
- 支持对记忆进行部分管理操作，用户不只是观察者，还能干预模型行为
- TypeScript 实现，前端技术栈友好，便于二次开发和集成到现有 AI 产品中
不足之处
- 项目处于成长早期，星标约 1.3k，生态和长期维护稳定性有待观察
- 记忆管理能力标注为“部分可控”，实际可干预的粒度和范围可能有限
适用场景
- AI 产品团队排查模型为何给出某条奇怪回答，定位是哪段记忆在起作用
- 研究者做 LLM 可解释性实验，需要直观展示记忆对输出的影响
- 个人用户想查看并清理 AI 助手对自己的长期记忆，保护隐私
替代项目
LangChain、MemGPT
上一篇：llm-rankers
下一篇：medical-rag
同类项目推荐
bgts-context-engine
开源
不靠大模型，用代码图给 AI 编程助手喂稳定上下文
Deterministic code-graph context engine for AI coding agents - PostgreSQL + Apache A···
Ataru
开源
把本地代理历史变成秒级可搜的记忆库
High-performance AI memory retrieval for local agent history — a Rust search core (···
GPT-RAG
开源
Azure 上一键搭企业级 Agentic RAG，带零信任和 IaC
Enterprise-grade landing zone for AI agent applications on Azure. Deploy the secure ···
thesys-core
开源
搜论文、读 PDF、问答带原文高亮，引用一键导出
Open-source research workspace: search academic papers, upload PDFs, inline citation···
TreeSearch
开源
像人一样搜代码，无需向量化，毫秒出结果
TreeSearch: Search your codebase like a human — not like a vector database. No embe···
A-Guide-to-Retrieval-Augmented-L···
开源
从零看懂RAG，快速上手检索增强大模型
an intro to retrieval augmented large language model
KnowledgeRAG-OGAS
开源
本地知识库+大模型，让问答更准不胡说
基于Fastapi + React 实现的面向智能知识管理的Agentic RAG系统，支持私有部署和多租户，以···
CiteProof-AI-MCP
开源
给 AI 研究报告加引用核验和可复现审计
Open-source research assistant and MCP audit toolkit for systematic reviews: cited r···
DanbooruSearchOnline
开源
说人话就能找到 Danbooru 标准标签，快速拼出绘画提示词
本项目提供一种基于语义匹配的 Danbooru 标签查找方案。用户可以通过输入日常语言或模糊描···