Pensieve

把 LLM 记住你的过程画出来，还能动手改

Pensieve 是一个用 TypeScript 构建的交互式可视化系统，专门用来观察、解释和管理大语言模型如何“记住”用户。它解决的核心问题是：当前 LLM 的记忆机制对普通用户完全是个黑盒，用户不知道模型记住了什么、为什么记住、这些记忆又如何影响回答。Pensieve 把模型层面的记忆机制翻译成用户可理解的可视化界面，让 AI 记忆变得可观察、可解释，并且部分可控制。核心能力包括：展示记忆如何塑造某一条具体回答，让用户看到记忆与输出之间的因果链路；提供记忆的解释视图，帮助理解模型为何保留某条信息；支持对记忆进行管理操作，比如查看、调整或清理，从而在一定程度上干预模型行为。项目定位在搜索与知识管理方向，适合研究者、AI 产品开发者以及对 LLM 可解释性感兴趣的用户。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1362

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队DrJonaC

所属国家

官网地址

GitHubhttps://github.com/DrJonaC/Pensieve

定价模式free

价格说明开源项目，免费使用

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型

GitHub 星标★ 1362

30天Star增速

HF 下载量

上线时间2026-04-14 00:00:00

最近更新2026-09-24 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-25

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

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

项目介绍

Pensieve 是搜索知识领域的开源项目，由 DrJonaC 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,362）位列前 30%，在搜索知识分类中处于中上游。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-24。免费使用。

它主要面向的使用场景是：AI产品团队排查模型为何给出某条奇怪回答，定位是哪段记忆在起作用。同类可对比的替代方案包括 LangChain、MemGPT。

上一篇：llm-rankers

下一篇：medical-rag