dsh-push

English | 简体中文

把 DeepSeek Harness 的 agent 生命周期通知推送到 Bark、飞书、企业微信、钉钉、ntfy 或通用 webhook。

安装

从 npm 安装：

dsh plugin --profile web add dsh-push
dsh plugin --profile headless add dsh-push

从 GitHub 安装时使用提交固定的仓库地址：

dsh plugin --profile web add github:kiim-wong/dsh-push#<sha>

Git 安装会执行包的 prepare 构建脚本。首次安装前，在目标 profile 的 pnpm-workspace.yaml 中允许该包构建：

allowBuilds:
  dsh-push: true

包会通过 cordis.patch.yml 挂载为 dsh-push，不需要修改 dsh monorepo，也不写入 profile 的 patch 配置。

配置

配置文件默认位于 $DSH_HOME/dsh-push/config.json；也可以用 DSH_PUSH_CONFIG 指定路径。可从 [config.example.json](./config.example.json) 开始。环境变量引用支持 $VAR 与 ${VAR}，日志写入配置文件同目录的 push.log。

每个 channel 至少需要自己的类型和目标地址。敏感值只放配置文件或环境变量，不要放进 cordis.patch.yml。

支持的事件为 idle、interrupted、needInput 和 exit。idle 可通过 minDurationSec 过滤；interrupted 不受该过滤影响。默认不推送 subagent，设置 includeSubagents: true 才会包含会话头部 origin 为 subagent 的 agent。

/push 命令

挂载命令服务时提供 /push status、list、get、set、enable、disable、test、events、on 和 off。没有命令服务的 headless 组合仍会加载推送事件监听器。

限制

通知发送不重试；每个请求有独立超时和进程退出时的有界 flush。dsh 没有 pi 的会话 quit 事件，因此 exit 表示插件树拆卸，不表示某个 Web 会话关闭。推送正文不包含对话正文，只包含生命周期摘要。

渠道实现沿用 pi-agent-push 的协议与签名算法；本项目仅将事件和命令层适配为 Cordis。