Introduction¶
Running agent tasks in the browser with DeepSeek Harness (dsh) often requires waiting tens of seconds or longer for a single turn. If you switch to another window to work, you have to come back and check occasionally to see if the task has finished. dsh-niu-lai uses two sounds to solve this problem: it plays “Mom” from the song “Niu Lai” when you send a message, and plays “Niu Lai” when a task is completed—so you can go back to check the results as soon as you hear “Niu Lai”.
This is also a typical small example of DSH’s “everything is a plugin” philosophy: you don’t need to modify frontend code; installing a plugin adds sound feedback to the conversation.
What is this¶
dsh-niu-lai is a DeepSeek Harness Web plugin maintained by jxwb125646, positioned as a “Niu Lai” meme sound board: sending a message plays the “Mom” audio clip; when a task is completed, the “Niu Lai” audio clip is played.
All logic runs within the browser (Web Audio), and audio clips are embedded in the bundle for distribution. It does not require an API key and does not connect to any external services. The code is licensed under the MIT License.
Core Features¶
The browser-side plugin listens to conversation snapshots for each session and triggers based on node types:
- A new
userorsteeringmessage node appears → Play “Mom” clip - Turn ends (assistant message is finalized, or the turn ends with an error) → Play “Niu Lai” clip
The configuration entry is in Settings → Plugins → Niu Lai sounds (Niu Lai sounds), providing:
- A master switch and volume slider
- Each audio clip supports preview, replacement, and restore default. When replacing, you can select any local audio file, which is saved in the browser and persists after a restart
To avoid spamming, the plugin includes built-in debounce rules:
- Opening a session, history pagination, or reconnection does not trigger playback
- Each turn only plays once
- Playback is not triggered while the session is still loading
- Only one clip plays at a time; new sounds interrupt currently playing sounds—for example, if the reply is fast, “Niu Lai” will cut off the unfinished “Mom”
Installation and Usage¶
It is recommended to install via the GitHub source (this command is currently available):
dsh plugin --profile web add github:jxwb125646/dsh-niu-lai
After installation, restart dsh web and refresh the page for it to take effect.
The README also lists an installation command from npm dsh plugin --profile web add dsh-niu-lai, but notes it as “once published”. Please refer to the latest instructions in the repository to see if it is currently available.
Uninstalling is also a single command:
dsh plugin --profile web remove dsh-niu-lai
Typical Usage¶
Configuring Sound Effects¶
Open Settings → Plugins → Niu Lai sounds (Niu Lai sounds). First, set the master switch and volume, then preview the “Mom” and “Niu Lai” clips separately. If the default clips are not suitable, you can directly replace them with your own recordings: simply select a local audio file; the file is stored in the browser and is not lost after a restart. To switch back to default, click Restore Default.
Building from Source¶
The committed lib/ in the repository is pre-built for dsh 0.1.x and generally does not require you to compile it yourself. If you modify the code, rebuild it following these three steps:
npm install
npm run embed-audio # Convert assets/*.mp3 to base64 data URLs and embed them into the bundle
npm run build # tsdown generates lib/host.js + lib/client.js
npm run embed-audio is responsible for converting audio assets to base64 data URLs and writing them into the source code, while npm run build uses tsdown to output two separate files: the host side and the browser side.
Use Cases and Notes¶
Suitable for using DSH Web in a browser without constantly staring at the page waiting for task results; also suitable for those who want to add sound feedback to their workflow, provided they don’t mind it being a meme. Pay attention to the following points before use:
- The plugin runs with the permissions of the current dsh process. It is recommended to read the source code and license before installing to confirm there are no issues.
- The code is under the MIT License, but the movie audio clips from “Niu Lai” are not covered by the MIT License of this repository (see NOTICE.md in the repository) and should not be used commercially. This is an unofficial fan entertainment project; if this bothers you, replace them with your own recordings in the settings.
- The browser requires a click or key press to unlock audio—sending a message counts as this, so normal usage is not affected.
- Each open page tab will play its own sound, so opening multiple tabs will result in distinct sounds.
- The committed
lib/is pre-built for dsh 0.1.x. If your dsh version differs significantly, you may need to rebuild from source.
Summary¶
dsh-niu-lai doesn’t solve any major problems; it simply adds two alert sounds to DSH Web sessions: “Mom” when sending a message, and “Niu Lai” when a task is completed. Installation is one line of code, and uninstallation is also one line of code. All audio is embedded and does not require an internet connection. If you need a task completion reminder, you can give it a try.
- GitHub Repository: https://github.com/jxwb125646/dsh-niu-lai
- Community Directory Page: https://www.skillhub.cn/plugins/jxwb125646/dsh-niu-lai
Note: The community directory mentioned above is an independent site and has no official affiliation with DeepSeek or Huanfang.