配置

优先级（后面的覆盖前面的，按字段逐个生效）：默认值 → profile 里该条目的 config → ~/.dsh/dsh-notify-sound.json → 浏览器 localStorage。

~/.dsh/dsh-notify-sound.json 会压住条目 config（设置页写的就是这个文件），完整字段：

{
  "enabled": true,
  "volume": 0.5,
  "pollMs": 700,
  "turnEnd": true,
  "approval": true,
  "question": true,
  "turnEndReasons": ["completed", "error", "blocked", "max-tokens"],
  "skipSubagents": true,
  "onlyWhenHidden": false,
  "toast": "auto",
  "flashTitle": true
}

字段	默认	含义
`enabled`	`true`	总开关
`volume`	`0.5`	音量 0~1
`pollMs`	`700`	轮询间隔（仅在 SSE 不可用时才用到）
`turnEnd` / `approval` / `question`	`true`	三类触发各自开关
`turnEndReasons`	`completed, error, blocked, max-tokens`	哪些结束原因算“该提醒”；`aborted` / `interrupted` 默认不响，免得自己按了停止还吵
`skipSubagents`	`true`	忽略子代理（subagent / workflow 子会话）的轮次结束，多智能体协作不会连环响
`onlyWhenHidden`	`false`	`true` = 只有页面在后台时才响（最常见的用法）
`toast`	`auto`	`auto`：页面在后台 / 被拦截 / 被静音时显示；`always` 总是；`never` 从不
`flashTitle`	`true`	页面在后台时闪烁标题 `🔔 …`

也可以写进 profile 的 patch（id 要跟挂载 id 一致）：

- id: notify-sound
  name: dsh-notify-sound
  config:
    volume: 0.4
    onlyWhenHidden: true

dsh-notify-sound

同名包的其他仓库

安装

说明文档

配置