Edith Second Brain

Edith 第二大脑

AI 的第二大脑。

edithapp.ai · 下载 macOS 版 · VS Code 扩展

Edith 是一个本地的纯 Markdown 知识库，Claude 可以从中读取内容，也可以向其中写入内容。让 Claude 回顾你过去的会话，它会自行提炼并生成互相关联的笔记——无需 API 密钥，无需账户，也不会自行进行推理。

Claude session ──MCP──▶      Edith.app      ──▶  the graph lights up
                              │
                              └── vault/notes/*.md

功能

• 无需 API 密钥、无需账户、无需推理。 Claude 在自己的会话中读取和编写你的笔记，使用你已经付费的套餐。Edith 是存储库，也是画布。
• Claude 会帮你填充内容。 让它“回顾我最近的会话，并保存值得保留的内容”，Claude 就会通过 list_sessions / read_session 读取你的转录记录，然后用 save_note 将笔记写回。
• 通过 MCP 为 Claude 提供服务。 提供 search_brain、read_note、list_notes 和 save_note。Claude 可以在会话中途从知识库读取内容，也可以向其中写入内容。
• 查看检索过程。 搜索时，Claude 考虑过的笔记会变暗并发光；打开笔记后，Claude 实际用过的笔记会明亮发光。高亮效果会在 30 秒后淡出。
• 在会话旁使用迷你模式。 最小化 Edith 后，它会变成停靠在屏幕左侧边缘的窄面板，绘制你的知识库图谱，并点亮 Claude 查阅的笔记——窗口和面板不会同时显示。关闭或最小化窗口后，Claude 会话开始时面板也会自动打开。如果你关闭面板，它不会抢占焦点，而是会折叠成与侧边栏等宽的条带，或缩小为角落里的小方块——两种状态都只显示实时图谱；在本次会话剩余时间内，面板都会保持关闭。可在连接下关闭自动打开功能。
• 也可导入自己的内容。 添加内容可导入 .md、.markdown、.txt 和 .mdx 文件，也可导入你粘贴的内容。文件会保留原有的 frontmatter，因此导入 Markdown 知识库时会保留 ID 和链接，而不是重复创建笔记。你可以按原样导入，也可以提炼为概念。
• 纯 Markdown。 磁盘上的文件是唯一可信来源。你可以在任何编辑器中编辑它们。删除索引后，索引会自动重建。

安装

Edith 可在搭载 Apple Silicon、运行 macOS 13 或更高版本的 Mac 上使用。你还需要 Claude Code，可通过终端或 VS Code 扩展使用。

下载 Edith — 已由 Apple 签名并公证，因此打开时不会出现安全警告。打开 .dmg，将 Edith 拖入 “应用程序”，然后从那里打开。重启所有已经运行的 Claude Code 会话。

使用 Windows？Windows 版本位于 Edith-Windows。

在 VS Code 中

Edith 扩展 会在编辑器中将 Edith 注册为 MCP 服务，因此无需编写 mcp.json，也无需查找端口：

code --install-extension raghavchari.edith-second-brain

它会找到正在运行的应用，并为编辑器建立实时连接。如果编辑器尝试启动服务时 Edith 尚未运行，扩展会提示你打开它。源代码位于 vscode-extension/。

Edith 也已列入官方 MCP 注册表，名称为 io.github.Rchari1/edith-second-brain，因此能够读取注册表的客户端无需进行上述操作即可找到它。

或自行构建

需要 Node.js 22.12 或更高版本，以及用于原生数据库模块的 Xcode 命令行工具 （xcode-select --install）：

git clone https://github.com/Rchari1/Edith-SecondBrain.git
cd Edith-SecondBrain
npm install
npm run dist

.dmg 文件会生成在 release/ 中。自行构建的版本未经公证，但仍可打开，因为 macOS 信任你在自己的设备上编译的内容。

首次启动时会发生什么

Edith 会在 127.0.0.1:4319 上启动它的脑服务器，并自行连接到 Claude。无需账号，也无需 API 密钥：让 Claude “回顾我最近的会话，并保存任何值得保留的内容”，它就会自行填充这个脑。

除了自身文件夹之外，Edith 还会添加：

内容	位置
服务器条目，让 Claude 能访问这个脑	~/.claude.json，以及 Claude Desktop 的配置（如果你有的话）
一个会话启动钩子，告知 Claude 这个脑的存在	~/.claude/settings.json
/edith 命令	~/.claude/skills/edith
一些入门技能	~/.claude/skills/，可从 Skills 面板管理

你的笔记是纯 Markdown，存放在 ~/Library/Application Support/Edith/vault。

更新

cd Edith
git pull
npm install
npm run dist

退出 Edith，然后将新版拖到 Applications 中，替换旧版本。

故障排除

• Edith 打开后立即退出。 如果你是从 VS Code 终端启动的，请改从 Applications 或 Dock 打开它——VS Code 的终端会设置一个阻止应用启动的环境变量。
• Claude 始终不使用这个脑。 Edith 首次启动后，重启 Claude Code，然后在 Edith 中打开 Connection，确认会话预载提示已安装。

卸载

退出 Edith，并从 Applications 中删除它。然后移除它添加的内容：~/.claude.json 中 mcpServers 下的 edith 条目、~/.claude/settings.json 中命令以 # edith:session-context 结尾的钩子、~/.claude/skills/edith 文件夹，以及任何你不再需要的入门技能。你的笔记会继续保存在 ~/Library/Application Support/Edith 中，直到你也删除那个文件夹。

工作原理

阶段	发生的事情
监视	使用 chokidar 监视 ~/.claude/projects，等待会话进入静默状态
解析	将 JSONL 转换为规范的 Session，沿着 leafUuid 跳过已放弃的分支
存储	使用 Markdown + YAML frontmatter，并通过 SQLite FTS5 建立索引
提供服务	通过本地 HTTP 运行进程内 MCP 服务
点亮	每次工具调用都会直接向渲染器发送事件

Claude 可用的工具

工具	功能
search_brain	搜索笔记
read_note	完整读取一篇笔记
list_notes	查看这个脑中保存的内容
save_note	将一条见解写回
list_sessions	查看过去的 Claude 会话，以及哪些会话已被记录
read_session	阅读一份对话记录，其中的工具噪声已被剔除

后两个工具让 Claude 能够自行提炼内容，使用你的方案，而且无需任何密钥。

Edith 自身托管 MCP 服务，而不是通过派生进程启动它。这就是高亮能即时出现的原因：工具调用和发光效果发生在同一个时刻。

添加你自己的内容

侧边栏中的 添加内容 会打开导入对话框，提供两种模式：

模式	功能	费用
按原样保留	将文件或文本逐字存储为笔记	免费
提炼为概念	使用与会话相同的提取流程	一次 API 调用

重新导入文件会让现有笔记更加充实，而不是创建副本，因此反复同步文件夹是安全的。frontmatter 损坏的文件只会丢失元数据，不会丢失内容。

笔记格式

---
id: dynamic-port-binding
title: Dynamic Port Binding
type: concept
created: 2026-08-25
updated: 2026-08-25
origin: distilled
sources:
  - session: 11111111-2222-3333-4444-555555555555
    project: -Users-u-myapp
    at: 2026-08-25T10:00:00Z
links: [mcp-registration]
---
Bind the next free port and rewrite the MCP config to match.

每篇笔记都会记录其来源会话。从第一天起就会记录这些来源信息，因此追溯某个概念与相关对话的联系，只需查看即可，无需迁移。

值得了解的事项

从旧名称升级。 Edith 之前名为 SecondBrain。首次启动时，它会从旧位置复制现有知识库和设置，并将 ~/.claude.json 中过时的 secondbrain 条目替换为 edith，这样 Claude 就不会看到两套相同的工具。旧目录会保留不动，以作备用。

API 密钥无法访问 claude.ai 历史记录。 Messages API 是无状态的；没有可用于列出过往对话的端点。Edith 会读取 Claude Code 的本地记录。API 密钥仅用于提炼这些记录。

~/.claude/projects 下的大多数 .jsonl 文件都不是会话。 子 Agent 和工作流记录嵌套在会话目录下，数量通常约为真实会话的 9 倍。Edith 会根据路径结构进行分类，因此这些文件不会变成笔记。

记录是树状结构。 中断 Claude 会分叉历史记录，并在文件中留下废弃分支。解析器会从 last-prompt.leafUuid 回溯，因此只会提炼实际发生的内容。

你的配置是安全的。 注册时只会向 ~/.claude.json 合并一个键，以原子方式写入，并在首次修改前备份该文件。

开发

npm run dev        # run the app with hot reload
npm test           # 235 tests
npm run typecheck  # tsc --noEmit
npm run build      # bundle main, preload, renderer
npm run icon       # rebuild the icon set from assets/wordmark.svg
npm run release:mac  # signed and notarised, needs the certificate and the edith-notary profile

测试涵盖路径分类、分叉解析、对格式错误行的容忍度、知识库合并语义、配置写入安全性、通过 HTTP 运行的 MCP 客户端，以及端到端的完整流程（其中 API 调用使用模拟实现）。

v1 中不包含

导入 claude.ai 导出内容 - 会话层图形渲染 - 跨机器同步 - 语义搜索。搜索采用 SearchProvider 接口，因此以后添加混合检索只需修改一个文件。

许可证

Edith 根据 Functional Source License, Version 1.1, MIT Future License（FSL-1.1-MIT）以源代码可用形式发布。你可以阅读、使用、修改和分享它，但不得将其或实质上类似的产品或服务作为竞争性商业产品或服务提供。每个版本在发布两年后将改为采用 MIT 许可证。

© 2026 Raghav Chari 和 Kate Bonner。