WiseMindAI Sync（Obsidian 插件）
在 Obsidian 与本机 WiseMindAI 之间同步 Markdown：可导入笔记到 WiseMindAI，也可把 WiseMindAI 里的内容写回 Obsidian。数据走本地 API，不直连 WiseMindAI 数据库。
使用前
- 安装并启动 WiseMindAI，开启本地 API（默认
http://127.0.0.1:38221）。 - 在 Obsidian 安装并启用 WiseMindAI Sync；若改过 API 端口，在插件设置里改地址。
插件安装
方式一：Obsidian 官方安装（推荐）
在 Obsidian 中关闭「安全模式」，打开 设置 → 第三方插件 → 社区插件，搜索 WiseMindAI Sync 并安装；也可点击下方按钮在浏览器打开社区插件页，使用页面上的 Add to Obsidian。
打开 Obsidian 插件页方式二：手动安装（GitHub）
从 GitHub Releases 下载压缩包，解压后把插件文件复制到当前仓库的插件目录。点击下方按钮打开发布页。
打开 GitHub Releases- 解压后确认包含
main.js、manifest.json、styles.css（以及发布包中的其他文件，若有）。 - 在仓库中创建目录：
.obsidian/plugins/wisemindai-sync/，将上述文件放入（目录名须与manifest.json里的id一致）。 - 回到 Obsidian：设置 → 第三方插件，启用 WiseMindAI Sync。
打开同步控制台
左侧栏 WiseMindAI Sync 图标、命令面板 WiseMindAI Sync: 打开同步控制台，或底部状态栏入口。
同步操作
Obsidian → WiseMindAI
- 方向选
Obsidian -> WiseMindAI。 - 左侧选笔记/文件夹，右侧选 WiseMindAI 中的保存位置（笔记、文档或知识库）。
- 需要时勾选
覆盖已有，点执行同步。
默认知识库名 Obsidian 导入 可在设置里改。
WiseMindAI → Obsidian
- 方向选
WiseMindAI -> Obsidian。 - 选来源类型（文档 / 笔记 / 知识库）及要同步的内容。
- 选 Obsidian 目标文件夹；可选
包含文件夹保留层级、覆盖已有。 - 点
执行同步。
默认写入根目录名为 WiseMindAI（设置里可改）。
其他功能
- 右键：文件/文件夹/当前笔记/选中文本可快捷发送到 WiseMindAI（目标与重复策略跟设置一致）。
- 同步方案：常用范围可保存，下次一键执行。
- 同步历史：查看每次结果与统计。
重复内容：策略可为「更新」「跳过」「创建副本」；勾选 覆盖已有 时更偏向更新。插件会写入来源标记便于后续识别。
插件设置（摘要）
| 项 | 默认 |
|---|---|
| 本地接口 | http://127.0.0.1:38221 |
| Obsidian 写入根目录 | WiseMindAI |
| 默认知识库名 | Obsidian 导入 |
| 重复处理 | 可在设置中选 |
设置里可用 测试 WiseMindAI 连接 检查是否连通。
隐私说明
仅连接本机 127.0.0.1，不上传第三方服务器。
常见问题
连不上 WiseMindAI
确认应用已开、本地 API 已开，地址与端口与设置一致。
Obsidian 里缺文件
只处理 Markdown；会忽略 .obsidian、回收站、隐藏目录及过大文件。
WiseMindAI 里缺条目
主要同步能转成 Markdown 的笔记、文档与知识库文档；无正文的项可能不展示。
文件名会变吗
导入 WiseMindAI 不改 Obsidian 原文件名；写回 Obsidian 时按 WiseMindAI 内容标题生成 .md 文件名。