配置

设置 → 音效。可配置项：

设置	默认值	说明
启用音效	开	总开关
音量	55%	0–100%
音色包	`zen`	12 种整体音色，一键切换整套性格
任务音	开	`task.start` / `success` / `failure` 三类
按钮音	开	所有 `click.*`
提醒音	开	`task.pending`
每情景 cue	见上表	每个情景独立下拉选择 + 试听按钮

持久化落点（可直接手改，改完刷新页面生效）：

%USERPROFILE%\.dsh\ui-sound\config.json

{
  "enabled": true,
  "volume": 0.55,
  "pack": "zen",
  "taskSounds": true,
  "clickSounds": true,
  "attentionSounds": true,
  "mapping": { "task.success": "complete", "click.send": "send" }
}

宿主半会校验并裁剪这个文件：音量夹到 0–1，未知音色包回落到 zen，未知 cue 回落到该情景的默认值—— 一个手滑写错的键不会让其它配置一起失效。设置页的改动也写回同一个文件，所以清浏览器数据不会丢配置。

12 个音色包

minimal（干练精确） / soft（圆润温暖） / glass（明亮清脆） / arcade（像素游戏） / mechanical（机械硬朗） / organic（木石水声） / dreamy（空灵慢速） / scifi（全息数字） / rubber（弹性俏皮） / cinematic（深沉大片） / studio（克制精准） / zen（纸、木、风铃，默认）

dsh-ui-sound

설치

문서

配置

12 个音色包