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 包自带预构建产物可直接安装。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-bell-notify(Laplace-bit/dsh-bell-notify)
仓库:https://github.com/Laplace-bit/dsh-bell-notify
本站详情页:https://www.yhbd.top/plugins/laplace-bit-dsh-bell-notify/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 5 · 最近提交 2026-09-10 · 主语言 TypeScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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 🔔
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 →
pan17/dsh-wechat
huguangyu666/dsh-plugin-notify
liustack/modlens
Clarklevis1995/dsh-mobile
ZSeven-W/dsh-crew