隨着 DeepSeek Harness (DSH) 生態的發展，讓智能體介入本地知識庫管理成爲剛需。但在 DSH 環境中直接操作文件系統存在風險，誤寫或誤刪可能導致數據丟失。dsh-obsidian-channel 插件旨在解決這一痛點，它爲 DSH Agent 提供了一個受控的通道，既能讀取和寫入本地 Obsidian Vault，又能確保所有寫入操作經過用戶審批，並提供一鍵回滾機制。
這是一個由 ShengenWu 維護的 DSH 插件，屬於「記憶」分類。它的核心功能是打通 DeepSeek Harness 與本地 Obsidian Vault 的通道，允許 DSH Agent 讀取和寫入本地筆記，但所有寫入操作在執行前需要用戶批准，且支持對任何變更進行一鍵回滾。
核心功能¶
- 安全寫入與審批：Agent 對 Vault 的寫入操作（創建、更新、追加、刪除）均需用戶在執行前批准，默認策略爲「每次詢問」。
- 變更歷史與回滾：所有經過 Agent 的變更都會被記錄，用戶可在設置中查看變更前後內容，並執行一鍵回滾。回滾本身也是一種 journaled 變更。
- Vault 主頁：在側邊欄點擊 📓 按鈕進入 Vault 主頁，提供 Continue（最近筆記）和 Vault changes（變更日誌）等組件。
- 智能助手入口：從主頁點擊筆記或快捷方式（例如「寫今日日記」），Agent 會爲此條目開啓一個新的 Vault 會話，並將文本放入編輯器，等待用戶確認發送。
- 路徑與配置管理：支持原生文件夾選擇器綁定 Vault，每日筆記路徑優先讀取 Obsidian 的
.obsidian/daily-notes.json配置，支持自定義忽略目錄。 - 讀寫隔離：插件會阻止原生直接寫入/編輯 Vault，強制所有變更通過
obsidian_*工具進行，從而保證變更被記錄在 Journal 中。 - 數據操作能力：Agent 支持對筆記進行搜索、列表、結構化整理、處理反向鏈接以及執行 journaled move（重寫 Wikilinks）。
安裝與啓用¶
安裝此插件需要滿足環境要求：安裝並運行 dsh web (版本 0.1.0-rc.6)，以及 Node.js 版本大於等於 20。
在終端中執行以下命令進行安裝：
dsh plugin --profile web add github:ShengenWu/dsh-obsidian-channel
安裝完成後，重啓 dsh web 並訪問 http://127.0.0.1:3080 即可使用。
典型用法¶
- 綁定 Vault：首次使用時，點擊側邊欄的 📓 按鈕，在彈出的界面中粘貼本地 Vault 的絕對路徑（如
/Users/you/Notes），點擊綁定。 - 開啓會話：在 Vault 主頁，點擊任意筆記或快捷方式（例如「寫今日日記」）。Agent 會爲此條目開啓一個新的 Vault 會話，並將文本放入編輯器，但不會自動發送。
- 確認與執行：在編輯器中檢查內容無誤後，發送給 Agent。Agent 執行寫入前會請求批准。
- 管理變更：在設置頁的「Obsidian」選項卡中，可以查看變更歷史（Before/After），並點擊回滾按鈕撤銷上一次變更。
- 配置審批策略：在設置中，可以將審批策略切換爲「一次任務詢問一次」或「從不詢問」（不推薦），以平衡安全性與效率。
適用場景與注意¶
- 適用場景：適合需要 DeepSeek Agent 輔助整理、重寫或維護本地 Obsidian 知識庫的用戶。
- 環境要求：Obsidian 應用程序本身無需運行，只需文件系統存在即可。
- 權限風險：此插件以當前 dsh 進程的權限運行。雖然插件攔截了原生寫入，但直接使用 Bash 命令仍可能繞過 Journal 機制直接修改文件。建議在處理敏感數據時保持警惕。
- 已知限制：目前插件暫不支持模板、週報回顧以及
[[自動補全功能。
總結¶
該插件通過提供安全的寫入通道和回滾機制，解決了智能體操作本地文件的痛點。你可以通過社區目錄查看更多插件，或在 GitHub 上查看源碼與反饋。
