DSH (DeepSeek Harness) is suitable for running agents in the background. When an agent triggers an approval prompt or an ask-user-question card, if the page is hidden, users often cannot respond in time. dsh-plugin-noticeme is designed to solve this problem and ensure that signals requiring human intervention can still be received while running in the background.

Plugin Overview

This plugin is maintained by lw-storm and addresses interaction misses caused by the page being invisible during DSH runtime. When the page is in the background and an approval request or question card appears, the plugin attempts to send a desktop notification; if the browser notification permission is denied, it falls back to modifying the tab title.

Core Features

  1. Event Monitoring: The plugin continuously monitors approval/request (approval prompts) and ask_user_question (question cards) in tools/result.
  2. Desktop Notifications: When the page is in the background and the above events are detected, it triggers a browser desktop notification. Clicking the notification focuses the page.
  3. Title Fallback: If browser notification permission is unavailable, the tab title is automatically prefixed with ⚠ 需要你确认 · until the page is visible again.
  4. Polling Mechanism: The client polls every 3 seconds to check for pending requests.
  5. Queue Consumption: The short-lived queue is consumed through the GET /dsh-noticeme/pending endpoint (same-origin access only).

Installation and Enablement

  1. Add the plugin using the official installation command:
    dsh plugin add github:lw-storm/dsh-plugin-noticeme
  1. Restart DSH after installation.
  2. On the first page load, the browser will ask for notification permission. Please choose Allow.

Typical Usage

  • Install and restart DSH.
  • Grant browser notification permission.
  • Run a task that requires approval or a question.
  • Switch the browser tab to the background.
  • The plugin automatically displays a desktop notification. Click the notification to focus the page and continue.

Use Cases and Notes

This plugin is suitable for agent scenarios that involve approval workflows or human interaction. Note that the plugin relies on browser notification permission to work properly.

The plugin runs with the permissions of the current DSH process. Before installing any third-party plugin, it is recommended to review its source code and license (MIT) to ensure it complies with your security requirements.