AI-Galaxy-GPU/dsh-sound1

dsh-sound

DeepSeek Harness plugin: per-event task-completion and attention sounds for turn-end / approval / question / plan-review / goal-blocked / task-failure, each with its own sound (built-in synth, local audio file) and volume (Web UI)

AI Analysis

为 DSH 的各种运行状态(如任务完成、等待审批、报错等)配置个性化声音提醒。适合在后台挂机运行智能体、需要通过听觉反馈及时介入或获知任务进度的用户。

Package
dsh-sound
Version
0.3.3
License
MIT
Last updated
Aug 16, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:AI-Galaxy-GPU/dsh-sound

Configuration storage

  • The browser half persists its configuration in localStorage (key dsh-sound:config), sanitizing every read and filling defaults. Uploaded local music files are stored in IndexedDB (dsh-sound-audio) instead — no localStorage quota limits.
  • Config keys: enabled, quietCurrent, and six sound + six volume fields — completionSound / approvalSound / questionSound / planReviewSound / goalBlockedSound / failureSound (builtin key, none, local, data: URL, or audio:) and completionVolumefailureVolume (0–1). localFiles keeps the last chosen local file per event so switching to a built-in sound and back does not drop it.
  • 0.2.0 migration: older configs are upgraded automatically — defaultSound becomes completionSound, voice/TTS values degrade to the per-event default, and workspaces / debounceMs / global volume / voice settings are dropped.
  • Export / import: the settings panel downloads the full config as JSON (IndexedDB audio references are inlined as data URLs) and restores it from a JSON file — moving browsers or machines does not require reconfiguration.
  • The host half also registers the dsh-sound settings namespace: on rc.6 the settings API allowlist (WEB_SETTINGS_NAMESPACES in dsh-host-apiproxy) does not expose third-party namespaces to browsers, so the client does not depend on settingsScope today; the registration keeps the migration path open for future releases.