STARDUSTLC666/dsh-dingtalk
30最近提交 2026年8月15日
dsh-dingtalk DSH 插件
本插件让 agent 能单向推送 Markdown 或纯文本消息到钉钉群。提供 `dingtalk_notify`（Markdown）和 `dingtalk_text`（纯文本）两个工具。零依赖，全平台通用（Windows/macOS/Linux），仅依赖 Node.js 内置模块。
如何安装 dsh-dingtalk DSH 插件
dsh plugin --profile web add dsh-dingtalk复制不会执行命令。安装 dsh-dingtalk DSH 插件前请核对仓库和版本。
dsh-dingtalk DSH 插件数据来源
dsh-dingtalk DSH 插件快照日期：2026年8月16日
discovered
dsh-dingtalk DSH 插件能做什么
- 通过 `dingtalk_notify` 发送 Markdown 消息
- 通过 `dingtalk_text` 发送纯文本消息
- 支持钉钉机器人加签（HMAC-SHA256）安全机制
- 可通过 YAML 或环境变量 `DSH_DINGTALK_SECRET` 配置密钥
- 自定义 HTTP 请求超时（1000–60000 毫秒）
- 同一份代码跨平台运行
dsh-dingtalk DSH 插件适合哪些场景
- CI/CD 构建完成后通知钉钉群
- 系统异常报警发送到团队群聊
- 每日报告或定时摘要推送
- 通过 agent 工作流触发群通知
- 集成到任意需要群消息通知的 agent 场景
dsh-dingtalk DSH 插件适合谁
- 使用 DeepSeek Harness 并需要钉钉群通知的开发者
- 依赖钉钉内部沟通、希望 agent 自动推送通知的团队
dsh-dingtalk DSH 插件的限制
- 仅支持单向通知（agent → 钉钉群），不支持接收消息或双向机器人
- 不自动处理钉钉自定义关键词校验；若机器人设置了关键词，消息必须包含关键词否则会被拒绝
- v0.1 无 Web 设置页，只能通过 `cordis.patch.yml` 和环境变量配置
- 目前只支持 Markdown 和纯文本两种消息类型，其他类型（图片、链接等）尚未实现
- 钉钉 Markdown 渲染与实际标准 Markdown 可能存在差异
dsh-dingtalk DSH 插件的仓库 README 摘录
以下文字摘自 dsh-dingtalk DSH 插件的上游仓库 STARDUSTLC666/dsh-dingtalk 的 README，版权归原作者，仅作引用。
> **让 agent 在钉钉群里说话**：Markdown / 纯文本通知，加签安全，零依赖。     [](https://awesome-dsh-plugin.com) DeepSeek Harness 钉钉群机器人通知插件：让 agent 能**单向推送 Markdown / 纯文本消息到钉钉群**。纯插件实现，零核心改动，安装即可用。 纯 Node 实现，**全平台通用**（Windows / macOS / Linux 同一份代码），只依赖 `node:crypto` 与内置 `fetch`，无运行时依赖、无原生二进制。 ## 工具一览 | 工具 | 作用 | |---|---| | `dingtalk_notify` | 向配置的钉钉群发一条 **Markdown** 消息（`title` 标题 + `text` Markdown 正文） | | `dingtalk_text` | 向配置的钉钉群发一条 **纯文本** 消息（`content`） | 示例对话： > 帮我给钉钉群发一条消息：标题「构建完成」，正文「流水线 #123 已通过 ✅」。 ## 安装 ```sh dsh plugin --profile web add dsh-dingtalk ``` 装好后重启 `dsh web`。插件自带空配置，**不会弄崩启动**；配置前调用任何 `dingtalk_*` 工具都会返回明确的中文配置提示。 ## 第一步：拿到 webhook 与加签密钥 用钉钉【自定义机器人】方式，**不需要企业应用、不需要管理员权限**： 1. 打开目标钉钉群 → **群设置** → **智能群助手** → **添加机器人** → **自定义（通过 Webhook 接入自定义服务）** 2. 机器人名称随意，**安全设置勾选「加签」**，完成 3. 复制两样东西： - **Webhook 地址**：形如 `https://oapi.dingtalk.com/ro
阅读完整 README仓库未声明许可，使用前请先与作者确认。
dsh-dingtalk DSH 插件常见问题
如何获取钉钉 Webhook 和加签密钥？
打开要接收通知的钉钉群，进入群设置 > 智能群助手 > 添加机器人 > 自定义。安全设置勾选「加签」，完成创建后复制 Webhook 地址（如 `https://oapi.dingtalk.com/robot/send?access_token=...`）和加签密钥（如 `SEC...`）。这就是插件配置所需的全部信息。
安装后如何配置插件？
执行 `dsh plugin --profile web add dsh-dingtalk` 安装后，重启 `dsh web`。然后编辑 profile 下的 `cordis.patch.yml`（位于 `$DSH_HOME/profiles/<name>/`），添加 `tool-dingtalk` 配置项，填入 `webhook` 和可选 `secret`。再次重启生效。
可以把密钥放在环境变量里而不是 YAML 文件中吗？
可以。设置环境变量 `DSH_DINGTALK_SECRET` 为你的密钥即可。如果 YAML 中未显式设置 `secret`，插件会读取此环境变量。推荐这种做法，避免密钥被提交到版本控制。
为什么我收到错误码 310000？
错误码 310000 通常表示加签校验失败。请检查你的 `secret` 是否与钉钉机器人「加签」设置中的一致。另外，如果机器人同时启用了「自定义关键词」，消息内容必须包含该关键词，否则也会返回 310000。请同时检查这两项设置。
这个插件能接收钉钉群的消息吗？
不能，本插件仅支持单向通知：agent 向钉钉群发送消息，无法读取群消息或实现双向机器人。双向功能计划在后续版本中实现。