English

dsh-dingtalk

DeepSeek Harness 钉钉群机器人通知插件：让 agent 能单向推送 Markdown / 纯文本消息到钉钉群。纯插件实现，零核心改动，安装即可用。

纯 Node 实现，全平台通用（Windows / macOS / Linux 同一份代码），只依赖 node:crypto 与内置 fetch，无运行时依赖、无原生二进制。

工具一览

工具	作用
dingtalk_notify	向配置的钉钉群发一条 Markdown 消息（title 标题 + text Markdown 正文）
dingtalk_text	向配置的钉钉群发一条 纯文本 消息（content）

示例对话：

帮我给钉钉群发一条消息：标题「构建完成」，正文「流水线 #123 已通过 ✅」。

安装

dsh plugin --profile web add dsh-dingtalk

装好后重启 dsh web。插件自带空配置，不会弄崩启动；配置前调用任何 dingtalk_* 工具都会返回明确的中文配置提示。

第一步：拿到 webhook 与加签密钥

用钉钉【自定义机器人】方式，不需要企业应用、不需要管理员权限：

1. 打开目标钉钉群 → 群设置 → 智能群助手 → 添加机器人 → 自定义（通过 Webhook 接入自定义服务）
2. 机器人名称随意，安全设置勾选「加签」，完成
3. 复制两样东西：
   • Webhook 地址：形如 https://oapi.dingtalk.com/robot/send?access_token=xxxx
   • 加签密钥（secret）：形如 SECxxxx（勾选「加签」后才会出现）

安全设置推荐只勾选「加签」。如果同时勾选了「自定义关键词」，机器人会校验消息里是否包含关键词——那是钉钉服务端行为，本插件不处理（见「已知限制」）。

配置

在你 profile 的 cordis.patch.yml 里覆盖 tool-dingtalk 行（在 $DSH_HOME/profiles// 下），然后重启：

- id: tool-dingtalk
  config:
    webhook: https://oapi.dingtalk.com/robot/send?access_token=你的token
    secret: SEC你的加签密钥        # 可选，但强烈建议；也可用环境变量 DSH_DINGTALK_SECRET

完整配置项

字段	默认	说明
webhook	必填	机器人完整 Webhook 地址（?access_token=...）
secret