DeepSeek Harness plugin

dsh-sound-alert-xcyyan52

声音提示插件:有工作需要手动选择/审查,或任务完成/失败时,播放系统提示音或自定义 wav

Jump to install

Source facts

Repository
xcyyan520/dsh-sound-alert
Latest update
Aug 20, 2026
Category
Workflow & Automation
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-21

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/xcyyan520/dsh-sound-alert
Plugin: dsh-sound-alert-xcyyan52
Author: xcyyan520

Check the source files

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

File explorer2 files
README.mdSource · read only

@dsh-external/dsh-sound-alert

声音提示插件:只要有工作需要手动选择/审查,或者任务完成/失败,就播放声音提醒

功能

触发场景声音类型
agent 调用 ask_user_question / exit_plan_mode 等需要人工选择的工具review(叮-咚)
DSH 任务看板出现「待规划 / 待办」等需要手动处理的任务review(叮-咚)
一轮会话 / 一个任务正常完成done(轻快上行)
一轮会话 / 一个任务失败failed(低频下行)
  • 会话级:监听 DSH 官方 session/event,无需改动 DSH 源码。
  • 任务看板级:浏览器半区监听任务看板 localStorage(dsh.taskBoard.v1),状态变化时上报 host 播放声音。
  • Web 可视化设置:DSH 设置页新增「声音提示」页面,可给每个场景配置 wav、上传音频文件、试听。
  • 声音引擎:默认 Windows 系统蜂鸣;也可配置自定义 wav(支持全局 fallback 或按事件类型单独指定)。

安装

dsh plugin --profile web add link:/abs/path/to/dsh-sound-alert
# 或把包放到 profile bundles 后重启 dsh web

安装后重启 dsh web 生效。

Web 设置页(推荐)

安装并重启后,打开 DSH Web → 设置声音提示

  • 启用声音提示:总开关
  • 同事件冷却 (ms):防连响间隔
  • 需要人工选择/审查:review 音效
  • 任务完成:done 音效
  • 任务失败:failed 音效
  • 全局兜底音效:没单独指定时使用
  • 额外“人工选择”工具:逗号分隔的自定义工具名
  • 每个音效行都有:

- 选择音频…:从本机选 .wav 文件,自动上传到 storages/sounds/ - 试听:立即播放当前场景声音 - 音量滑块:0-100%,保存后试听和真实事件都按该音量播放

  • 保存设置 后实时生效,并持久化到本机 storages/dsh-sound-alert.json

手动 YAML 配置(可选)

Web 设置页保存后会自动写入 storages/dsh-sound-alert.json,一般不需要手动改。若想用配置文件初始化,可以在 %USERPROFILE%\.dsh\settings.yaml 顶部/末尾加:

dsh-sound-alert:
  enabled: true
  cooldownMs: 1200
  fallbackWav: ''
  reviewWav: ''
  doneWav: ''
  failedWav: ''
  manualTools: []

各 wav 留空时使用系统蜂鸣;wav 路径写本机绝对路径,支持中文/空格。

开发

npm run build        # tsc 编 host + tsdown 编 client
dev_build_plugin E:/work/DeepSeek-Harness_work/create01/dsh-sound-alert
dev_inject_plugin E:/work/DeepSeek-Harness_work/create01/dsh-sound-alert