前言¶
在 DeepSeek Harness（DSH）裏，agent 跑完構建、巡檢、批處理等任務後，常需要把結果發到釘釘羣。如果自己在業務代碼裏拼 Webhook 請求，要處理消息體、加簽、超時和配置位置。dsh-dingtalk 把這些封裝成兩個 DSH 工具：dingtalk_notify 發 Markdown，dingtalk_text 發純文本。
它只做單向通知：agent 推消息到釘釘羣，不接收羣消息，也不做雙向機器人。
這是什麼¶
dsh-dingtalk 是一個 DeepSeek Harness 插件，倉庫 owner 爲 STARDUSTLC666，許可證爲 MIT。它把釘釘自定義機器人 Webhook 封裝成兩個工具，支持加簽安全模式，配置項包括 webhook、secret、timeoutMs。
這個插件是純 Node 實現，無運行時依賴，支持 Windows、macOS 和 Linux。README 中說明它在 @deepseek-ai/dsh@0.1.2-alpha.2 上驗證過（2026-08-31），運行時不 import 任何 @deepseek-ai/* 內部模塊。
核心能力¶
dingtalk_notify：向釘釘羣推送一條 Markdown 消息，包含title和text。dingtalk_text：向釘釘羣推送一條純文本消息，使用content。- 使用釘釘自定義機器人 Webhook，並支持加簽安全模式。
- 支持通過環境變量
DSH_DINGTALK_SECRET保存加簽密鑰。 - 支持配置項：
webhook、secret、timeoutMs。 - 純 Node 實現，無運行時依賴，全平臺通用。
安裝與啓用¶
先安裝插件：
dsh plugin --profile web add dsh-dingtalk
安裝後，在對應 profile 的 cordis.patch.yml 中覆蓋 tool-dingtalk 行，配置 webhook 與 secret，然後重啓。
示例配置如下：
- id: tool-dingtalk
config:
webhook: https://oapi.dingtalk.com/robot/send?access_token=你的token
secret: SEC你的加簽密鑰
如果不想把密鑰寫進 YAML，也可以只配置 webhook，並把加簽密鑰放到環境變量裏。在 Windows PowerShell 中可這樣設置：
$env:DSH_DINGTALK_SECRET = "SEC你的加簽密鑰"
注意：這個插件會以當前 dsh 進程的權限運行。安裝前建議檢查源碼和 MIT 許可證，確認其能力邊界符合你的使用場景。
典型用法¶
在釘釘羣設置中添加自定義機器人，安全設置勾選「加簽」，複製 Webhook 地址和 secret，然後寫入 cordis.patch.yml。
配置完成後，可以直接讓 agent 發消息。例如：
幫我給釘釘羣發一條消息：標題「構建完成」，正文「流水線 #123 已通過」。
這類用法適合做任務結果通知、構建通知、巡檢結果推送等單向出口。
限制與注意¶
- 僅單向通知：不支持接收羣消息，也不支持雙向機器人，例如 @機器人 後回覆。
- 不支持企業自建應用。
- 目前只支持 Markdown 和純文本，不支持圖片、Link、FeedCard、ActionCard 等類型。
- 沒有 Web 設置頁，配置通過
cordis.patch.yml與環境變量完成。 webhook是羣通知鑰匙，知道它的人可以往羣裏發消息。不要把cordis.patch.yml提交到 Git 倉庫。secret推薦通過環境變量DSH_DINGTALK_SECRET保存。- 插件不做聯網上報；
secret只在內存中用於計算 HMAC 簽名。 - 這是社區插件，與 DeepSeek 官方及釘釘官方無關；
@deepseek-ai/*爲官方保留命名空間。
相關位置¶
目錄頁：
https://www.skillhub.cn/plugins/STARDUSTLC666/dsh-dingtalk
GitHub：
