dsh-notifier

你的 agent，装进口袋。 —— 通知、审批、遥控，全在你的手机里。

English · 简体中文

包元数据：dsh-notifier@0.9.5 · 1531 个自动化契约测试（1531 通过）· MIT 许可。

把 DeepSeek Harness agent 带到你平时使用的地方。dsh-notifier 用一个极简 notify() API 接住 27 个渠道，再提供手机审批、手机提问、会话控制和清爽的本机管理台——无需额外部署第二套运行时。

快速上手 · 升级指南 · 插件接入契约

你的 agent 和宿主本身都能经它推送：会话事件（turn/end · approval/asked · agent/error）自动通知，模型可直接调用 notify 工具，六条入站通道把审批与对话从手机带回。QQ 控制入站带来源标记：C2C 表示单聊，GROUP、缺失 chatType 或未知来源元数据均 fail-closed；conversation 的 routeUnsafe 旁路已堵。v0.3 加入本机网页控制台与多 agent 路由，v0.4 加入系统桌面通知，v0.5 把手机升级成指挥中心——长任务心跳、疑似卡住提醒、通知卡片自带停止按钮，v0.7 把「谁是家里人」从不透明 YAML 字符串升级为运行时身份体系——配对码准入、复合键绑定、管理台成员页，v0.8 让 agent 直接在手机上向你发起选择题（ask_user：选项卡片 + 编号兜底，超时永不代答）——全程零运行时依赖。

工作原理

DSH Agent ─notify() 工具───────┐
                               ├─▶ notifier 核心 ─▶ 27 个渠道（IM webhook / 推送 App / 国内生态）
DSH 会话事件 ─自动推送──────────┘   分级路由 · 分档重试 · 长消息分段 · 防打扰 · 账本
                                   心跳 ⏱ / 卡住 ⚠（v0.5）──▶ 卡片自带 ⏹ 停止按钮
你的手机 ─6 条入站通道──────────▶   远程审批（按钮 · 回复 1/2） · 远程会话（followup/inject/steer） · 远程提问（选项卡，v0.8）

每条消息都走同一条链路解析 —— 分级（timeSensitive / active / passive）→ 路由（多 agent 矩阵）→ 渠道适配器（resolve(cfg) + send(msg)）。两条触发线喂入核心：宿主自动推送会话事件（防抖、去重），模型直接调用 notify 工具。六条入站通道反向复用同一核心，承接审批与对话——v0.5 起出站线也会回报：长任务发心跳、静默任务报卡住，Telegram / 飞书通知带一键停止动作。

界面预览

Web 管理台（admin.enabled: true，仅绑 127.0.0.1；v0.5 起移动端自适应）六页实拍（演示数据）。首次打开默认是个人模式：配置、配对、测试后即可使用；绑定矩阵和会话等复杂设置需显式点击「打开高级设置」。请打开启动日志「Web 管理台已就绪」行中的完整本机 URL，不要猜端口 8104：

快速开始

dsh plugin add dsh-notifier --profile <profile-name>

--profile 必填（DSH 0.1.0-rc.6 起）：插件安装需指定目标 profile——填你实际运行的那个（如 web）。

把渠道加进你的 profile patch（cordis.patch.yml）：

insert:
  - id: dsh-notifier
    name: dsh-notifier
    config:
      channels:
        - type: telegram
          botToken: "123456:ABC-DEF..."
          chatId: "987654321"
        - type: dingtalk
          webhook: "https://oapi.dingtalk.com/robot/send?access_token=..."
          secret: "SEC..."
        - type: bark
          key: "your-device-key"

完成。turn/end、approval/asked、agent/error 事件即推送到所有已配置渠道，模型也能用 notify({ message, channel, title }) 主动推送。长任务默认自动发心跳与卡住提醒（v0.5），失控的 turn 直接在通知卡片上停掉。

核心功能

会话命令（私聊机器人发）

直接发文本 = 对话；! 前缀 = 中途纠偏（steer）；.. 结尾 = 立即发送（合并窗内）。群聊拒绝远程控制命令（QQ 群回「群聊不允许远程控制」）——请回原私聊会话操作。

配置项

所有渠道都在 config.channels 下。关键示例：

insert:
  - id: dsh-notifier
    config:
      channels:
        - type: telegram
          botToken: "123456:ABC-DEF..."
          chatId: "987654321"
        - type: feishu
          webhook: "https://open.feishu.cn/open-apis/bot/v2/hook/..."
        - type: wxpusher
          appToken: "AT_..."
          uids: ["UID_..."]
        - type: serverchan
          sct: "SCT..."

可选模块各自在专属键下显式开启：

