dsh-siyuan-sender:把 DSH 里的 Markdown 直送进思源笔记

前言

在 DeepSeek Harness(DSH)里和 Agent 对话,常会产出 .md 交付文件。要落到自己部署的思源笔记(SiYuan),惯常做法是下载、复制粘贴或切窗口导入,步骤多且容易打断流程。下面介绍社区插件 dsh-siyuan-sender(思源笔记直送):在交付卡片和预览工具栏上增加发送入口,也可让模型通过工具 siyuan_send 代发,正文落到你指定的笔记本,且不覆盖已有文档。

这是什么

dsh-siyuan-sender 由维护者 baby7 发布,在 DSH 插件目录中归类为「联网工具」。它只做一件事:把对话里生成的 Markdown 文档,经思源内核 API 写入你自建的思源实例。README 写明已在 SiYuan 3.8.8(Docker 部署、外网访问)实测通过。数据走本机配置与凭据,文档发往你填写的思源地址,不由插件向其他第三方上传内容。

核心功能

按 README 归纳,能力分三块:

  1. 界面按钮
    - 每份 .md 交付文件卡片右侧有「思源」按钮,点按即发送。
    - 右侧边栏阅读 .md 时,预览工具栏同样有发送入口。

  2. Agent 工具
    - 可对模型说「把 xxx.md 发到思源」,由 Agent 调用 siyuan_send。

  3. 行为约束
    - 点击后有成功或失败提示。
    - 重名不覆盖:自动在标题后追加时间戳。
    - 标题取自正文第一个 # 标题;若无则用文件名。
    - 仅支持扩展名白名单:.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、笔记本,点「测试连接」确认无误。

典型用法

  1. 对话生成 .md 后,在交付卡片右侧点「思源」,或在右侧预览工具栏点「发送到思源」。成功会提示落入路径。
  2. 或用自然语言让 Agent 执行,例如:
把 report.md 发送到思源

常见问题

README 故障表摘要:

现象 处理
点按钮没反应 重装插件后刷新页面
Token 无效 从思源「设置 → 关于」重新复制
地址无响应 确认是内核地址,勿带 /api
找不到笔记本 按提示中的实际笔记本名填写
证书校验失败 勾选「允许自签名证书」
超时 增大 timeoutMs(最高 120000)

结尾

若你已经在 DSH 里稳定产出 Markdown,又用自建思源做知识库,dsh-siyuan-sender 把「生成 → 入库」收成一两次点击或一句指令,并避免重名覆盖。细节与设计说明见仓库 设计说明.md;安装包与版本见 Releases 与 SkillHub 目录页。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