Introduction¶

When using DeepSeek Harness (DSH), there is no immediate visual or auditory feedback after a task round completes or when the model is blocked waiting for input. dsh-task-ask-notify is a DSH host-side plugin that addresses this issue by using native Windows 11 notifications and an audible WAV prompt. When the model returns control or calls ask_user_question, the plugin immediately sends an alert without excessive delay.

Core Features¶

The plugin provides the following capabilities:

• Windows 11 notifications: Displays real system notifications in the Action Center and respects your Windows Focus Assist settings.
• WAV prompt sound: Plays an alert sound, with support for a custom sound directory and equally probable random playback.
• Configuration methods: Supports configuration via a config file or the DSH plugin UI.
• Self-test tool: Includes an adapter self-test tool to verify that basic functionality works correctly.

Installation and Enablement¶

The installation process is completed through DSH’s plugin manager. The plugin itself does not require Node.js to run; Node.js is only used for the bundled tools.

1. Prepare the code
   Place the code in the DSH plugin directory. An example path is:
   %USERPROFILE%\.dsh\dsh-plugins\dsh-task-ask-notify
   The placement does not affect functionality; DSH reads the plugin information through plugin_manager.

2. Install the Bundle
   Run the following command in DSH to install the Bundle into the current Profile:

    plugin_manager install_bundle %USERPROFILE%\.dsh\dsh-plugins\dsh-task-ask-notify

If the command returns `application: "applied"`, it takes effect; if it returns `restart-required`, restart DSH.

3. Verify the installation
   Run the self-test tool to confirm basic capabilities:

    node tools/win-alert-selftest.mjs

An exit code of `0` indicates the self-test passed. Then start a task and let it complete, or have the model ask a question, and observe whether you receive a notification and prompt sound.

Typical Usage¶

The plugin includes a few Node.js tools for managing sounds and testing:

• Run the self-test: node tools/win-alert-selftest.mjs
• Import sounds: Copy an external asset package into the plugin data directory:

    node tools/import-audio.mjs --source "<你的素材包路径>"

The import tool performs SHA-256 validation on the files and writes them by default to `%DSH_HOME%\plugin-data\dsh-task-ask-notify\`; changes take effect without reinstalling.

• Generate the default prompt: Generate the fallback audio/_default/chime.wav:

    node tools/gen-default-chime.mjs --check

Environment and Notes¶

Before use, ensure your environment meets the following requirements:

• Operating system: Windows 10 2004 or later, or Windows 11.
• DSH version: 0.2.0-rc.2 or later (requires host plugin Config and session/event interfaces).
• PowerShell: the built-in Windows PowerShell 5.1.
• Node.js: 20 or later, used only for running tests and bundled tools; the plugin itself does not require Node.js to run.

Known considerations:

• Silent failure: If there is no response at all, the AUMID may not be registered in the Start Menu. In that case, Windows accepts the toast but does not display it.
• Adapter launch mode: The adapter must not be started with detached: true; otherwise, Windows will discard the notification.

Conclusion¶

This plugin adds system-level notification capabilities to DSH, making task status feedback clearer. For more configuration options, the sound directory structure, and troubleshooting methods, refer to the GitHub repository.