前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。思源筆記提供了官方的 MCP 端點，但 DSH 客戶端與思源端點之間需要橋接。該插件同時作爲 Codex 橋接和 DSH 插件存在：它將本地思源 MCP 端點接入，將官方工具註冊爲 mcp__siyuan__*，並添加了 siyuan 技能與 ai 工具組。
安裝與啓用¶
插件可以通過 DSH 桌面端或命令行安裝。
-
桌面端
在 DSH 插件市場搜索siyuan-codex-bridge（分類爲 Memory）並安裝。 -
命令行
通過 GitHub 源或 npm 源安裝：
dsh plugin --profile web add github:greyoak111/siyuan-codex-bridge
或使用 npm 源（預構建）：
dsh plugin --profile web add dsh-siyuan-notes
配置與權限¶
安裝完成後，需在 ~/.config/dsh-siyuan/config.json 中進行配置。
- 啓動控制
默認情況下，DSH 不會自動啓動思源應用。若需在調用時自動拉起思源，添加以下配置：
{
"launchOnCall": true
}
啓動命令默認爲 /Applications/SiYuan.app/Contents/MacOS/SiYuan，可通過環境變量 SIYUAN_APP 或 SIYUAN_LAUNCH_COMMAND 自定義。
- 操作級別
插件支持三種操作級別，每次tools/call時重新校驗，無需重啓。
-readonly：僅搜索與讀取（文檔、塊、大綱、反鏈等）。
-authoring（默認）：在只讀基礎上允許創建、插入、更新塊、設置屬性。
-full：官方全部能力（刪除、移動、同步、SQL、導入導出等）。
在 config.json 中設置 profile：
{
"profile": "readonly"
}
- Token 解析
插件按以下順序解析 API Token： - 環境變量
SIYUAN_API_TOKEN ~/.config/dsh-siyuan/config.json中的配置- 思源工作區配置（
~/.config/siyuan/workspace.json讀取api.token）
核心功能¶
插件主要包含以下能力：
-
MCP 工具註冊
將思源官方的 29 個能力組工具註冊爲mcp__siyuan__*前綴。 -
技能
添加siyuan技能，支持在對話中通過自然語言操作思源權限（如$siyuan-readonly切換隻讀）。 -
AI 工具
追加ai工具組，將思源內置 AI 接入 MCP。包含以下 action：
-chat：普通問答
-action：執行編輯器動作
-editor：編輯器式對話
-agent：啓動內置 agent 回合（支持流式與審批）
-status/confirm/answer/permission：讀取回合、批准、回答反問、設置權限 -
獨立代理
DSH 走 Node 代理（bridge/），Codex 走 Python 代理（bin/），兩者策略與 Token 獨立。
狀態與維護¶
插件目錄不會被寫入，審計日誌位於 ~/.config/dsh-siyuan/audit.jsonl。
運行以下命令進行診斷（不打印 Token）：
node node_modules/.bin/dsh-siyuan-bridge --doctor
需確保環境滿足 Node 版本要求（Node >= 22）。
