🔊 dsh-plugin-uisfx

🌐 English | 中文

A dsh plugin that brings uisfx semantic UI sound effects to DeepSeek Harness. Task start / success / failure and button clicks can each be assigned a sound cue from the settings page, with instant preview.

What it solves

dsh has almost no audio feedback by default. Did the task finish? Did it fail? Did the button register? You can only tell by watching the screen.

dsh-plugin-uisfx adds a semantic sound system:

• Task sounds — start, success, failure, pending attention
• Button sounds — different sounds for different button kinds
• Global sound packs — 12 uisfx packs, switch the whole personality in one click
• Per-scenario cues — every scenario maps to an independent cue, with preview buttons
• Persistent settings — stored in settings.yaml, survives restarts

Preview

Quick start

Published on npm: dsh-plugin-uisfx

dsh plugin --profile web add dsh-plugin-uisfx
# restart dsh web

Pin a version:

dsh plugin --profile web add dsh-plugin-uisfx@0.1.0

Then open Settings → Sound Effects.

Requires dsh 0.1.0-rc.6. Verified alongside dsh-better-sidebar and @dsh-external/dsh-navbar.

Features

Default scenario mapping

Default sound pack: zen — paper, wood and quiet chimes for long working sessions.

Sound packs

Preview every pack: https://uisfx.com

Settings

All settings are written to Host settings.yaml:

dsh-plugin-uisfx:
  enabled: true
  volume: 0.55
  pack: zen

Service API

Other dsh plugins can trigger sounds:

// play by scenario
ctx.uisfx.play('task.success')
ctx.uisfx.play('click.send')
ctx.uisfx.play('task.start')

// play a raw cue
ctx.uisfx.playCue('achievement')
ctx.uisfx.playCue('reward')

// preview from settings
ctx.uisfx.preview('success')

// read / update settings
ctx.uisfx.getPrefs()
ctx.uisfx.setPack('studio')
ctx.uisfx.setVolume(0.5)

There are 78 cues from uisfx: hover / press / select / toggle-on / send / success / error / complete / achievement / ...

Architecture

• No audio files — embeds the uisfx 0.4.0 Web Audio synthesis runtime
• Lazy player — created on the first user gesture, respecting autoplay policies
• Task watcher — subscribes to ctx.sessions.binding(current).session (running / pending / lastAgentError)
• Click classifier — global pointerdown classifier maps semantics to scenarios
• Persistence — dedicated /uisfx/api/settings API backed by Host settings

FAQ

No sound?

1. Settings → Sound Effects → enable sounds
2. The browser may block autoplay: click anywhere on the page once
3. Check the system volume and the dsh volume slider

No success / failure sound after a task?

• Only the current session plays task sounds
• Make sure taskSounds is enabled
• Failure detection uses lastAgentError or turn-error nodes

Development

git clone https://github.com/<your-name>/dsh-plugin-uisfx.git
cd dsh-plugin-uisfx
pnpm install
pnpm build      # generates lib/client.js / lib/index.js
pnpm check      # syntax checks

Use a separate dev profile so restarts never interrupt your daily web:

dsh plugin --profile dev add ./dsh-plugin-uisfx
dsh --profile dev web --port 3090

Browser debug helpers:

window.__dshUISFX()          // uisfx player
window.__dshUISFXDebug()     // current prefs

Roadmap

• [x] Task sounds + button sounds + settings UI + persistence
• [x] All 12 packs and 78 cues selectable
• [ ] Background-session completion notifications
• [ ] Hover / drag / split sounds
• [ ] Per-scenario sound pack
• [ ] Custom audio uploads

License

• This plugin: MIT
• Embedded uisfx runtime: MIT, copyright Yuki Capital — see NOTICE and vendor/uisfx-0.4.0.js

Related projects

• uisfx — the open-source sound system this plugin uses
• DSH-better-sidebar — a powerful dsh sidebar plugin
• dsh-navbar — conversation message navigation dots

If you find this plugin useful, give it a ⭐ and add the dsh-plugin topic to the repo.