ly6170/dsh-messager

README 摘要

dsh-messager DeepSeek Harness（DSH）任务状态通知插件。 当会话需要交互、任务完成或任务出错时，通过 系统通知 （OS toast）、 浏览器通知 与 飞书机器人（webhook） 推送提醒——不再依赖盯着会话列表的圆点。 English readme English version: README.en.md 简介 dsh-messager 是 DeepSeek Harness（DSH）的一个通知插件，属于 单包双运行端（dual-runtime） 结构： - host 端 （Node，服务端）——负责系统通知与飞书 webhook； - client 端 （浏览器）——负责 Web Notification。 两端配置同源（settings 命名空间 messager ），Web 设置页可编辑、即时生效。 能力一览 需求 实现 触发时机 需要交互（审批 approval/asked 、提问/计划待审 ask user question 、客户端 pendingInteraction ）、任务完成（ agent/status running→idle 且仅根会话 + turn/end 原因）、任务出错（ agent/error ） 推送路径 系统通知（node-notifier toast）、浏览器通知（Notification API）、飞书机器人（webhook：interactive 卡片 + HMAC-SHA256 签名）； NotifyChannel 接口可扩展 可配置 触发开关、各通道启停/verbosity/icon、去重冷却、标题前缀等，见配置 触发语义与 Web UI 状态圆点完全对齐： 橙点 = 需要交互 （ pendingInteraction ）， 绿点 = 任务完成 （ running→idle 且非当前会话）， 蓝点 = 运行中 （不通知）。 特性 - 🟢 三种触发：需要交互 / 任务完成 / 任务出错，可独立开关； - 🔔 三条通道：系统通知、浏览器通知、飞书机器人，可独立启停、久内容繁复度（ minimal / normal / detailed ）； - ⚙️ 热更新配置：改设置即生效，无需重启 DSH； - 🔌 可扩展通道：实现 NotifyChannel 接口即可接入钉钉 / 企业微信 / Telegram 等； - 🧪 单元测试覆盖信号提取 / 模板渲染 / 调度去重 / 飞书签名 / 配置解析 / client diff。 快速开始 前置条件 依赖 要求 Node.js = 20 pnpm = 10 （推荐） DSH npx 可联网；或已装好 dsh CLI（发行版 dsh / 源码运行 pnpm dsh ） 下方命令用 npx -p @deepseek-ai/dsh 现拉安装…

分类