> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/obsidian-wiki.md).

# 记忆

<figure><img src="/files/9df6dc15d69f44c242db184502ac06c7dbca72b5" alt=""><figcaption><p>在 Obsidian 中查看 OpenHuman 记忆的预览。来自各种来源（GMail、Slack、Whatsapp 等）的数据被组织成一棵记忆树。</p></figcaption></figure>

OpenHuman 的记忆不是黑盒。智能体进行推理所使用的同样分块会以纯 `.md` 文件写入你工作区内一个兼容 Obsidian 的 vault 中。你可以在 [Obsidian](https://obsidian.md)，浏览它、编辑它，并手动链接笔记，智能体就能看到你的修改。

这个设计直接受到 [Andrej Karpathy 的 obsidian-wiki 工作流](https://x.com/karpathy/status/2039805659525644595)：一个个人维基，你生活中每一件有趣的事最终都会变成一条可链接的笔记。

## 在本节中

记忆系统跨越多个层级。本页介绍磁盘上的 vault；本节其余部分会更深入：

| 页面                                                                             | 涵盖内容                                   |
| ------------------------------------------------------------------------------ | -------------------------------------- |
| [记忆树](/openhuman/zh/gong-neng/obsidian-wiki/memory-tree.md)                    | 生成该 vault 的层级摘要森林（L0 缓冲区 → 摘要 → 摘要精要）。 |
| [记忆来源与范围](/openhuman/zh/gong-neng/obsidian-wiki/sources.md)                    | 为记忆提供数据的连接器类型注册表，以及按智能体划分的来源白名单。       |
| [从集成自动获取](/openhuman/zh/gong-neng/obsidian-wiki/auto-fetch.md)                 | 每 20 分钟一次的同步循环，让记忆自动保持最新。              |
| [评分与排序](/openhuman/zh/gong-neng/obsidian-wiki/scoring.md)                      | 分块如何被接纳、补充实体信息，并建立索引以便检索回忆。            |
| [检索与回忆](/openhuman/zh/gong-neng/obsidian-wiki/retrieval.md)                    | 该 `memory_tree` 智能体用来读取记忆的工具模式。        |
| [记忆差异（Git 支持）](/openhuman/zh/gong-neng/obsidian-wiki/memory-diff.md)           | 一个记录记忆随时间变化的 git 日志：“自我上次查看后有什么新内容。”   |
| [agentmemory 后端](/openhuman/zh/gong-neng/obsidian-wiki/agentmemory-backend.md) | 可选共享 `agentmemory` 在其他编码智能体之间共享的存储。    |

## vault 的位置

```
<workspace>/
└── wiki/
 ├── summaries/ # 自动生成的来源 / 主题 / 全局摘要
 ├── notes/ # 你手写的笔记（自由格式）
 └── … # 每个已连接工具包对应一个文件夹
```

该 `summaries/` 文件夹按层级组织：全局树按日期，来源树按来源，主题树按实体。每个文件的 frontmatter 都携带来源信息（来源 ID、时间范围、作用域），这样智能体就能将任何说法追溯到生成它的分块。

## 打开 vault

在桌面应用中， **记忆** 选项卡有一个 **“在 Obsidian 中查看 vault”** 按钮。它使用一个 `obsidian://open?path=...` 深度链接，只有在文件夹被 **注册** 为 Obsidian 中的 vault 之后才会生效。该深度链接不能替你完成注册。所以第一次需要：

1. 点击 **在 Obsidian 中查看 vault**。如果该文件夹还不是已注册的 vault，OpenHuman 会显示内联指引，而不是静默失败。
2. 在 Obsidian 中，选择 **“将文件夹作为 vault 打开”** 并选择显示的路径。你只需要这样做一次。
3. 点击 **在 Obsidian 中查看 vault** 再次打开；现在它会直接进入 vault。

如果 Obsidian 安装在非标准位置（Flatpak/Snap/便携版），请使用 **仍然在 Obsidian 中打开**，或者将 OpenHuman 指向其位于以下位置的配置文件夹： **高级** 这样检测才能生效。没有安装 Obsidian？指引会链接到下载页面，并且 **显示文件夹** 始终会在你的操作系统文件管理器中打开 vault 目录。

你也可以在任何编辑器中打开该文件夹，它只是 Markdown。文件之间的链接使用标准的 `[[wiki-link]]` 语法，因此 Obsidian 的图谱视图、反向链接和标签浏览器都能直接使用。

## 手动编辑笔记

你放入 `wiki/notes/` 都可以被摄取。处理 Gmail 和 Slack 的同一条流水线也会读取你手写的笔记，对它们分块、评分，并将它们与其他内容一起折叠进主题树和全局树。

这意味着你可以：

* 把会议记录放到 `wiki/notes/2026-05-08-board-call.md` ，智能体明天就会知道上下文。
* 为每个项目、每个人、每个股票代码维护一个文件，主题树会把你的手动笔记视为又一个来源。
* 批量导入现有的 Obsidian vault：把 `.md` 文件放进去并触发摄取。

## 这为什么重要

你无法信任你无法读取的记忆。大多数“AI 记忆”系统把状态隐藏在不透明的嵌入中；OpenHuman 的 vault 则相反，智能体的记忆就是 **字面上的** 你拥有的一个 Markdown 文件夹。如果智能体出错了，你可以找到文件、修正它，下一次检索就会正确。

这也是最干净的导出方式：明天停止使用 OpenHuman，你仍然会保留一个完整的个人维基。

## 另见

* [记忆树](/openhuman/zh/gong-neng/obsidian-wiki/memory-tree.md)。生成 vault 的流水线。
* [从集成自动获取](/openhuman/zh/gong-neng/obsidian-wiki/auto-fetch.md)。vault 如何自行增长。