dsh-notifier

Your agent, in your pocket.

把 DeepSeek Harness 放进手机里：28 个出站通知渠道、6 个入站控制渠道，通知、审批、提问、远程会话和任务/Session 控制统一收口。

English · 快速指南 · 排障 · 兼容性

它解决什么

dsh-notifier 是 DeepSeek Harness 的通知与远程操作层。最核心的使用场景很简单：你离开 DSH 窗口以后，仍然知道 Agent 在干什么；需要你时，直接从手机处理。

• 随时收到通知：任务完成、审批、错误、长任务状态，以及模型主动触发的通知。
• 手机直接处理：批准/拒绝、回答 ask_user、继续对话、纠偏正在执行的任务、切换任务或 Session。
• 日常管理留在 DSH：Native 「通知与控制」 是主入口；高级管理台只负责成员、绑定、Session、诊断和 Recovery。
• 失败尽量局部化：未知/未绑定的入站操作 fail-closed；单个通知渠道失败不拖垮其他渠道。

管理台界面截图

以下均为本地管理台的视口截图，覆盖解锁门、首次配置向导、渠道配置和窄屏/手机布局；长整页导出图不会直接塞进 README。

安装

一句话让 AI 帮你装

把下面这句话发给能操作当前机器终端的 AI / Agent：

请帮我在这台机器上安装或升级 dsh-notifier 最新稳定版。先自动识别当前正在使用的 DSH profile 和现有安装来源，确认 DSH / Node 版本兼容，并保护已有配置；不要修改无关插件，也不要打印任何 Token / Secret。使用官方发布包完成安装，重启对应 DSH Host 一次，确认实际安装版本和 「通知与控制」 入口，最后把你执行过的命令、结果和仍存在的异常汇报给我。项目：https://github.com/THEWOLFWALKER/dsh-notifier

更完整、适合直接交给 Codex / Claude Code / Cursor / 终端 Agent 的版本见：AI 安装指南。

自己安装

dsh plugin add dsh-notifier@latest --profile <profile名>

安装后重启 DSH 一次，让新的 Host 插件和 client.js 装载。然后：

1. 从 DSH 侧栏打开 「通知与控制」，或进入 Plugins → dsh-notifier；
2. 选一个你已经在用的通知渠道；
3. 填凭证，点 「保存并测试」；
4. 如果提供方只确认 API 已接受请求，而没有端到端 receipt，请到手机实际确认；“provider accepted”不会被写成“确认送达”。

装好以后，出站配置修改会 Hot Apply。入站 SDK / WebSocket / 长轮询如果页面显示 「等待重启」，仍需要重启来重建连接。

你需要哪一种用法

| 你的目标 | 从这里开始 | | --- | --- | | 只想收到任务通知 | 在「通知与控制」配置一个出站渠道 | | 想在手机批准 / 回答问题 | 再配置一个支持的入站渠道，然后完成成员配对 | | 想直接在手机和 Agent 对话 | 配对后，在机器人私聊直接发文字 | | 想中途纠偏正在执行的任务 | 在已绑定私聊发送 ! <补充指令> | | 想管理成员、绑定、Session、Recovery | 从 Native 打开「高级管理台」 | | Headless / 自动化部署 | 看 完整指南 的 YAML / CLI 部分 |

支持的渠道

出站 28 个： Bark、Bell、Chanify、Desktop、钉钉、Discord、飞书、Google Chat、Gotify、iGot、Mattermost、ntfy、OneBot 11、PushDeer、Pushover、PushPlus、Qmsg、QQ 官方机器人、Server酱、Slack、Microsoft Teams、Telegram、Webhook、企业微信群机器人、企业微信应用、WPS Bot、WxPusher、息知。

入站控制 6 个： Telegram、飞书、QQ 官方机器人、WxPusher、微信 iLink、钉钉。

不同 provider 的按钮、附件、送达回执、重连、账号额度并不一样。项目只按真实证据等级声明能力，详见 兼容性矩阵。

| 命令 | 用途 | | --- | --- | | /help | 查看命令 | | /whoami | 查看身份 / 配对状态 | | /status | 当前路由 / Session 状态 | | /tasks / /use … | 查看或选择活跃任务 | | /sessions | Session 概览 | | /stop | 停止当前 turn | | /route | 查看双向路由 | | /quiet … / /unquiet … | 静默 / 恢复通知 | | /pair <码> / /unpair | 配对 / 解绑入站身份 | | /log [N] | 有界、脱敏的近期通知摘要；默认关闭且仅 owner |

普通文字会继续和 Agent 对话；前缀 ! 会纠偏当前正在执行的 turn。群聊默认不开放高风险远程控制语义。

工作方式

DSH 事件 / notify() / 其它插件
                 │
                 ▼
        dsh-notifier core
        ┌────────┴────────┐
        ▼                 ▼
    28 个出站          health / activity
        │                 │
        ▼                 │
       手机               │
        │                 │
        └─ 6 个入站 ──────┘
              │
              ▼
       identity + Control Core
审批 · ask_user · 会话 · 任务/Session 控制

Native UI、notifier runtime、高级管理台和测试尽量围绕同一份真实状态工作，不维护“页面看起来已经改了、运行时其实没改”的第二套真相。

遇到问题：先让 AI 帮你定位，再上报

不要一上来就把一大段日志贴进 Issue。 推荐支持流程：

1. 把 AI 排障提示词 发给能读当前终端/日志的 AI；
2. 先做只读诊断：确认实际安装版本、DSH profile / 版本、安装来源、问题属于哪个子系统，并做最小复现；全程脱敏；
3. 如果只是旧包、错误 profile、残留 file: 安装、漏重启、凭证或 provider 配置问题，让 AI 协助本地解决并重新验证；
4. 如果仍解决不了，让 AI 按 定位与诊断指南 生成一份短小、可复现的报告；
5. 再把这份报告发到 GitHub Issue / QQ 群 / 邮箱。

这样维护者拿到的是“已经排除常见环境问题后的证据”，不是聊天记录和猜测。

文档

| 文档 | 用来干什么 | | --- | --- | | 完整指南 | 安装、首访、出站/入站、配对、日常使用 | | AI 安装 | 一句话 / 完整提示词，让终端 Agent 安全安装 | | 排障指南 | 人类 + AI 的第一轮问题定位 | | 定位与诊断 | 收集证据、生成 Support Report | | 兼容性 | DSH / 可选 SDK / provider 的证据等级 | | 升级指南 | 更新、确认实际版本、清理残留、回滚 | | 插件 API | ctx.notifier 消费方接口 | | 架构 | 内部设计与运行时权威 | | 变更记录 | 版本历史 |

联系方式

可稳定复现的产品问题，优先走AI 预排障后的 GitHub Issue。

• QQ：3622976831
• 邮箱：[email protected]
• QQ 群：947656156

不要通过 Issue、QQ 或邮件发送 Bot Token、Webhook Secret、Admin Token、完整 state.json 或未脱敏的私聊内容。

维护公告：至 2026-10-01 前作者因考试，回复可能较慢。

开发信息

Node.js 22+、ESM、零强制运行时依赖。部分 provider 的扫码/接入能力使用 optional dependency，仅在需要时加载。

开发、验证和发布规则见 AGENTS.md、OPERATIONS 和仓库测试。

License

MIT