@yoursc/dsh-siyuan

配置

打开 设置 → 思源笔记，依次完成：

1. 思源地址：默认 http://127.0.0.1:6806。注意这是以 dsh 进程所在机器的视角去访问的—— 思源和 dsh 不在同一台机器时，要填对方能访问到的地址。
2. API token：在思源 → 设置 → 关于 → API token 里复制，粘贴保存即可。保存后写入宿主凭据库； 页面只显示「已配置 / 来源 / 可写」。如果 token 来自只读来源（例如启动 dsh 时设的环境变量）， 输入框会置灰并标注"只读"，需要去掉那个环境变量后重启才能在页面里改。
3. 默认笔记本：点「加载笔记本」拉取列表后选择。写入、日记、按路径列文档默认用它； 工具调用里也可以显式传 notebook 覆盖。
4. 工具分组：按需勾选，点「保存设置」即时生效（不需要重启）。
5. 测试连接：逐项探测系统版本、笔记本列表、SQL 查询，逐条显示成功或思源返回的错误原因。

使用时的几个注意点

• 删除可以先放心试：siyuan_remove_doc 删掉的文档能在思源自己的回收站里找回。
• 改块内容一次只能一段：工具在传入多段 Markdown 时会明确提示"只写入了第一段"， 需要多段请让模型改用 siyuan_insert_block 逐段插入。
• 删除与更新都会复核：思源有时会"返回成功但没真的生效"（例如删除是异步落库）。 本插件会复查并在确实没生效时报错，不会给你一个假的成功。删除复核最长约 6 秒， 慢的时候成功信息里会注明实际耗时。
• 笔记本必须在思源里打开：往已关闭的笔记本写入会直接被拒绝并提示先打开它。
• 工具名固定为 siyuan_*：如果同时装了另一个也用这个前缀的思源插件，同名工具会互相遮蔽。