前言¶
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）。
