Laplace-bit/dsh-bell-notify

DeepSeek Harness(dsh)社区插件:为Agent生命周期事件合成铃声+右下角呼吸状态点,每个事件可上传自定义音频。

Project Overview项目介绍

dsh-bell-notify is a native community-built plugin made exclusively for DeepSeek Harness (DSH). It adds configurable audio notifications for key AI agent lifecycle events, so users can track task progress without keeping the DSH browser tab active at all times. All default notification sounds are generated in real time via Web Audio, so the plugin has an extremely small package size with no bundled audio assets. To install, run dsh plugin --profile <your-profile> add dsh-bell-notify directly via the DSH CLI; the npm package includes pre-built outputs that require no extra local compilation.

By default, the plugin only enables sound alerts for three high-priority events: when the agent starts executing, when it waits for user confirmation, and when the current task round completes. All other agent lifecycle events are disabled by default to avoid unnecessary interruptions to your workflow. Users can toggle individual events on or off, upload custom audio files to replace default sounds, preview sounds before saving, and restore default settings at any time through the DSH plugin settings panel. It is designed for developers running long DSH tasks in the background while working on other separate tasks.

This plugin is released under the open source MIT license, and all user configuration and custom audio files are stored locally in the user’s browser via localStorage and IndexedDB, with no data uploaded to any external servers. It is compatible with all recent DSH core versions from 0.1.0-rc5 up to the latest 0.1.2-alpha release, with built-in compatibility fixes for newer core API changes. After first installation, you need to click anywhere on the DSH page once to unlock audio playback, per browser autoplay policies, before notifications will work correctly. It can be updated or uninstalled directly via simple DSH CLI commands anytime.

dsh-bell-notify 是专门为 DeepSeek Harness(DSH)开发的原生社区插件,核心功能是为 DSH 中 AI Agent 的关键生命周期事件添加可配置的声音提示。用户无需时刻盯着 DSH 会话页面,就能通过不同铃声快速获知任务状态,所有内置铃声均通过 Web Audio 实时合成,不占用额外包体空间。插件配置统一整合在 DSH 的原生设置面板中,不会额外添加悬浮组件占用工作区界面空间。

该插件默认仅开启开始执行、等待用户确认、本轮任务完成三个核心事件的提示音,其余事件默认关闭避免打扰,用户可根据自身需求在配置面板中单独开启或关闭每个事件的提示,还可以上传自定义音频替换默认铃声,也能随时还原默认设置。它主要适合需要让 DSH 在后台运行长任务、并行处理多项工作、不希望一直盯着浏览器页面的开发者使用。

该插件采用 MIT 许可开源免费使用,所有配置和自定义音频都保存在用户浏览器本地,不会上传到任何外部服务器,支持 DSH 0.1.0-rc5 到最新 0.1.2-alpha 版本的内核。首次安装后需要点击页面任意位置解锁音频,符合浏览器自动播放策略要求,可通过 DSH CLI 命令行完成安装、更新和卸载操作,npm 包自带预构建产物可直接安装。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile bell add dsh-bell-notify

把 Laplace-bit/dsh-bell-notify 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-bell-notify 🔔

中文 · English

npm version Pages MIT license 在线试听

dsh-bell-notify 是 DeepSeek Harness(dsh)的社区插件。它把关键 Agent 生命周期事件变成可配置的声音提示,让你在不盯着页面时仍能掌握进度。

所有铃声均由 Web Audio 实时合成,不携带音频资源。配置集中在 设置 → 插件 → 插件配置 → 铃声通知:不再提供工作区悬浮面板或右下角状态点,避免占用会话界面。

它不是 DeepSeek 官方发行的一部分,是一个 MIT 协议开源的社区插件。

一句话定位

如果你在后台运行 DeepSeek Harness(dsh)任务,想在需要介入或任务完成时收到低打扰提示,安装这个插件即可。它适合长任务、并行工作和不希望一直盯着浏览器的开发者;不需要外部服务,也不会上传音频。

它不是桌面系统通知桥,也不是通用的浏览器通知库:声音只在 DSH Web 会话的 Agent 生命周期事件发生时播放。

它能干什么

🎵 需要时才响

每个可配置事件都有独立铃声。首次安装默认只开启三个最需要注意的节点:开始执行、等待确认、本轮完成;其余事件预置为关闭,避免过程细节持续打断你。

环节 默认铃声 首次状态
会话启动 startup 关闭
开始执行 click 开启
开始思考 notify 关闭
工具调用 tick 关闭
工具完成 drop 关闭
命令执行 beep 关闭
命令完成 rise 关闭
等待确认 alert 开启
本轮完成 success 开启
回到空闲 confirm 关闭

🎛️ 每个声音都能自己换

打开 设置 → 插件 → 插件配置 → 铃声通知,可对每一个事件:

  • 试听默认音,或者试听你上传的音
  • 上传自己的音频文件替换默认音
  • 还原回默认

换上的声音会记住(刷新后仍在),界面会显示上传的文件名。需要回到原始配方时,直接选择“还原默认”。

🎼 声音是「活」的

所有铃声都是实时合成的——不是一段段录好的音频文件。这意味着:

  • 零音频资源,包体轻到可以忽略
  • 内置配方在播放时实时生成;每个事件都可以替换成自己的音频
  • 离线可用,不联网、不加载外部资源

为什么做这个

当 Agent 运行较久时,页面并不总在视野里。用少量高价值提示音标记开始、需要确认和完成,你可以把注意力留给别的工作,需要介入时再回到 Harness。

安装

从 DeepSeek Harness 源码仓库里:

pnpm dsh plugin --profile bell add dsh-bell-notify

如果 PATH 上已经有 dsh:

dsh plugin --profile bell add dsh-bell-notify

npm 包带预构建产物,无需 pnpm ≥10 的构建脚本授权,直接可装。

启动:

pnpm dsh --profile bell

打开页面后先点一下页面任意位置(浏览器的音频自动播放策略,点一次即可解锁声音),然后在 设置 → 插件 → 插件配置 → 铃声通知 中按需要调整事件。

卸载:

pnpm dsh plugin --profile bell remove dsh-bell-notify

内核兼容性

DSH 内核 本插件支持情况
0.1.0-rc.5 ~ 0.1.0-rc.7 ✅ 全部版本
0.1.1-rc.2 ✅ 全部版本
0.1.2-alpha.1 ~ 0.1.2-alpha.3 ✅ 0.1.2(含 2026-09-01 兼容修复的构建);此前发布版在 0.1.2 上加载失败

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev deep-structural-analysis-skill 下一个 Next dsh-composer-polish →