STARDUSTLC666/dsh-dingtalk
30Last commit Aug 15, 2026
dsh-dingtalk DSH plugin
This plugin enables DeepSeek Harness agents to push single-direction notifications to DingTalk groups. It provides two tools: `dingtalk_notify` for Markdown messages and `dingtalk_text` for plain text. The plugin is zero-dependency, cross-platform (Windows/macOS/Linux), and uses only Node.js built-in modules.
How to install the dsh-dingtalk DSH plugin
dsh plugin --profile web add dsh-dingtalkCopying does not run this command. Review the repository and version before installing the dsh-dingtalk DSH plugin.
dsh-dingtalk DSH plugin data source
dsh-dingtalk DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-dingtalk DSH plugin can do
- Send Markdown messages via `dingtalk_notify`
- Send plain text messages via `dingtalk_text`
- Supports DingTalk robot signing (HMAC-SHA256) for security
- Configurable via YAML or environment variable `DSH_DINGTALK_SECRET`
- Customizable HTTP request timeout (1000–60000 ms)
- Works on all platforms with the same code
Where the dsh-dingtalk DSH plugin fits
- Notify a DingTalk group when a CI/CD pipeline completes
- Send system alerts or error reports to a team chat
- Deliver daily summaries or scheduled reports
- Trigger notifications from agent-based workflows
- Integrate with any agent that can call tools for group messaging
Who the dsh-dingtalk DSH plugin is for
- Developers using DeepSeek Harness who need DingTalk group notifications
- Teams that rely on DingTalk for internal communication and want agent-driven alerts
dsh-dingtalk DSH plugin limitations
- Only supports one-way notification (agent → DingTalk); no incoming message handling or bidirectional robot
- Does not automatically handle DingTalk's keyword verification; if the robot has keyword rules, messages must contain the keyword or they will be rejected
- No web-based settings page in v0.1; configuration is only via `cordis.patch.yml` and environment variables
- Only Markdown and plain text message types are supported; other types (image, link, etc.) are not yet implemented
- Markdown rendering may differ from standard Markdown due to DingTalk's own parser
dsh-dingtalk DSH plugin: from the repository README
Quoted from the STARDUSTLC666/dsh-dingtalk README, the upstream source of the dsh-dingtalk DSH plugin. Copyright remains with the original authors.
> **让 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
Read the full READMEThe repository declares no license. Check with the authors before using it.
dsh-dingtalk DSH plugin questions
How do I get a DingTalk webhook and secret?
Open the DingTalk group where you want notifications, go to Group Settings > Smart Group Assistant > Add Robot > Custom. Choose 'Signing' as the security method, complete the setup, then copy the Webhook URL (e.g., `https://oapi.dingtalk.com/robot/send?access_token=...`) and the secret (e.g., `SEC...`). These are all you need to configure the plugin.
How do I configure the plugin after installation?
After installing with `dsh plugin --profile web add dsh-dingtalk`, restart `dsh web`. Then edit your profile's `cordis.patch.yml` (located in `$DSH_HOME/profiles/<name>/`) to add a `tool-dingtalk` entry with the `webhook` and optionally `secret` values. Restart again for the changes to take effect.
Can I use an environment variable for the secret instead of the YAML file?
Yes. Set the environment variable `DSH_DINGTALK_SECRET` to your secret key. The plugin will use it if `secret` is not explicitly set in the YAML configuration. This is recommended for security to avoid committing secrets to version control.
Why am I getting error code 310000?
Error code 310000 usually indicates a signing verification failure. Check that your `secret` matches the one configured in the DingTalk robot's 'Signing' setting. Also note that if you have enabled 'Custom Keywords' on the robot, the message must contain that keyword, otherwise the same error may appear. Verify both settings.
Does this plugin receive messages from DingTalk groups?
No, this plugin is strictly one-way: it only sends notifications from the agent to the DingTalk group. It cannot read messages from the group or act as a bidirectional chatbot. Such functionality is planned for future versions.