deepseekplugins

DeepSeek Harness plugin

dsh-plugin-notification-sounds

DSH 提示音插件（原生常驻版）：为开始运行、成功完成、异常中断、需要审批、子代理完成等事件分别设置提示音，支持逐事件上传本地音频文件。

Notifications & Integrations
Jump to install

Source facts

Repository
Heldea-xianmiao/dsh-plugin-notification-sounds
Latest update
Aug 15, 2026
Category
Notifications & Integrations
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Heldea-xianmiao/dsh-plugin-notification-sounds
Plugin: dsh-plugin-notification-sounds
Author: Heldea-xianmiao

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

DSH 提示音插件（dsh-plugin-notification-sounds）

为 DSH（DeepSeek Harness） 提供可自定义的事件提示音：不同事件分别设置不同的声音，并且每个事件都可以上传本地音频文件作为提示音。

> GitHub Tag：dsh-plugin

功能

事件触发时机默认音效
开始运行 start代理开始处理一轮任务短促单音（C5）
成功完成 success一轮任务正常结束上行双音（G5 → C6）
异常中断 error任务出错（step/turn 错误）低沉警示音（方波下行）
需要审批 approval弹出审批请求叮咚双音（E5 → A5）
子代理完成 subagent-end后台子代理结束轻快双音（D5 → F#5）
  • 每个事件可独立：启用/停用、试听、上传本地音频（常见音频格式，单个最大 2MB）、恢复默认
  • 总开关 + 音量（0–100%）
  • 默认音效由代码合成（WAV，无外部资源依赖），文件版本见 assets/ 目录
  • 自定义音效与全部配置持久化到工作区根目录 .dsh-notification-sounds.json，插件重启后依然保留
  • 提示音在浏览器页面中播放（页面打开时生效）

事件检测原理

  • agent/status：running → 开始运行；idle → 结束（配合 agent/error 判断成功还是异常）
  • agent/error：记录错误标记，回合结束时触发「异常中断」
  • approval/request：审批瀑布事件触发「需要审批」（仅当审批真正需要用户决定时）
  • subagent/end：子代理结束触发「子代理完成」

安装（常驻插件）

本插件是标准的 DSH web 插件包（Host 半边 lib/index.js + 浏览器半边 lib/client.js），安装到 profile 后重启 DSH 即常驻生效。

方式一：从 GitHub 安装（推荐）

dsh plugin --profile web add github:Heldea-xianmiao/dsh-plugin-notification-sounds#main

方式二：本地源码链接安装

git clone https://github.com/Heldea-xianmiao/dsh-plugin-notification-sounds.git
dsh plugin --profile web add link:<仓库目录>

后续更新本地源码版：git -C <仓库目录> pull --ff-only，然后重启 DSH。

安装后重启 dsh web，打开 设置 → 提示音 Sounds 即可配置。

目录结构

├── lib/
│   ├── index.js    # Host 半边（事件监听、HTTP API、音效合成与持久化）
│   └── client.js   # 浏览器半边（设置面板、音频播放、上传）
├── assets/         # 5 个默认音效的 WAV 文件（由脚本生成）
├── scripts/
│   └── gen-default-sounds.mjs  # 重新生成默认音效：npm run gen:sounds
├── src/            # 动态插件版源码（cordis_define 用，旧格式）
├── cordis.patch.yml
├── package.json
└── README.md

License

[MIT](./LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category