ly6170/dsh-messager

适用于Deepseek Harness的消息提醒信使,可使用飞书、企业微信、钉钉、Telegram、Discord进行通知推送

Project Overview项目介绍

dsh-messager is a native notification plugin built exclusively for DeepSeek Harness (DSH). It can be installed via adding the local plugin path after building, and works right after restarting DSH, no patching required. It sends notifications across multiple channels when DSH sessions change state: when a task requires user interaction, completes execution, or throws an error. Supported channels include OS system toast notifications, browser-based web notifications, and third-party work chat platforms including Feishu, WeCom, Discord, DingTalk, and Telegram. To separate responsibilities, the plugin uses a dual-runtime architecture: a Node.js host handles system and third-party channels, while a browser-based client handles web notifications, with all configuration shared across both runtimes.

This plugin is designed for DSH users who want to stay updated on task status changes without having to keep the DSH web interface open and active at all times. Once you install the plugin following the provided documentation, a new "Notifications & Messenger" settings section will automatically appear in the DSH settings menu, right below the "Agent Presets" section. From this section, you can toggle individual notification channels on or off, adjust how detailed each notification is, add a custom title prefix, set deduplication cooldown periods, and more. Every change you make to the configuration takes effect immediately, no DSH restart is required after updating any setting.

dsh-messager is released under the permissive MIT open source license. The current 0.3.1 version only supports DSH version 0.1.2-rc.1, with peer dependencies explicitly locked to that release. System notifications rely on platform-native tools: macOS needs to download a third-party binary on first use, Linux requires libnotify-bin and a running notification daemon, and Windows uses built-in PowerShell APIs. For browser notifications, DSH will automatically ask the user for permission the first time the plugin loads; if permission is denied, the browser channel will silently disable itself without affecting other active notification channels.

这是一款专为DeepSeek Harness(DSH)开发的原生任务状态通知插件。当DSH会话需要用户交互、任务执行完成、任务运行出错时,它会通过系统通知(OS弹窗)、浏览器通知、飞书、企业微信、Discord、钉钉、Telegram等多个渠道推送提醒,让用户不用一直盯着会话列表的状态圆点。该插件采用单包双运行端结构:Node环境的host端负责系统通知和所有第三方通道,浏览器端负责网页通知,二者共用同一套配置。

该插件面向不想一直盯着DSH界面等待任务完成或交互提示的用户,帮助用户在DSH会话状态变化时及时收到多渠道提醒。安装完成后,DSH设置页左侧会自动新增「通知&信使」配置分区,用户可在这里开关各个通知通道、调整通知内容详略、设置去重冷却时间、自定义标题前缀等,所有配置修改都支持实时生效,不需要重启DSH。

该插件采用MIT许可证开源,当前v0.3.1版本仅支持DSH 0.1.2-rc.1版本,对底层依赖版本有明确要求。系统通知依赖各平台原生通知能力,macOS首次使用需要下载第三方二进制,Linux需要提前安装libnotify-bin并运行通知守护进程。浏览器通知需要用户授予站点权限,首次加载插件会自动请求权限,被拒绝后浏览器通道会静默降级。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
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 dsh-messager

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

READMEREADME

dsh-messager

简体中文 | English

DeepSeek Harness(DSH)的任务通知插件。会话需要审批、提问或计划审核,任务完成或出错时,可发送系统通知、浏览器通知,以及飞书、企业微信、Discord、钉钉、Telegram 消息。

兼容版本

v0.3.6 支持 DSH 0.2.0-rc.1 及兼容的后续 0.2.x 版本。 使用 DSH 0.1.x 请保留对应的旧版插件。升级到 DSH 0.2.x 后再安装本版本;现有通知配置无需迁移。

安装

**DSH 桌面版:**点击左上角「插件」→「添加插件」,输入 dsh-messager 并安装。安装后重启 DSH。

**命令行版(npm 包):**需要 Node.js 20+、pnpm 和 DSH CLI。将包安装到 Web profile:

dsh plugin --profile web add dsh-messager
dsh web

如果从 DSH 源码仓库运行,将 dsh 换为 pnpm dsh。安装后若 DSH 已在运行,请重启。

从源码安装(开发者可选):

git clone https://github.com/ly6170/dsh-messager.git
cd dsh-messager
pnpm install
pnpm build
dsh plugin --profile web add .
dsh web

使用

打开 DSH 设置页的「通知&信使」分区,选择触发时机、启用通道并填写对应的 webhook 或 Bot 信息,然后保存。浏览器通知默认开启;系统通知在桌面版默认关闭、其他环境默认开启;第三方通道默认关闭。浏览器或应用通知还需要相应权限。

通知只针对需要交互、根会话任务完成和任务出错;运行中的蓝色状态不会触发通知。桌面版窗口失焦时也会提醒当前会话完成。推送消息不再附带跳转链接。配置修改保存后即可生效。

常见问题

  • 设置分区未出现或配置路由返回 404:检查插件是否安装到当前使用的 web profile、DSH 是否已重启,以及 DSH 与插件版本是否兼容。
  • 浏览器通知未出现:检查站点通知权限;默认仅在页面隐藏或失焦时发送。
  • 桌面版通知未出现:检查应用通知权限;如桌面应用的通知被系统丢弃,可在设置页启用「系统通知」通道作为备用。
  • 用 --patch 调试时设置不可用:该模式只加载 host 端。要使用设置页,请通过 dsh plugin add 安装。

English · MIT License

← 上一个 Prev dsh-hot-installer 下一个 Next goalfydata →