前言¶

在 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 歸納，能力分三塊：

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 許可證，確認與自有思源的網絡與合規要求一致。

配置¶

需準備三項：

可選項：父文檔路徑（筆記本內位置，/ 表示根目錄）；私有 HTTPS 時可勾選「允許自簽名證書」。README 說明 Token 只寫入本機憑據庫，不進設置文件、也不發給瀏覽器。超時可在配置中調整 timeoutMs（最高 120000）。

在 DSH 設置 → 思源筆記直送 中填寫地址、Token、筆記本，點「測試連接」確認無誤。

典型用法¶

1. 對話生成 .md 後，在交付卡片右側點「思源」，或在右側預覽工具欄點「發送到思源」。成功會提示落入路徑。
2. 或用自然語言讓 Agent 執行，例如：

把 report.md 發送到思源

常見問題¶

README 故障表摘要：

結尾¶

若你已經在 DSH 裏穩定產出 Markdown，又用自建思源做知識庫，dsh-siyuan-sender 把「生成 → 入庫」收成一兩次點擊或一句指令，並避免重名覆蓋。細節與設計說明見倉庫 設計說明.md；安裝包與版本見 Releases 與 SkillHub 目錄頁。