v0.5 状态上报线默认值：longRunning 与 stall 默认开（15min 首条心跳、此后每 15min 一条；10min 无事件报卡住）——零配置的长任务不再是黑盒。turnStart 默认关（桌面场景每 turn 一条是噪音；发完任务就离开的移动场景建议显式开启）。所有时长下限钳制 60s；关闭任一项用 enabled: false。

渠道

另有六个渠道开启入站（远程审批 + 远程会话）：telegram、feishu、qq-bot、wxpusher、wechat、dingtalk —— 长连接或长轮询，无需公网 IP（仅 WxPusher 回调需要公网可达）。Telegram/飞书及 QQ C2C 单聊使用原生控制按钮；其他目标自动获得安全的文本或编号回复兜底，conversation 的 routeUnsafe 旁路不能绕过来源安全闸门。QQ、微信 iLink、钉钉图片消息路径已接线；文件收发按能力矩阵标记。本机 Web 管理台是唯一控制台，提供脱敏的待处理多选项提问列表，并经共享 Control Core 提供 choose/reject 结算。v0.5 起 telegram 与 feishu 额外承载通知动作卡片（停止按钮）。v0.7 起每条入站通道响应 /help /whoami /pair /unpair 注册命令，出站卡片目标走三级优先解析（该通道绑定 → 通道配置清单 → 全局回落）并按渠道做 id 形状守卫。

架构

src/
  adapters/           27 个渠道适配器（resolve(cfg) + send(msg)）+ 声明式 spec 引擎
  config.mjs          渠道注册表 + 配置 schema —— 矩阵唯一事实来源
  index.mjs           插件装配：patch、工具、事件监听、admin 接线
  event-listener.mjs  自动推送线（防抖、去重、分级路由）+ v0.5 状态线接线
  status/             v0.5 turn 跟踪器（心跳 / 卡住检测，纯逻辑）
  actions.mjs         v0.5 通知动作分发（turn/cancel，HMAC 一次性 token）
  notify.mjs          notify / notify_test 工具 + 滑动窗口限流
  routing/            多 agent 矩阵（resolveOutbound / resolveInbound）
  inbound/            六条入站通道（telegram/feishu/qq/wxpusher/wechat/dingtalk）+ v0.7 身份栈
                      （identity.mjs 绑定 · pairing.mjs 配对码 · commands.mjs 注册命令 · target-guard.mjs 目标解析）
  approval/           HMAC 一次性 token、去重、升级
  questions/          v0.8 远程提问 ask_user（选项卡 + 编号兜底，复用审批桥接栈）
  admin/              网页控制台（6 页、SSE、bearer 鉴权、移动端自适应）
  ledger.mjs          JSONL 账本 + 每日摘要
  rules.mjs           防打扰闸门（事件 / 关键词 / 宽限窗）
scripts/              channel-login.mjs · channel-selfcheck.mjs · route.mjs · gen-channel-matrix.mjs
test/                 1531 个测试（1531 通过，0.9.5 发布线）；历史 0.8.6 包为 909 个测试。

设计准则：纯 ESM（.mjs）、零运行时依赖、绝大多数渠道走声明式 spec 引擎、适配器薄而诚实、无构建步骤。

可选依赖（可选装配语义，S-13）

package.json 只保留两个 optionalDependencies，均精确锁定版本且仅懒加载——不装也能跑，缺失绝不搞崩启动、不影响核心 notify 链路：

• @larksuiteoapi/node-sdk 1.73.0 —— 仅飞书扫码登录 / 入站 WebSocket 用。缺失时飞书渠道报 missing-sdk 并给出安装指引（npm i @larksuiteoapi/node-sdk@1.73.0），其余渠道照常工作。
• qrcode-terminal 0.12.0 —— 仅登录 CLI 的终端二维码渲染用。缺失时 CLI 改打印可扫链接。

锁定纪律（S-13）：可选依赖区间收敛为已审查的精确版本（此前 ^ 下限会让 @larksuiteoapi/node-sdk 漂移到 ≥1.73 的 registerApp 回调改名；如今漂移面封死）。@tencent-connect/qqbot-connector 不在 optionalDependencies 中：npm 标记 UNLICENSED，维持「仅参考不引入」——不复制、不分发、不作为依赖引入。QQ 扫码登录代码路径保留懒 import()：若用户手动安装该包仍可用，缺包则降级为 missing-sdk 回执。

开发

npm test          # 0.9.5 发布线：1531（1531 通过）

新增渠道：在 src/adapters/ 实现适配器接口（resolve(cfg) + send(msg)），并在 src/config.mjs 注册；上方渠道矩阵由 node scripts/gen-channel-matrix.mjs 自动重生成。

许可

MIT · 第三方声明见 THIRD_PARTY_NOTICES.md