dsh-siyuan
把 思源笔记（SiYuan）接入 DeepSeek Harness：让模型能检索、读取、
写入你的笔记库，并提供一个独立设置页管理连接与权限。
- 模型侧：17 个
siyuan_* 工具，按只读 / 写入 / 日记 / 危险四组开关控制，默认只开安全的两组。
- 设置页：设置 → 思源笔记，填写思源地址与 API token、选择默认笔记本、按需打开工具分组。
- API token 存在宿主的凭据库里，设置页永不回显它的值。
想改这个插件、或了解它是怎么实现的，请读 docs/DEV.md。
安装
dsh plugin --profile web add @yoursc/dsh-siyuan
安装后必须重启 dsh web 才会加载插件：
docker restart deepseek-harness # 或在 1Panel 里重启对应容器
插件是在 profile 组合树装载时注册的，新增/删除插件条目后重启是必需的。
配置
打开 设置 → 思源笔记，依次完成：
- 思源地址：默认
http://127.0.0.1:6806。注意这是以 dsh 进程所在机器的视角去访问的——
思源和 dsh 不在同一台机器时，要填对方能访问到的地址。
- API token：在思源 → 设置 → 关于 → API token 里复制，粘贴保存即可。保存后写入宿主凭据库；
页面只显示「已配置 / 来源 / 可写」。如果 token 来自只读来源（例如启动 dsh 时设的环境变量），
输入框会置灰并标注"只读"，需要去掉那个环境变量后重启才能在页面里改。
- 默认笔记本：点「加载笔记本」拉取列表后选择。写入、日记、按路径列文档默认用它；
工具调用里也可以显式传
notebook 覆盖。
- 工具分组：按需勾选，点「保存设置」即时生效（不需要重启）。
- 测试连接：逐项探测系统版本、笔记本列表、SQL 查询，逐条显示成功或思源返回的错误原因。
工具分组
| 分组 | 默认 | 工具 |
|---|
read 只读 | 开 | siyuan_list_notebooks、siyuan_search、siyuan_sql、siyuan_read_doc、siyuan_list_docs、siyuan_get_child_blocks、siyuan_get_block_attrs |
write 写入 | 关 | siyuan_create_doc、siyuan_append_block、siyuan_insert_block、siyuan_update_block、siyuan_set_block_attrs、siyuan_move_doc、siyuan_rename_doc |
daily 日记 | 开 | siyuan_daily_note（读写指定日期的日记，不存在时按笔记本的 dailyNoteSavePath 创建） |
danger 危险 | 关 | siyuan_delete_block（内容块）、siyuan_remove_doc（整篇文档）——都必须显式传 confirm=true |
写入与危险组默认关闭，是因为这两组会真实修改你的笔记库。建议先只开 read 用一段时间，
确认模型检索/读取的表现符合预期，再逐组打开。
使用时的几个注意点
- 删除可以先放心试：
siyuan_remove_doc 删掉的文档能在思源自己的回收站里找回。
- 改块内容一次只能一段：工具在传入多段 Markdown 时会明确提示"只写入了第一段"，
需要多段请让模型改用
siyuan_insert_block 逐段插入。
- 删除与更新都会复核：思源有时会"返回成功但没真的生效"（例如删除是异步落库）。
本插件会复查并在确实没生效时报错，不会给你一个假的成功。删除复核最长约 6 秒，
慢的时候成功信息里会注明实际耗时。
- 笔记本必须在思源里打开：往已关闭的笔记本写入会直接被拒绝并提示先打开它。
- 工具名固定为
siyuan_*：如果同时装了另一个也用这个前缀的思源插件，同名工具会互相遮蔽。
已知限制
- 一次工具调用只处理一个文档/块；批量操作由模型多次调用完成。
- 读取类工具的输出没有额外大小上限，长文档会占用模型上下文。
- 删除没有二次回收确认：思源回收站能找回被删文档，插件不再拦截一次。
- SQL 工具只接受单条 SELECT；语句中间出现分号会被拒绝（包括字符串字面量里的分号）。
免责声明
非官方插件，与思源笔记（SiYuan）项目无隶属关系。写入与删除类工具会真实修改笔记库，
因此默认关闭；请在设置页按需开启，并留意你笔记库自身的整理规范。
License
MIT
