dsh-perch-notify
English | 中文在后
Webhook notifications for DeepSeek Harness (dsh) sessions: get a POST when an approval is requested or a turn ends. Works with any profile that runs sessions (web, tui, acp, sdk, your own).
Use it with ntfy.sh, Bark, a Slack/DingTalk/WeCom bot URL, or any HTTPS endpoint that accepts a POST.
Install
dsh plugin --profile web add github:chenweigao/dsh-perch-notify
The package is plain JavaScript with no build step, so a git install needs no prepare script and no pnpm build allowlist.
Configure
Set the destination in the environment before launching dsh:
export DSH_NOTIFY_URL="https://ntfy.sh/my-topic" # where notifications go
export DSH_NOTIFY_FORMAT="ntfy" # json (default) | ntfy | bark
export DSH_NOTIFY_EVENTS="turn/end,approval/asked" # optional; this is the default
dsh web
Or pin the same values in your profile's cordis.patch.yml (patch rows replace whole config values, so restate what you keep):
- id: perch-notify
name: dsh-perch-notify
config:
url: https://ntfy.sh/my-topic
format: ntfy
events: ['turn/end', 'approval/asked']
timeoutMs: 8000
With no url the plugin loads inert and sends nothing.
What it sends
The plugin observes the session event log (session/event) and forwards lifecycle facts only — never prompts, replies, tool arguments, or file contents.
json format (default) posts:
{
"event": "turn/end",
"sessionId": "3d60430f-…",
"time": "2026-09-21T13:29:56.155Z",
"text": "dsh 轮次结束：3d60430f · completed",
"detail": { "turn": 1, "reason": "completed" }
}
An approval request arrives as {"event": "approval/asked", …, "detail": {"toolName": "bash", "reason": "…"}}.
ntfy format posts the text with Title/Tags headers so phones ring; bark format posts Bark's {title, body} shape.
Delivery failures are logged to the dsh console and never block or retry the agent.
Privacy
One outbound POST per matching event to your own endpoint, off by default without a URL. No other network calls, no telemetry, no storage outside dsh's own session log.
Origin
Built by the author of Perch, a native macOS workspace for remote agents (including dsh over ACP). If you want approvals and turn completion on your Mac desktop instead of a webhook, that is what Perch does.
中文
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 干的事。
License
MIT
