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 仓库 或 插件目录。