前言¶
在 DeepSeek Harness(DSH)里和 Agent 对话,常会产出 .md 交付文件。要落到自己部署的思源笔记(SiYuan),惯常做法是下载、复制粘贴或切窗口导入,步骤多且容易打断流程。下面介绍社区插件 dsh-siyuan-sender(思源笔记直送):在交付卡片和预览工具栏上增加发送入口,也可让模型通过工具 siyuan_send 代发,正文落到你指定的笔记本,且不覆盖已有文档。
这是什么¶
dsh-siyuan-sender 由维护者 baby7 发布,在 DSH 插件目录中归类为「联网工具」。它只做一件事:把对话里生成的 Markdown 文档,经思源内核 API 写入你自建的思源实例。README 写明已在 SiYuan 3.8.8(Docker 部署、外网访问)实测通过。数据走本机配置与凭据,文档发往你填写的思源地址,不由插件向其他第三方上传内容。
- 目录页:https://www.skillhub.cn/plugins/baby7/dsh-siyuan-sender
- 源码与说明:https://github.com/baby7/dsh-siyuan-sender
- 当前包版本(
package.json):1.0.1,许可证 MIT
核心功能¶
按 README 归纳,能力分三块:
-
界面按钮
- 每份.md交付文件卡片右侧有「思源」按钮,点按即发送。
- 右侧边栏阅读.md时,预览工具栏同样有发送入口。 -
Agent 工具
- 可对模型说「把 xxx.md 发到思源」,由 Agent 调用siyuan_send。 -
行为约束
- 点击后有成功或失败提示。
- 重名不覆盖:自动在标题后追加时间戳。
- 标题取自正文第一个#标题;若无则用文件名。
- 仅支持扩展名白名单:.md/.markdown/.mdown/.mdx;图片不会一并上传,其它格式请用思源自带导入。
命名示例(来自 README):
/DSH收件箱/季度报告
/DSH收件箱/季度报告 2026-10-28 13:07
安装与启用¶
推荐从 Releases 下载最新 .tgz 后本地安装:
dsh plugin --profile desktop add ./dsh-siyuan-sender-1.0.1.tgz
也可用 Release 直链(示例为 v1.0.1):
dsh plugin --profile desktop add https://github.com/baby7/dsh-siyuan-sender/releases/download/v1.0.1/dsh-siyuan-sender-1.0.1.tgz
或跟踪仓库主分支(不锁版本,随上游变化):
dsh plugin --profile desktop add github:baby7/dsh-siyuan-sender
desktop 是 DSH 桌面端默认 profile 名;若你使用其它 profile,将 --profile desktop 换成实际名称即可。装好后刷新页面。
插件以当前 DSH 进程权限运行,安装前建议浏览仓库源码与 MIT 许可证,确认与自有思源的网络与合规要求一致。
配置¶
需准备三项:
| 配置项 | 说明 |
|---|---|
| 思源地址 | 到端口为止,如 http://192.168.3.11:6806,不要加 /api |
| API token | 思源「设置 → 关于 → API token」 |
| 目标笔记本 | 笔记本名称或 ID,建议专建「DSH收件箱」 |
可选项:父文档路径(笔记本内位置,/ 表示根目录);私有 HTTPS 时可勾选「允许自签名证书」。README 说明 Token 只写入本机凭据库,不进设置文件、也不发给浏览器。超时可在配置中调整 timeoutMs(最高 120000)。
在 DSH 设置 → 思源笔记直送 中填写地址、Token、笔记本,点「测试连接」确认无误。
典型用法¶
- 对话生成
.md后,在交付卡片右侧点「思源」,或在右侧预览工具栏点「发送到思源」。成功会提示落入路径。 - 或用自然语言让 Agent 执行,例如:
把 report.md 发送到思源
常见问题¶
README 故障表摘要:
| 现象 | 处理 |
|---|---|
| 点按钮没反应 | 重装插件后刷新页面 |
| Token 无效 | 从思源「设置 → 关于」重新复制 |
| 地址无响应 | 确认是内核地址,勿带 /api |
| 找不到笔记本 | 按提示中的实际笔记本名填写 |
| 证书校验失败 | 勾选「允许自签名证书」 |
| 超时 | 增大 timeoutMs(最高 120000) |
结尾¶
若你已经在 DSH 里稳定产出 Markdown,又用自建思源做知识库,dsh-siyuan-sender 把「生成 → 入库」收成一两次点击或一句指令,并避免重名覆盖。细节与设计说明见仓库 设计说明.md;安装包与版本见 Releases 与 SkillHub 目录页。