Introduction

When developing with DSH or using agents, changes in conversation state (such as task completion or waiting for user input) may occur silently. To address the risk of missing important notifications, we introduce roger-yang-cn/dsh-voice-alert. This is a DSH browser plugin designed to help users stay aware of conversation state through auditory and visual feedback.

What It Is

dsh-voice-alert is a client-side plugin maintained by Roger-Yang-CN. By monitoring conversation status, it provides voice prompts, in-page toasts, and system notifications when specific events are triggered.

Core Features

This plugin provides the following capabilities:

  1. Voice Playback: When any session completes a task (turn ends) or requests user input, it plays the specified voice prompt.
  2. Top Toast Bar: Displays a toast bar at the top of the page. It automatically disappears after 6 seconds and can be closed by clicking.
  3. System Notifications: When the page loses focus or is minimized, it sends a system notification. Clicking it returns to DSH.
  4. Voice Assets: Includes the “Qianzhi” voice. Custom replacement is supported; the file name must remain unchanged.

Install and Enable

Because the plugin uses file: dependencies and pnpm does not automatically refresh this type of dependency, you need to manually sync the plugin copy.

  1. Clone the repository: Clone roger-yang-cn/dsh-voice-alert to any local directory.
  2. Configure dependencies: Edit the DSH profile package.json (for example, ~/.dsh/profiles/web/package.json) and add the dependency and bundle configuration:
"dependencies": { "dsh-voice-alert": "file:<克隆到的绝对路径>" },
"dsh": { "profile": { "bundles": [ "...", "dsh-voice-alert" ] } }
  1. Install dependencies: Run pnpm install in the profile directory.
  2. Manually sync the plugin copy: Copy the plugin directory’s lib/ and assets/ into node_modules/dsh-voice-alert/.
  3. Restart: Restart DSH. Once the toast bar appears on the page, it is active.

Typical Usage

The plugin automatically monitors conversation status; no extra configuration is required:

  • Task completion: When any session turn ends, it automatically plays the voice and displays the toast bar.
  • Requesting user input: When any session triggers ask_user_question, approval, or solution review, it triggers the voice and toast bar.
  • Custom voice: Replace 任务已完成.wav or 请求决策.wav under assets/ while keeping the file names unchanged to take effect.

Applicable Scenarios and Notes

  • Permissions: The browser requests notification permission on first trigger; allow it to enable the out-of-focus reminder.
  • Dependency mechanism: Be sure to manually copy the plugin’s lib/ and assets/ into node_modules, because pnpm file: dependencies are not automatically refreshed.
  • License: The license is not explicitly stated in the current documentation. It is recommended to check the source code before installing.

Summary

Through voice and toast notifications, this plugin helps users promptly notice changes in DSH conversation state. For more details and the source code, visit GitHub.