dsh-sound-notify

DeepSeek Harness (dsh) 插件：agent 任务完成 / 等待审批时播放提示音

A dsh plugin that plays a sound on the host when an agent finishes its turn or waits for approval.

---

用途 / What it does

当 agent 完成任务（状态从 running 变为 idle），或开始等待审批（session 记录 approval/asked）时，在 宿主端 播放提示音——即使浏览器切到后台也能听到，让你不用一直盯着 GUI。

Plays a sound on the host machine when an agent finishes its turn (running → idle) or starts waiting for your approval (approval/asked) — audible even when the browser is in the background.

特性 / Features

• 任务完成提示 — agent 每轮回复完成响一次
• 审批等待提示 — agent 发起审批请求时响一次，提醒你去 GUI 处理（策略为 never 时自动不响）
• 可配置卡片 — 设置 → 插件 → 插件配置 → "提示音"卡片（与官方 bash / agent-loop / web-search 卡片同级）
• 自定义音源 — 任意 wav / mp3 / ogg 文件；留空使用内置默认音效（assets/default-notify.mp3，直接替换该文件即可换默认音）
• 防抖 — 任务完成与审批等待各自独立防抖窗口，并行事件不轰炸
• 可过滤 — 可选只对顶层 agent 提示（子 agent 不响）
• 安全 — 播放失败只记日志，绝不阻塞或干扰 agent 循环
• 轻依赖 — 宿主端仅依赖 schemastery；client bundle 手写零构建工具链

---

安装 / Installation

环境要求 / Requirements

• DeepSeek Harness（dsh）0.1.0-rc.6 或更新版本
• Windows / macOS / Linux（Windows 体验最佳）
• pnpm（用于安装 link 依赖）

1. 克隆仓库 / Clone the repo

git clone https://github.com/Zyy1997/dsh-sound-notify.git

2. 在 profile 的 package.json 中添加 link 依赖 / Add a link dependency to your profile

编辑 %DSH_HOME%\profiles\web\package.json（或你的 profile 目录）：

{
  "dependencies": {
    "@dsh-external/dsh-sound-notify": "link:"
  }
}

3. 在 profile 的 cordis.patch.yml 中激活 / Activate in the profile patch

- insert:
    - id: sound-notify
      name: '@dsh-external/dsh-sound-notify'
      config:
        sound: ''            # 自定义音频绝对路径；留空用内置默认音效
        volume: 1            # 0..1，仅 MediaPlayer 路径（非 wav）生效
        onlyTopLevel: false  # true 时仅顶层 agent 完成提示
        cooldownMs: 2000     # 防抖窗口（毫秒）
        notifyApproval: true # agent 等待审批时也提示