GuZhengSVT/dsh-WeCom-notify

DeepSeek Harness (dsh) 插件:事件驱动的企业微信(WeCom)群机器人通知 — 目标完成/阻塞与每轮对话自动推送,另含 wechat_notify 工具;走官方 webhook,零封号风险。

Project Overview项目介绍

This repository is a native plugin built exclusively for DeepSeek Harness (DSH). It enables automatic notifications of DSH workflow status to a user’s mobile phone via the official WeChat Work (Enterprise WeChat) group robot webhook. The plugin automatically pushes notifications when DSH goals change (complete or blocked) and after each round of agent conversation ends. It also exposes a wechat_notify tool that agents can use to actively send progress updates. All events are triggered by DSH’s internal state machine, so there is no risk of prompt injection forgery.

The plugin includes a graphical settings panel that is integrated directly into DSH’s settings menu. Users do not need to manually write YAML configuration files or set environment variables to use this plugin. All you need to do is paste your WeChat Work group robot webhook key, save it, and the plugin is ready to use. The plugin supports adding multiple webhook keys, so you can send the same notification to multiple groups at the same time. It also includes robust message scheduling with throttling, deduplication, retries, and proper text handling to prevent Chinese character garbling.

Two installation methods are offered for different use cases. Bundle assembly via package name linking includes the full settings panel functionality, while patch mounting works for users that only need the core notification features, even without the settings panel. Configuration follows a clear priority order: settings panel saved file takes highest precedence, followed by static cordis configuration, with environment variables as a fallback. This plugin is released under the permissive MIT open source license, and requires an existing DSH installation and a free WeChat Work account with an added group robot to use.

这是一款专门为 DeepSeek Harness(DSH)开发的原生通知插件,通过企业微信官方群机器人 webhook 向用户手机推送 DSH 运行状态通知。它支持在 DSH 任务完成、任务阻塞、每轮对话结束等关键节点自动推送通知,也允许 DSH 代理主动调用工具发送进度汇报,全程由DSH内部状态机触发。

它自带DSH设置面板中的图形化配置界面,用户只需粘贴群机器人的webhook key保存后即可使用,无需手动编写yaml配置或设置环境变量。它支持配置多个webhook key,可同时向多个企业微信群发送通知,还内置了节流、去重、重试、避免中文乱码的文本处理等完善功能。

本插件提供两种安装方式:带配置面板的包名装配,和不带配置面板但核心功能完整的patch挂载。配置优先级为设置面板保存的文件 > 静态配置 > 环境变量兜底。本项目采用MIT许可证开源,使用需要DSH运行环境,以及免费注册的企业微信账号和群内机器人。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:GuZhengSVT/dsh-WeCom-notify

把 GuZhengSVT/dsh-WeCom-notify 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-WeCom-notify

A DeepSeek Harness (dsh) plugin that pushes WeChat Work (企业微信) group-robot notifications to your phone — automatically.

License DeepSeek Harness plugin WeCom webhook Event-driven Settings UI


这是什么?

dsh-WeCom-notify 是 DeepSeek Harness(dsh)的一个插件: 通过企业微信官方群机器人 webhook,在 dsh 的关键节点自动把通知推到你的手机。

  • 任务完成 / 阻塞:goal 生命周期变化时自动推送(✅ dsh 任务完成 / ⛔ dsh 任务阻塞);
  • 每轮对话完成:自动推送该轮 agent 回复总结;
  • agent 主动汇报:wechat_notify 工具,供 agent 主动发进度;
  • 即装即用:自带 dsh 设置 → 企业微信通知 面板,粘贴 webhook key 保存即生效,无需手写 yaml / 环境变量;
  • 多群同时通知:支持填写多个 webhook key,一条通知同时发送到所有群。

全程无需 agent 记得调用工具——事件由 dsh 内部状态机触发,无法被 prompt injection 伪造。

✨ 特性

  • 官方通道,零封号风险:走企业微信官方 webhook(qyapi.weixin.qq.com),免费个人注册即可用,无第三方中转;
  • 设置面板,即装即用:dsh 设置 → 企业微信通知 图形化配置,多个 key 增删、@ 成员、节流参数一目了然,保存即热生效(无需重启),并持久化到 <DSH_HOME>/wecom-notify/config.json(0600 权限);
  • 多群同时通知:一条消息并发发送到所有已配置的群(各群独立限频,互不拖累),逐群报告发送结果;
  • 事件驱动:订阅 session/event(每轮总结)与 goal/changed(完成/阻塞)自动推送,不依赖 LLM 自觉;
  • 异步非阻塞:fetch 异步发送(不是 execFileSync 同步阻塞事件循环);
  • 健壮调度:串行队列、节流(默认 10s 间隔)、内容去重(默认 30s 窗口)、指数退避重试、10s 超时;
  • 中文可靠:UTF-8 按码点截断(不截断 emoji 代理对),markdown 转义防格式破坏;
  • 零隐私硬编码:仓库不含任何本机路径与密钥;密钥仅存于你的用户数据目录;
  • @ 提醒:支持 mentionUserid 在通知时 @ 指定成员;
  • 降级不报错:未配置 key 时插件正常加载,通知降级为日志提示。

🙏 致谢:dsh-wechat-notify 的贡献

本项目是 wssfk12138/dsh-wechat-notify 的优化重写版,灵感与基础均来自该项目。

dsh-wechat-notify(v0.1.0,ClawBot 通道版)的贡献:

  • 插件形态与接入方式:确立了「dsh 插件 + cordis.patch.yml 挂载 + 注册 wechat_notify 工具」的完整接入范式,本项目沿用同一生态位;
  • 工具设计:wechat_notify(message) 的接口设计、可读的「已发送 / 失败原因」返回值约定、未配置时的友好提示,均继承自原项目;
  • 中文可靠性思路:原项目「UTF-8 文件传递防乱码」的教训,直接催生了本项目「UTF-8 字节截断 + markdown 转义」的实现;
  • 扫码登录先例:原项目的 wechat_login / wechat_login_confirm 证明了「在 dsh 内完成微信连接」的可行性。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-tokensforce 下一个 Next dsh-print3d →