前言¶
在 DSH 的使用中，agent 有时会向用户提问、发起审批申请，或完成一轮任务。如果界面没有声音提醒，这些状态变化容易被忽略。DSH 强调「一切皆插件」，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
下面介绍 dsh-sound-notify：一个 DSH web 插件，用于在 agent 提问、发起审批申请或完成一轮任务时播放提示音，并让面板使用自定义主背景。
这是什么¶
dsh-sound-notify 是一个 DSH web 插件。README 标题为 dsh-sound-notify，package.json 中的包名为 @dsharness/dsh-sound-notify，版本为 0.1.0，许可证为 MIT。GitHub 仓库为：
https://github.com/flayteas/dsh-sound-notify
它主要解决两个问题：
1、在 agent 提问、发起审批申请或完成一轮任务时播放提示音。
2、自定义 DSH web 的主背景，包括背景色、背景图片、全局遮罩、侧边栏遮罩与恢复默认。
核心功能¶
提示音¶
- 触发条件：agent 提问、发起审批申请、完成一轮任务。
- 每个触发条件可单独设置音效、音量、重复次数与间隔。
- 音效选项：上扬、下行、叮咚、单声、自定义音频、静音。
- 支持自定义音频及本地音频文件上传。
背景¶
- 支持背景色。
- 支持背景图片 URL 或本地文件上传。
- 支持全局遮罩、侧边栏遮罩与恢复默认。
设置与路由¶
- 设置自动保存到
$DSH_HOME/settings.yaml并实时生效。 - 提供
/plugins/sound-notify/upload上传与/plugins/sound-notify/files/*静态文件路由。 - 本地文件经上传路由保存后，设置中保存返回的 URL。
安装与启用¶
推荐安装¶
推荐安装方式需要 pnpm，并且需要先下载 dsharness-dsh-sound-notify-0.1.0.tgz。当前资料未提供下载地址或 pnpm 获取方式。
先拿到 dsharness-dsh-sound-notify-0.1.0.tgz，再进入该文件所在目录执行：
dsh plugin --profile web add .\dsharness-dsh-sound-notify-0.1.0.tgz
手动安装¶
没有 pnpm 时，可以按下面方式手动安装：
1、把 @dsharness/dsh-sound-notify 整个目录复制到：
$DSH_HOME/profiles/node_modules/@dsharness/dsh-sound-notify
2、在 $DSH_HOME/profiles/web/cordis.patch.yml 追加：
- insert:
- id: sound-notify
name: '@dsharness/dsh-sound-notify'
启用¶
安装后重启 dsh web 并刷新页面。
该插件的 package.json 中 peerDependencies 包含：
@deepseek-ai/schemastery >=3
dsh.bundle.patch 指向：
./cordis.patch.yml
典型用法¶
经过上面的安装步骤并刷新页面后，打开 DSH web 的：
设置 → 个性化
然后配置背景与提示音。
下面介绍几个常见操作：
1、选择内置音效：上扬、下行、叮咚、单声或静音。
2、选择“自定义音频”，上传本地音频文件。
3、配置背景色、背景图片 URL，或上传本地背景文件。
4、配置全局遮罩、侧边栏遮罩，或恢复默认。
改动会自动保存到 $DSH_HOME/settings.yaml，并实时生效。
本地文件经 /plugins/sound-notify/upload 上传，存于：
$DSH_HOME/sound-notify/
设置中只保存返回的 URL。静态文件可通过以下路由访问：
/plugins/sound-notify/files/*
适用场景与注意¶
适合在 DSH web 中工作、希望在关键交互发生时获得声音提醒的开发者。若希望面板外观更贴近个人使用习惯，也可以使用它的背景设置调整主背景。
注意：
1、插件以当前 dsh 进程权限运行。安装前应检查源码与许可证。
2、推荐安装方式需要 pnpm，且当前资料未提供 dsharness-dsh-sound-notify-0.1.0.tgz 下载地址。
3、手动安装需要复制目录，并修改 $DSH_HOME/profiles/web/cordis.patch.yml。
4、本地文件会保存到 $DSH_HOME/sound-notify/，设置中保存的是 URL。
5、许可证为 MIT。
链接¶
GitHub：https://github.com/flayteas/dsh-sound-notify
当前已核实资料未提供目录页 URL。若通过 DSH 社区目录使用，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
