dsh-soundscape 🔊

DeepSeek Harness Web UI 会话声音景观：回合完成庆典（合成号角 + 彩带）、等待审批/回答警示音、错误提示音、发送提示音与可选打字氛围音。零音频资产、零核心改动，并为其他插件提供 ctx.soundscape 服务。

English | 简体中文

DeepSeek Harness（DSH） 的 Web GUI 插件：当 agent 完成一个回合、需要你审批、出错或被中断时，用 WebAudio 实时合成的音效给你反馈，成功回合还会撒彩带庆祝。所有声音由振荡器与包络实时生成——没有音频文件、没有网络请求、不改动任何核心代码，安装即用，可在设置页逐项开关。

✨ 特性

事件	音效	默认
回合开始	发送回弹敲击声 send	✅
回合成功完成	庆祝号角 + 彩带 celebrate（或简洁铃声 ding）	✅
回合出错 / 被中断	低沉蜂鸣 buzz	✅
等待你审批 / 回答 / 评审计划	双音提醒 alert（节流 1.5s）	✅
打开会话	柔和双音问候 greet	⛔
流式输出（可选）	打字氛围音 click（节流 + 随机抖动）	⛔

• 零音频资产：全部 WebAudio 振荡器合成。
• 零核心改动：只走官方 client 插件扩展缝（conversation.input.dock / conversation.session.header.actions / settings.section）。
• 设置持久化：soundscape 设置命名空间，设置页即时保存。
• 跨插件服务：ctx.soundscape.play(name) / ctx.soundscape.celebrate()，其他 client 插件可直接调用。
• HMR 友好：所有注册都是 ctx.effect，热重载自动清理。

📦 安装

前置：已安装 DeepSeek Harness（dsh web 可运行）、Node ≥ 22.19、pnpm。

# 方式一：从 GitHub 仓库安装（推荐先试本地）
dsh plugin --profile web add "github:Blaczz/dsh-soundscape#main"

# 方式二：本地目录安装（开发用）
cd dsh-soundscape && npm install --legacy-peer-deps && npm run build
dsh plugin --profile web add ./dsh-soundscape

# 方式三：本地 link 安装
dsh plugin --profile web add link:./dsh-soundscape

安装后重启 dsh web（新增插件行需要重启一次；之后源码变更走 HMR）。

Git 安装需要 allowBuilds 授权：首次 失败时，按 dsh 提示把包 key 写入 的 再重跑；或直接发布 npm 包避免构建授权。