DeepSeek Harness 插件

dsh-sound-alert-xcyyan52

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

跳到安装方式

来源信息

GitHub 仓库
xcyyan520/dsh-sound-alert
最近更新
2026年8月20日
分类
自动化与任务
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-21

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/xcyyan520/dsh-sound-alert
插件名:dsh-sound-alert-xcyyan52
作者:xcyyan520

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

@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