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 檔名。