WiseMindAI Obsidian

插件是什么

WiseMindAI Obsidian 是 WiseMindAI 的 Obsidian 桌面插件，用来连接本机正在运行的 WiseMindAI，让 Obsidian 和 WiseMindAI 之间可以互相同步 Markdown 内容。

它主要支持两类使用场景：

• 把 Obsidian 笔记导入 WiseMindAI，继续用 WiseMindAI 做 AI 对话、知识库整理、文档管理和资料处理。
• 把 WiseMindAI 里的笔记、文档、知识库文档同步回 Obsidian，继续用 Obsidian 管理和阅读。

插件只通过 WiseMindAI 本地接口同步数据，不会直接读写 WiseMindAI 数据库。

适合谁使用

• 平时用 Obsidian 写长期笔记，也用 WiseMindAI 做资料整理的人。
• 想把 Obsidian 里的 Markdown 批量导入 WiseMindAI 的人。
• 想把 WiseMindAI 里整理好的笔记、文档或知识库内容同步回 Obsidian 的人。
• 不想在两个工具之间反复复制、粘贴、重建文件夹的人。

使用前准备

1. 安装并启动 WiseMindAI 桌面应用。
2. 在 WiseMindAI 中开启本地接口服务。
3. 默认接口地址为 http://127.0.0.1:38221。
4. 在 Obsidian 中安装并启用 WiseMindAI Obsidian 插件。

如果你改过 WiseMindAI 本地接口端口，需要在插件设置里把接口地址改成一致。

安装方式

当前可使用手动安装方式：

1. 在项目根目录构建插件：

npm run build:obsidian

2. 在 Obsidian 仓库中创建插件目录：

.obsidian/plugins/wisemindai-obsidian/

3. 复制以下文件到该目录：

packages/wisemindai-obsidian/main.js
packages/wisemindai-obsidian/manifest.json
packages/wisemindai-obsidian/styles.css

4. 回到 Obsidian，打开第三方插件设置，启用 WiseMindAI Obsidian。

打开同步控制台

启用插件后，可以通过以下方式打开同步控制台：

• 点击 Obsidian 左侧栏的 WiseMindAI 图标。
• 在命令面板执行 WiseMindAI: 打开同步控制台。
• 点击底部状态栏里的 WiseMindAI 状态。

同步控制台会展示：

• WiseMindAI 连接状态。
• 当前 Obsidian 仓库中的 Markdown 笔记。
• WiseMindAI 笔记和笔记文件夹。
• WiseMindAI 文档和文档文件夹。
• WiseMindAI 知识库和知识库文档。
• 当前选中的同步方向、同步范围和目标位置。

控制台顶部还提供 API 设置、使用教程、打开官网、同步历史 等入口。

把 Obsidian 导入 WiseMindAI

在同步控制台中：

1. 选择同步方向 Obsidian -> WiseMindAI。
2. 在左侧选择要导入的 Obsidian Markdown 笔记或文件夹。
3. 在右侧选择 WiseMindAI 保存位置，可以保存为笔记、文档或知识库内容。
4. 如需覆盖已有同名内容，勾选 覆盖已有。
5. 点击 执行同步。

默认设置会把 Obsidian 内容导入为 WiseMindAI 笔记和知识库内容。默认知识库名称是 Obsidian 导入，可在插件设置中修改。

从 WiseMindAI 同步到 Obsidian

在同步控制台中：

1. 选择同步方向 WiseMindAI -> Obsidian。
2. 选择 WiseMindAI 来源类型：文档、笔记或知识库。
3. 勾选要同步的内容，可以按文件夹、知识库或单条内容选择。
4. 选择一个或多个 Obsidian 写入文件夹，也可以新建目标文件夹。
5. 如需保留 WiseMindAI 的文件夹层级，勾选 包含文件夹。
6. 如需覆盖已有内容，勾选 覆盖已有。
7. 点击 执行同步。

默认写入根目录是：

WiseMindAI

勾选 包含文件夹 后，插件会尽量保留 WiseMindAI 里的文件夹结构。知识库内容会按知识库名称归类。

右键快捷入口

插件在 Obsidian 里提供了快捷发送入口：

• 在文件列表右键 Markdown 文件，可以发送到 WiseMindAI。
• 可以指定发送为 WiseMindAI 笔记、文档或知识库内容。
• 在文件夹上右键，可以发送整个文件夹里的 Markdown 文件。
• 在编辑器中右键，可以发送当前笔记。
• 选中文本后右键，可以只把选中文本发送为 WiseMindAI 笔记摘录。

快捷入口会使用插件设置里的默认保存目标和重复处理策略。

同步方案

如果你经常同步固定范围，可以把当前选择保存为同步方案。

同步方案会保存：

• 同步方向。
• 选中的 Obsidian 文件或文件夹。
• 选中的 WiseMindAI 内容或分组。
• 保存目标。
• 目标文件夹。

下次打开同步控制台后，可以直接选择方案并执行同步。

同步历史

同步历史会记录每次同步的结果，包括：

• 同步时间。
• 同步方向。
• 来源文件夹。
• 目标位置。
• 同步文件名称。
• 新建、更新、跳过和失败数量。

你可以在同步控制台点击 同步历史 查看，也可以搜索文件、文件夹或目标位置。

重复内容处理

插件支持三种重复处理方式：

• 更新：发现同来源或同名内容时更新原内容。
• 跳过：发现已有内容时不修改。
• 创建副本：不覆盖旧内容，尽量创建新文件。

同步控制台里的 覆盖已有 会影响本次执行：

• 勾选后使用更新策略。
• 不勾选时尽量创建副本，减少误覆盖。

插件会在同步内容中写入来源标记，用来识别后续同步关系。

插件设置

在 Obsidian 插件设置中可以配置：

• WiseMindAI 本地接口地址：默认 http://127.0.0.1:38221。
• Obsidian 写入根目录：默认 WiseMindAI。
• 默认知识库名称：默认 Obsidian 导入。
• 重复内容处理：可选跳过、更新、创建副本。
• 测试 WiseMindAI 连接：检查 Obsidian 是否能连上 WiseMindAI。

常见问题

Obsidian 提示无法连接 WiseMindAI

先确认 WiseMindAI 已启动，并且本地接口服务已开启。默认地址是：

http://127.0.0.1:38221

如果你改过端口，请在插件设置里同步修改。

为什么有些 Obsidian 文件没有出现在列表里

插件只扫描 Markdown 文件。默认会忽略 .obsidian、回收站和隐藏目录，并跳过过大的文件。

为什么有些 WiseMindAI 内容没有出现在同步列表里

当前插件主要同步可转成 Markdown 的笔记、文档和知识库文档。如果内容没有可读正文，可能不会作为可同步内容展示。

插件会把数据上传到服务器吗

不会。插件连接的是本机 WiseMindAI 本地接口，Obsidian 和 WiseMindAI 之间的数据流转发生在本机。

插件会改我的 Obsidian 文件名吗

从 Obsidian 导入 WiseMindAI 时，不会修改原 Obsidian 文件名。从 WiseMindAI 同步回 Obsidian 时，会按 WiseMindAI 内容标题创建 Markdown 文件。