会话通知推送 chenweigao/dsh-perch-notify

dsh-perch-notify

英文 | 中文在后

为 DeepSeek Harness（dsh）会话提供 webhook 通知：当有审批请求或轮次结束时收到一个 POST。适用于任何运行会话的 profile（web、tui、acp、sdk，以及你自己的）。

可与 ntfy.sh、Bark、Slack/钉钉/企业微信机器人 URL，或任何接受 POST 的 HTTPS 端点配合使用。

安装

dsh plugin --profile web add github:chenweigao/dsh-perch-notify

该包是纯 JavaScript，无需构建步骤，因此 git 安装不需要 prepare 脚本，也不需要 pnpm 构建允许列表。

配置

在启动 dsh 前通过环境变量设置目标地址：

export DSH_NOTIFY_URL="https://ntfy.sh/my-topic" # 通知发送到哪里
export DSH_NOTIFY_FORMAT="ntfy" # json (默认) | ntfy | bark
export DSH_NOTIFY_EVENTS="turn/end,approval/asked" # 可选；这是默认值
dsh web

或者在你的 profile 的 cordis.patch.yml 中固定相同的值（patch 行会替换整个配置值，因此请重新声明你要保留的内容）：

- id: perch-notify
name: dsh-perch-notify
config:
url: https://ntfy.sh/my-topic
format: ntfy
events: ['turn/end', 'approval/asked']
timeoutMs: 8000

没有 url 时，插件会以惰性方式加载，不发送任何内容。

它发送什么

该插件观察会话事件日志（session/event），仅转发生命周期事实——绝不包含提示词、回复、工具参数或文件内容。

json 格式（默认）发送：

{
"event": "turn/end",
"sessionId": "3d60430f-…", "time": "2026-09-21T13:29:56.155Z", "text": "dsh 轮次结束：3d60430f · completed",
"detail": { "turn": 1, "reason": "completed" }
}

审批请求会以 {"event": "approval/asked", …, "detail": {"toolName": "bash", "reason": "…"}} 的形式到达。

ntfy 格式会附带 Title/Tags 头发送文本，让手机响铃；bark 格式发送 Bark 的 {title, body} 结构。

投递失败会记录到 dsh 控制台，绝不会阻塞或重试 agent。

隐私

每个匹配事件向你自己端点发出一次出站 POST，未配置 URL 时默认关闭。没有其他网络调用，没有遥测，除 dsh 自身的会话日志外不存储任何内容。

起源

由 Perch 的作者构建，Perch 是一个用于远程 agent（包括通过 ACP 使用 dsh）的原生 macOS 工作区。如果你希望在 Mac 桌面上而不是通过 webhook 接收审批和轮次完成通知，那正是 Perch 所做的。

dsh 会话的 webhook 通知插件：审批等待、轮次结束时向你自己的地址发 POST。支持 ntfy / Bark / 任意 JSON 接收端，任何跑会话的 profile（web、tui、acp、sdk）都能用。

dsh plugin --profile web add github:chenweigao/dsh-perch-notify
export DSH_NOTIFY_URL="https://ntfy.sh/my-topic"
export DSH_NOTIFY_FORMAT="ntfy"
dsh web

纯 JavaScript、无构建步骤，git 安装不需要 pnpm allowlist。插件只转发生命周期事实（哪类事件、哪个会话、哪个工具要审批），不发送提示词、回复、工具参数或文件内容；未配置 URL 时完全不动作。
由 Perch 的作者构建——如果你想在 Mac 原生界面里直接处理审批和完成通知，而不是走 webhook，那是 Perch 干的事。

许可证

MIT