Adds a Settings card that pops a system notification and optional chime when a conversation turn completes.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:NattoCB/dsh-plugin-notifications
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
一个 DSH bundle 插件:在「设置 → 通用」新增对话完成通知卡片。启用后,任意根会话(跳过 subagent 与 automation)一轮对话结束时,由 host 进程弹出 macOS 系统通知——标题为会话名、正文为助手回复(过长截断),并可选播放与卡片试听完全一致的合成提示音。接入:在 web profile 声明依赖与 bundle,重启
dsh web。A DSH bundle plugin that adds a Turn-complete notifications card to Settings → General. When any root session (subagents and automation runs skipped) finishes a turn, the host process pops a macOS notification — title = session name, body = the assistant reply (truncated) — with an optional chime identical to the in-card preview. Install by declaring it as a dependency and bundle in your web profile, then restart
dsh web.
✨ 功能一览 / Features
- 🔔 对话完成通知 — host 监听
agent/status,在根会话 running→idle 边沿用terminal-notifier弹系统通知:标题 = 会话名(session/title→ 首条用户消息 → agent id,UTF-8 安全截断 60B),正文 = 最新助手回复(截断 200B);GUI 关闭也照常。subagent 与 automation 驱动的回合不触发;通知仅提示,点击不打开任何窗口。 / Host fires on the running→idle edge of root sessions; subagent and automation-driven turns are skipped. Clicking the banner does nothing (no-activate). - 🔊 合成提示音 — 按音调(柔和 / 清脆 / 低沉)进程内合成 16-bit PCM 单声道 WAV(44.1kHz;20ms 线性起音 + 指数衰减;音符间隔 120ms),经
terminal-notifier -sound播放;与卡片「试听」的 Web Audio 波形参数完全一致,听到即所得。无音频资源,离线可用。 / Chime synthesized to WAV with the exact profiles the card previews in Web Audio — no asset files, works offline. - 🎛️ Settings 卡片 — 渲染进「设置 → 通用」的
settings.general.item插槽,提供启用 / 提示音开关、音调选择与「试听提示音」按钮(该按钮同时作为用户手势触发浏览器通知授权);UI 中英双语。 / Card in Settings → General (zh/en) with enable, sound, tone and a preview button that doubles as the browser's notification-permission gesture. - 💾 持久化与降级 — 配置写入
$DSH_HOME/settings.yaml(命名空间notifications),经自有 HTTP APIGET /notifications/status、POST /notifications/update(settings.mutateRPC 只放行内置命名空间,第三方走自有路由,与 petdex / wechat-bridge 同模式);host 半未加载时自动降级为浏览器 monitor + localStorage,host 加载后接管,避免双重通知。 / Persists via its own HTTP API into settings.yaml; before the host half loads, the browser monitor + localStorage takes over, then defers to the host.
Quick Start
前置 / Prerequisites
- macOS(host 使用 Homebrew 前缀路径
/opt/homebrew) - terminal-notifier:
brew install terminal-notifier(host 弹通知与播放提示音的二进制,路径硬编码/opt/homebrew/bin/terminal-notifier) - DSH web profile(
$DSH_HOME/profiles/web)
安装 / Install
- 在
$DSH_HOME/profiles/web/package.json:dependencies增加"dsh-plugin-notifications": "file:<本仓库路径>";dsh.profile.bundles增加"dsh-plugin-notifications"。
- 确保
node_modules/dsh-plugin-notifications可解析到本仓库。 - 重启 web profile(
dsh web)使 host 半生效——否则只有浏览器侧 monitor,GUI 关闭后收不到通知。
启用 / Enable
- 打开 Web GUI → 设置 → 通用 → 对话完成通知,开启「启用系统通知」。
- 可选:开启提示音、选择音调(柔和 / 清脆 / 低沉);点「试听提示音」试听。
- macOS 首次弹通知时,在系统提示中授予通知权限。
Configuration
写入 $DSH_HOME/settings.yaml(也可直接在设置卡片中修改):
notifications:
enabled: false # 一轮对话完成后弹系统通知 / pop a system notification on turn completion
sound: true # 同时播放提示音 / also play the chime
tone: soft # 提示音音调 / chime tone: soft | crisp | low
| Key | Default | Meaning |
|---|---|---|
notifications.enabled |
false |
一轮对话完成后弹 macOS 系统通知 |
notifications.sound |
true |
通知时同时播放合成提示音 |
notifications.tone |
soft |
音调:soft 柔和 / crisp 清脆 / low 低沉 |
Links
More in this category
xmanrui/dsh-im★ 3702
Connect IM bots to DeepSeek Harness via QR codes or bot credentials (9 channels: Feishu, WeChat, DingTalk, WeCom, QQ, Slack, Telegram, Discord, and WhatsApp).
shaobeichen/dsh-pocket★ 3041
Remote phone access to the DSH Web UI: scan a QR code for LAN or public (cloudflared tunnel) access with real-time sync, a mobile-adaptive layout, and a settings tab.
c1overzz/dsh-bili-scroll★ 1446
Let your DSH agent browse Bilibili on its own, read subtitles, write a daily digest, and @ you when it finds something worth your attention.
OpenPetsHQ/openpets#dsh★ 1410
Bridges DeepSeek Harness lifecycle status, errors, and approval requests to a locally running OpenPets desktop companion.
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 606
Connects DeepSeek Harness to Avernet's Bot Collaboration Network over WebSocket V2, with automatic onboarding, isolated agent sessions, tool-call events, and multi-bot routing tools.
zaofan-make/dsh-qqbot★ 265
QQ official bot channel (enhanced fork of tencent-connect/dsh-qqbot): full agent chat in groups and DMs, rich media, an auto-tagged sticker library with AI image replies, join approval, mute and broadcast, scheduled wakeups, remote approvals over QQ, interactive cards, multi-account instances, extensions, member profiles, and token-saving value-scored wakeups.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.