任务完成时播放提示音并弹出小通知:Web Audio 合成音效、页面内 toast、页面在后台时系统通知,纯浏览器方案、零系统依赖、跨平台。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-complete-notify
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:kaixinbaba/dsh-complete-notify
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本。请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DeepSeek Harness(DSH)任务完成通知插件:任务完成时播放提示音并弹出小通知。
- 纯浏览器方案:音效用 Web Audio 合成、弹窗是页面内 toast、页面在后台时改用系统通知(Web Notification API)——零系统依赖、零音频文件,Windows / macOS / Linux 通用
- 不依赖任何系统通知命令(无 osascript / notify-send / PowerShell),通知权限是浏览器站点级授权,授权一次即可
- 与官方运行指示灯同源的完成检测:会话列表快照的
running/completed状态
安装
dsh plugin --profile web add link:/path/to/dsh-complete-notify
# 重启 dsh web 生效(launchd 托管时):
launchctl kickstart -k gui/$(id -u)/com.dsh.dsh-web
使用
- 任务完成后:听到「叮咚」提示音 + 右上角弹出「✓ 任务完成」小卡片(含会话标题,点击跳转到该会话,5 秒自动消失)
- 页面切到后台/其他标签页时完成任务:收到系统通知(点击通知会聚焦窗口并打开对应会话)+ 提示音 + 标签页标题闪烁
- 设置 → 任务完成通知:
- 启用提醒 / 提示音 / 系统通知(页面在后台时)开关、音量滑块
- 「测试音效」「测试通知」按钮;首次点「测试通知」会请求浏览器通知权限,点允许
- 全部设置保存在浏览器 localStorage(
dsh.completeNotify.v1)
行为细节
| 场景 | 行为 |
|---|---|
| 页面可见,任一会话完成 | toast + 音效 |
| 页面在后台,会话完成 | 系统通知 + 音效 + 标题闪烁 |
| 系统通知权限被拒 | 降级为长时 toast(30 秒,回来也能看到)+ 标题闪烁 |
| 一次完成 | 只提醒一次(按会话去重,重新运行后再完成会再次提醒) |
| 子代理(subagent)会话 | 不提醒 |
| 多会话同时完成 | toast 栈最多 3 条(FIFO) |
已知限制
- 标签页必须开着(浏览器限制);标签页关闭后系统通知也收不到。如需关页推送可后续接 Push API(需推送服务器)
- v0.1 不区分任务成功/失败,统一「任务完成」;后续可从会话快照的
turn/endreason 上色 - toast 为深色样式,暂未跟随明暗主题切换
- 浏览器自动播放策略:首次用户交互(点击/按键)后音效才可用——DSH 里发第一条消息时即自然解锁
开发
node --test tests/ # 完成检测状态机单测(通过 stub 执行同一份 client/client.js)
npm run check # 语法检查
结构:
lib/index.js # 宿主半空壳(无逻辑)
client/client.js # 客户端单文件(DSH 模块加载器格式;全部逻辑在此)
cordis.patch.yml # bundle insert 声明
tests/ # node --test 单测
卸载
dsh plugin --profile web remove dsh-complete-notify
License
MIT
链接
同类插件
omdsh-dev/dsh-notification★ 52
回合完成桌面通知,按结果分控 + 关键词过滤。
omdsh-dev/dsh-open-in-vscode★ 45
从 Web GUI 一键在 VS Code 中打开工作区目录。
whyihaveyou/dsh-suite#plugin-notify★ 38
回合完成、错误或待审批时推送 IM webhook(飞书/企微/钉钉/Slack/Discord/自定义)与本地通知。
THEWOLFWALKER/dsh-notifier★ 30
DSH 统一通知推送与远程控制:一个 `notify()` API 打通 25+ 渠道(Telegram / 钉钉 / 飞书 / 企业微信 / QQ 机器人 / WxPusher / PushPlus / Server 酱 / Bark / Discord / Slack / ntfy / webhook 等),timeSensitive / active / passive 分级路由并重试;五通道反向审批(Telegram 按钮 / 飞书卡片 / QQ / WxPusher / 微信 iLink);QQ/钉钉/飞书官方扫码登录;本地 Web 管理台;多 agent 路由;系统桌面通知——以及**手机指挥中心**:在手机上发 `!status` / `!stop` / `!retry` 遥控 agent,通知带可操作按钮(查看结果 / 重试 / 日志,点击回调 agent)。密钥脱敏、工具限流、零运行时依赖。
omdsh-dev/dsh-lark★ 23
DeepSeek Harness 的飞书/Lark 机器人渠道:每个会话驱动独立 agent,工具审批、模型提问与计划审阅都以卡片回到聊天,点按钮或直接回复即可作答;聊天里用 `/cd`、`/model`、`/new` 切工作区、换模型、重开会话,多个机器人各自独立并可在同群交接回合。
bill9109/dsh-web-ui-notify★ 17
桌面通知提醒。