dsh-session-sound

会话提示音 · Session Sound Alert

Session pause & completion sounds for the DeepSeek Harness Web UI — 15 Ubuntu Yaru sounds, independently configurable, persistent across restarts.

DeepSeek Harness Web 端会话暂停/结束提示音插件：内置 15 个 Ubuntu Yaru 音效，两种提示音独立配置，随 DSH 启动常驻。

Features / 特性

• Pause & end alerts / 暂停与结束双提示：会话暂停（ask_user_question 提问选项、approval/requested 计划审核/审批等）播放「暂停音」；一轮会话结束（agent 由 running 转 idle）播放「结束音」。
• Ubuntu Yaru sound set / Yaru 音效可选：内置 Ubuntu Yaru 声音主题 15 个音效（遵循 freedesktop 声音命名规范），暂停/结束各自独立下拉挑选，默认分别为 message-new-instant、complete。
• Persistent / 持久化：静态 Cordis 插件包，随 DSH profile 启动自动装载 —— 重启后无需任何手动操作。
• No hardcoded paths / 无硬编码路径：音效由宿主 half 从包内 assets/（import.meta.url 定位）经 /dsh-session-sound/assets 路由伺服，任意机器、任意安装位置均可用。
• Graceful degradation / 三级降级：包内路由（同源 fetch → decodeAudioData）→ jsDelivr CDN（``）→ 合成音。
• Tunable synth fallback / 合成音兜底：每种行为也可切换为可调合成音（频率 / 时长 / 次数）。
• Zero-intrusion / 零侵入：仅注册一个设置页（侧边栏「设置 → 🔔 会话提示音」）+ 一个静态资源路由，不改动任何内置包。
• Self-cleaning / 自清理：插件卸载时自动解除会话监听、取消定时器、移除样式与槽位注册。

Requirements / 环境要求

• DSH Web（dsh --profile web），浏览器需支持 Web Audio decodeAudioData（Chrome / Edge / Firefox，及 Safari 17.4+；旧版 Safari 自动回退为 `` 在线源或合成音）。
• 需要一次 DSH 重启使插件装载（安装后首次）。

Install / 安装

在 DSH 安装机上，把本仓库 checkout 到任意位置，然后：

bash install.sh
systemctl --user restart dsh-web

脚本是幂等的：重复执行会跳过已完成的步骤。它完成两件事：

1. 将包（package.json + lib/ + assets/）复制到 ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-session-sound/；
2. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加注册行（缺失时创建文件）。

环境变量覆盖：DSH_HOME（默认 $HOME/.dsh）、PROFILE（默认 web）。

手动安装

# 1. 复制包
mkdir -p ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-session-sound/{lib,assets}
cp package.json ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-session-sound/
cp lib/index.js lib/client.js ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-session-sound/lib/
cp assets/*.oga assets/NOTICE.md ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-session-sound/assets/

# 2. 编辑 ~/.dsh/profiles/web/cordis.patch.yml 追加：
#    - insert:
#        - id: dsh-session-sound
#          name: '@deepseek-ai/dsh-session-sound'

# 3. 重启
systemctl --user restart dsh-web