dsh-siyuan：接入思源筆記的 17 個工具

前言¶

DeepSeek Harness（DSH）通過插件機制擴展功能，接入本地知識庫是常見需求。dsh-siyuan 插件解決了將思源筆記接入 DSH 的問題，允許模型直接檢索、讀取和寫入用戶的筆記庫。

插件介紹¶

插件名稱爲 yoursc/dsh-siyuan，作者爲 yoursc，分類爲知識庫和 Web UI，許可證爲 MIT。

該插件的核心價值在於提供 17 個 siyuan_* 工具（涵蓋檢索、讀取、寫入、移動、刪除、日記、屬性），並附帶一個獨立的設置頁，用於管理連接、權限和默認筆記本。

安裝¶

使用以下命令安裝插件：

dsh plugin --profile web add @yoursc/dsh-siyuan

配置¶

安裝後，在 DSH 設置頁找到“思源筆記”卡片。該設置頁包含四張獨立卡片，各自保存：

1. 連接：配置思源地址（默認 http://127.0.0.1:6806）。
2. API token：在思源設置 -> 關於 -> API token 複製並粘貼。
3. 默認筆記本：選擇默認使用的筆記本。
4. 工具開關：按只讀、寫入、日記、危險四組管理工具權限。

API token 存儲在宿主的憑據庫中，設置頁不會回顯其值。

使用示例¶

1. 在思源設置中複製 API token 並在插件設置頁保存。
2. 使用 siyuan_search 搜索筆記。
3. 使用 siyuan_daily_note 創建或讀取日記。
4. 使用 siyuan_create_doc 創建新文檔。
5. 在設置頁點擊“測試連接”驗證配置。

注意事項¶

• 非官方插件：與思源筆記項目無隸屬關係。
• 版本兼容：DSH 0.1.7 用戶請使用 0.0.3 及以上版本。
• 工具命名：工具名固定爲 siyuan_*，同名工具會互相遮蔽。
• SQL 限制：SQL 工具只接受單條 SELECT 語句。
• 操作複覈：刪除與更新操作會進行復核以確保生效。
• 權限默認：默認只開啓只讀與日記兩組，寫入與危險組默認關閉。

結尾¶

該插件爲 DSH 用戶提供了標準化的知識庫接入方案，通過獨立的設置頁和細粒度的權限控制，降低了接入本地筆記系統的門檻。更多細節請查看 GitHub 倉庫 或 插件目錄。