> 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/zhi-nan/guides/connect-obsidian.md).

# 将 OpenHuman 连接到 Obsidian

**目标：** 在……中以纯 Markdown 形式浏览和编辑助手的记忆 [Obsidian](https://obsidian.md)，并让你的编辑回流到代理所知道的内容中。

OpenHuman 的记忆并不是一个黑箱：代理所推理的相同片段会被写成 `.md` 位于工作区内、与 Obsidian 兼容的保险库中的文件。参见 [记忆](/openhuman/zh/gong-neng/obsidian-wiki.md) 以了解完整情况；本指南只会帮你连接上。

***

## 前提条件

* [Obsidian](https://obsidian.md) 已安装（免费）。
* 已设置好 OpenHuman，且至少连接了一个来源，因此有可查看的记忆。参见 [创建我的个人 AI 助手](/openhuman/zh/zhi-nan/guides/personal-assistant.md).

## 隐私影响

* 该保险库是 **局部**。它位于你的工作区文件夹（`.../wiki/`）中，存放在你的设备上。在 Obsidian 中打开它不会上传任何内容。
* Obsidian 直接读取本地文件；浏览保险库时不会涉及 OpenHuman 账户或后端。
* 你输入到保险库中的任何内容，都会成为代理在下次摄取时可读取内容的一部分。把它当作写入助手的记忆。

***

## 步骤

### 1. 从 OpenHuman 打开保险库

前往 **记忆** 选项卡，然后点击 **在 Obsidian 中查看 vault**。这会打开你的 `.../wiki/` 文件夹，并在 Obsidian 中将其作为保险库打开。

如果你更愿意手动打开，请将 Obsidian 指向 `wiki/` 数据文件夹内的文件夹：

| 平台            | 保险库路径                              |
| ------------- | ---------------------------------- |
| macOS / Linux | `~/.openhuman/…/wiki/`             |
| Windows       | `%USERPROFILE%\.openhuman\…\wiki\` |

### 2. 浏览结构

在保险库中，你会找到按来源、主题和日期组织的自动生成摘要，以及一个用于你自己自由格式笔记的地方。每个摘要文件的 frontmatter 中都包含来源信息，因此你可以追溯某个说法的来源。参见 [记忆树](/openhuman/zh/gong-neng/obsidian-wiki/memory-tree.md).

### 3. 添加你自己的笔记和链接

* 放入你自己的 Markdown 笔记。
* 构建 `[[维基链接]]` 在笔记之间手动建立联系。
* 更正或批注代理总结的任何内容。

### 4. 让代理接收你的编辑

你的更改会在下一次摄取时被读取，因此你无需导入任何内容。代理会看到你添加的笔记和建立的链接。

***

## 成功检查

* [ ] Obsidian 会打开保险库并显示 OpenHuman 的摘要文件。
* [ ] 你可以打开一份摘要，并在其 frontmatter 中看到来源/时间溯源信息。
* [ ] 你手动添加的笔记在 OpenHuman 运行后仍会保留（不会被覆盖），代理可以在之后的聊天中引用它。

## 常见故障

| 症状                        | 原因                            | 修复方法                                                                                       |
| ------------------------- | ----------------------------- | ------------------------------------------------------------------------------------------ |
| 保险库已打开，但几乎是空的             | 尚未摄取任何来源                      | 连接一个来源并等待一次自动获取周期（约 20 分钟）；参见 [个人助手指南](/openhuman/zh/zhi-nan/guides/personal-assistant.md) |
| “在 Obsidian 中查看保险库”没有任何反应 | 未安装 Obsidian，或者操作系统无法将该文件夹交给它 | 安装 Obsidian，然后打开 `wiki/` 文件夹（上面的路径）                                                        |
| 你的编辑似乎未被采纳                | 下一次摄取尚未运行，或者你是在自动管理的摘要块内进行了编辑 | 等一个周期；把你自己的内容放在自己的笔记里，而不是放在生成的块里                                                           |

## 恢复

* 保险库只是一些文件。如果 Obsidian 显示出异常内容，关闭它并重新打开该文件夹即可。浏览不会弄坏 OpenHuman。
* 如果你删除了想保留的笔记，记忆数据库仍然保存着底层片段；摘要可以重新生成。

## 另请参阅

* [记忆](/openhuman/zh/gong-neng/obsidian-wiki.md)：保险库是如何生成和组织的。
* [保护敏感数据的隐私](/openhuman/zh/zhi-nan/guides/privacy-sensitive-data.md)：为什么保险库是本地的才是关键所在。