dsh-task-complete-sound

独立的 DeepSeek Harness 插件：agent 一轮任务结束（turn/end）时播放本地系统提示音。 不注册任何模型工具，不访问网络，也绝不会让会话轮次失败。

行为

• 默认只对 reason.kind: completed 的轮次发声；
• 默认跳过子 agent；
• 播放为 fire-and-forget，失败自动尝试下一条命令，全部失败只告警一次。

设置 → 通用

Web profile 中，插件会在「设置 → 通用」里贡献 任务完成提示音 一行。该行可以：

• 选择预设提示音并即时保存到运行中的 host 进程；
• 持久化到 $DSH_HOME/storages/dsh-task-complete-sound.json；
• 点击 试听 通过任务完成时使用的同一播放后端试听当前预设。

内置预设：

glass（默认）、ping、pop、tink、bottle、funk、hero， 另有 muted 静音和 custom 自定义文件。

「自定义」选项会始终出现在通用设置里。选择它后可直接上传音频文件 （支持 .aac、.aif、.aiff、.flac、.m4a、.mp3、.oga、.ogg、 .opus、.wav、.weba，最大 20 MB）。上传文件保存在 $DSH_HOME/storages/dsh-task-complete-sound/，重启后仍然生效。

各平台播放：

• macOS：通过 afplay 播放对应的系统音（失败回退 osascript beep）；
• Windows：每个预设的音调模式会合成为 WAV，用 System.Media.SoundPlayer 在带隐藏控制台的子进程中播放（无控制台进程无法出声，控制台蜂鸣仅作后备）， custom 可播放 .wav；
• Linux：按映射优先选择 freedesktop/ALSA 声音，依次尝试 paplay / pw-play / aplay / ffplay。

安装

推荐：dsh plugin add

需要 PATH 中有 pnpm（安装方式见 https://pnpm.io/installation）。

dsh plugin --profile web add github:Areium/dsh-task-complete-sound

如需固定版本而不是跟随 main：

dsh plugin --profile web add github:Areium/dsh-task-complete-sound#v0.3.1

包内声明了 dsh.bundle.patch，dsh plugin add 会自动在所选 profile 中激活该插件， 无需手工编辑 patch。

手工：本地 checkout

git clone https://github.com/Areium/dsh-task-complete-sound.git

然后在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中追加一行：

- insert:
    - id: task-complete-sound
      name: /absolute/path/to/dsh-task-complete-sound/lib/index.js
      config:
        soundPreset: glass
        events: [completed]
        repeat: 1

安装后完整重启 DSH。

配置

config:
  enabled: true              # false 为静音，无需删除该行
  soundPreset: glass         # glass/ping/pop/tink/bottle/funk/hero/muted/custom
  sound: /path/to/file.wav   # 可选 patch 级自定义文件；Web 上传优先
  events: [completed]        # 触发发声的 turn-end 原因，如 [completed, error]
  repeat: 1                  # 播放次数
  cooldownMs: 0              # 两次提示音的最小间隔（毫秒）
  includeSubagents: false    # 是否同时提示子 agent

测试

npm test