dsh-plugin-uisfx
dsh 插件：由 uisfx 提供支持的语义化 UI 音效——按场景提示音，带设置界面
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-uisfx@0.1.1
Plugin Uisfx 以 dsh-plugin-uisfx 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个 dsh 插件：把 uisfx 的语义化 UI 音效带进 DeepSeek Harness。 任务开始 / 成功 / 失败、按钮点击，全都可以在设置页里按情景挑选音效，并即时试听。
dsh 默认几乎没有反馈音。任务跑完了？失败了吗？按钮有没有点中？只能靠眼睛确认。
dsh-plugin-uisfx 提供一套语义化音效系统：
settings.yaml，重启不丢已发布到 npm：dsh-plugin-uisfx
dsh plugin --profile web add dsh-plugin-uisfx
# 重启 dsh web
固定版本安装：
dsh plugin --profile web add dsh-plugin-uisfx@0.1.0
然后打开 设置 → 音效。
需要 dsh
0.1.0-rc.6。已与dsh-better-sidebar、@dsh-external/dsh-navbar同装验证。
| 功能 | 说明 |
|---|---|
| 🎚 全局音色包 | uisfx 12 种音色（zen / studio / scifi / soft ...），一键切换 |
| 🎯 情景映射 | 11 个情景各自映射一个 cue，默认已经配好 |
| ▶ 即时试听 | 设置页每个情景旁都有试听按钮，不用保存就能听 |
| 🔔 任务反馈 | 当前会话运行开始/成功/失败/待处理，自动触发 |
| 🖱 按钮反馈 | 自动识别发送/删除/开关/链接/主要按钮等 |
| 💾 持久化 | settings.yaml 的 dsh-plugin-uisfx namespace，重启不丢 |
| 🔌 服务化 | 暴露 ctx.uisfx，其他插件可调用 |
| 情景 | cue | 触发场景 |
|---|---|---|
task.start | start | agent 开始运行 |
task.success | success | 任务正常结束 |
task.failure | error | 任务失败 |
task.pending | notification | 出现待处理交互 |
click.normal | press | 普通按钮 |
click.primary | select | 主要/强调按钮 |
click.toggle | toggle-on | 开关、checkbox |
click.send | send | 发送/提交 |
click.close | close | 关闭/取消 |
click.danger | delete | 删除/危险操作 |
click.link | open | 链接 |
默认音色包：zen（安静、纸感、木质感，适合长时间使用）。
| 包 | 风格 | 适合 |
|---|---|---|
minimal | 干练、精确 | 生产力工具 |
soft | 圆润、温暖 | 移动端 / 友好产品 |
glass | 明亮、清脆 | 媒体 / 金融 |
arcade | 像素风 | 游戏化 |
mechanical | 机械、硬朗 | 开发工具 |
organic | 木头 / 水声 | 教育 / 儿童 |
dreamy | 空灵、慢速 | 创意工具 |
scifi | 全息、数字感 | AI 工具 |
rubber | 弹性、俏皮 | 休闲产品 |
cinematic | 深沉、大片感 | 媒体 / 游戏 |
studio | 克制、精准 | 音视频 / AI 创作 |
zen | 纸、木、风铃 | 专注 / 阅读 / 默认 |
完整试听：https://uisfx.com
| 设置 | 默认值 | 说明 |
|---|---|---|
enabled | true | 总开关 |
volume | 0.55 | 音量 0-1 |
pack | zen | 全局音色包 |
taskSounds | true | 任务音总开关 |
clickSounds | true | 按钮音总开关 |
attentionSounds | true | 待处理提醒音开关 |
mapping.* | 见上表 | 每个情景的 cue |
所有设置都写入 Host settings.yaml：
dsh-plugin-uisfx:
enabled: true
volume: 0.55
pack: zen
其他 dsh 插件可以这样触发音效：
// 按情景播放
ctx.uisfx.play('task.success')
ctx.uisfx.play('click.send')
ctx.uisfx.play('task.start')
// 直接播放某个 cue
ctx.uisfx.playCue('achievement')
ctx.uisfx.playCue('reward')
// 设置页试听
ctx.uisfx.preview('success')
// 读取/修改设置
ctx.uisfx.getPrefs()
ctx.uisfx.setPack('studio')
ctx.uisfx.setVolume(0.5)
可用 cue 共 78 个，来自 uisfx：
hover / press / select / toggle-on / send / success / error / complete / achievement / ...
ctx.sessions.binding(current).session，监听 running / pending / lastAgentError/uisfx/api/settings API，写入 Host settingslastAgentError 或 turn-error 节点正常情况下不会。若同时安装过旧版临时集成，请恢复官方 ui-theme / ui-conversation 文件。
git clone https://github.com/<your-name>/dsh-plugin-uisfx.git
cd dsh-plugin-uisfx
pnpm install
pnpm build # 生成 lib/client.js / lib/index.js
pnpm check # 语法检查
使用独立 dev profile 验证，避免重启正在使用的 web：
dsh plugin --profile dev add ./dsh-plugin-uisfx
dsh --profile dev web --port 3090
浏览器调试入口：
window.__dshUISFX() // uisfx player
window.__dshUISFXDebug() // 当前 prefs
NOTICE 和 vendor/uisfx-0.4.0.js如果这个插件对你有用，欢迎点个 ⭐，并给仓库加上 dsh-plugin topic。
