Introduction¶

The philosophy of DSH is “everything is a plugin.” When multiple sessions are open in a workspace simultaneously, and each session has several sub-agents attached to it, it is hard to quickly determine which sessions are waiting for you to process, which are still running, which have just finished, and how many tokens have been spent during this time. dsh-plugin-task-radar (maintainer: hualidan42-beep) turns this into a draggable, collapsible floating window, plus a main workspace panel. Below, we introduce its positioning, features, installation, and usage methods.

What is it¶

One-sentence positioning: A client-side plugin for DSH Web that displays session status, sub-agents, to-dos, and token usage grouped by workspace; clicking an item jumps directly to the corresponding session.

Maintainer: hualidan42-beep. Category: Client-side. Stars: 0. The current package version is 0.10.0, as defined in package.json. It solves the problem: The native DSH interface lacks a status panel specifically designed for “multi-session parallelism + sub-agents + token observation,” requiring developers to switch back and forth between sessions to piece together progress and usage.

Core Features¶

First, let’s list the capabilities the plugin has already implemented:

• View sessions by workspace; statuses are divided into four categories: Awaiting Processing, Running, Just Completed, and Idle.
• Display to-do lists, sub-agents, model tags, and token usage; clicking an item jumps directly to the session.
• Record local token increments for today, this week, and this month; the first observation only establishes a baseline and does not fill in historical usage.
• Optional system notifications, floating window appearance, and theme illustrations; “Osmanthus Moon Rabbit” is the default on first installation.
• Border thickness (0–3px) and color are adjustable; they follow the theme by default and can be reset to defaults with one click.
• Frame size can be adjusted by dragging the handle in the bottom-right corner; the range is 240–560 × 160–760, and it resets on double-click.
• Disturbance control: Mute a specific session for 1 hour, “I confirm this task is done” to finish work instantly, or stop system notifications for the rest of the day.
• Optional linkage with dsh-plugin-skin; if that skin plugin is not installed, task monitoring and floating window appearance can still be used independently.

Installation and Activation¶

Installation consists of two steps: first, add the index source, then install from the market.

1. Open DSH’s “Plugins → Experimental Plugins → More” and enable “Custom Plugin Market”.

2. Go to “Discover → Manage Index Sources” and add the author’s own index address below:

https://raw.githubusercontent.com/hualidan42-beep/dsh-plugin-task-radar/main/market-index.json

It should be noted that this is just the author’s custom index, not the official DSH market. Each version in the index points to the precise version number on npm and records the actual release time.

3. Find “Work Assistant” in the market and click to install. You can also install the npm package directly:

dsh plugin --profile <你的-profile> add "dsh-plugin-task-radar@0.10.0"

After installing the bundle, it is enabled by default. Whether a refresh or restart is needed depends on the host’s prompt. Manual junction creation is not required, nor is overwriting the profile file.

How to Use After Activation¶

After installation, the floating window appears on the interface by default. Common operations are concentrated in three things.

The first is checking status and changing appearance. Sessions are grouped by workspace; opening them reveals sub-agents, model tags, and token usage. Dragging the bottom-right handle changes the frame size; double-clicking resets it; border color and thickness are adjusted in appearance settings.

The second is adding disturbance control. If a specific session doesn’t need reminders for now, mute it for 1 hour; if a task is confirmed done, use “I confirm this task is done” to finish work instantly; if you don’t want system notifications popping up today, enable “Do Not Disturb”.

The third is viewing the token ledger. The main panel provides incremental views for today, this week, and this month. The plugin only records changes after the observation starts and does not perform historical back-calculation. Therefore, numbers start from a zero baseline during first use and only gain reference value after observing for a while.

Data and Permissions¶

The plugin reads only data already issued by the host: workspaces, session status, to-dos, sub-agents, and token projections. It does not register Host routes, write to business directories, call models, or actively upload session data to external services.

Local settings and records are stored under the dsh-plugin-task-radar/v1 key in browser localStorage, including floating window position, appearance, read status and timing records, and usage ledger. System notifications require manual user authorization, and session titles may appear in notification content.

Two points need attention: Clearing current browser site data will also clear plugin records, and uninstalling the plugin will not automatically delete these browser data. Token ledger is only an observation record, not a bill.

Applicable Scenarios and Notes¶

Suitable for: Mainly for developers using DSH Web who maintain multiple sessions and sub-agents simultaneously and wish to have a permanent floating window for progress and usage observation. The repository’s verification commands npm run verify and npm pack --dry-run --ignore-scripts require Node.js >= 18, but user-side installation does not require Node to be installed locally.

Known limitations are listed below as per the README:

• Only Chinese interface, targeted at DSH Web, requires modern browser support for CSS features like relative color and color-mix.
• No compatibility guarantee has been claimed for specific DSH version ranges, nor has installation acceptance been completed in a clean profile.
• Parent session timing starts from when the plugin begins observation; to-do content is maintained by the agent, and it is not guaranteed that all will be checked off upon completion.
• Token details are retained for up to 400 days, using the local timezone; they are not inherited when clearing cache or changing browsers.
• If the host projection is missing, related details may not be displayed.

Pre-installation advice: The plugin runs with the permissions of the current DSH process; source code and license should be checked before installation. The package configuration declares MIT, but this declaration applies to code the author is authorized to license; rights for third-party materials or characters still belong to their respective rights holders. The repository does not contain developer machine workspaces or business data; images are embedded in client.js.

Summary¶

The value of this plugin lies in gathering scattered session progress and usage information into a draggable, collapsible floating window, reducing the cost of switching back and forth between multiple sessions. It does not replace the native DSH list but rather serves as a permanent observation panel kept at hand.

Directory page: https://www.skillhub.cn/plugins/hualidan42-beep/dsh-plugin-task-radar

Repository: https://github.com/hualidan42-beep/dsh-plugin-task-radar