dsh-work-badge

dsh-work-badge

A tiny badge for the DSH (DeepSeek Harness) web UI that answers one question at a glance: are we in peak hours right now?

English · 简体中文

---

What this plugin does

Once installed, a single small line appears in the top-left corner of the DSH content area, below the Windows menu bar and just above the DeepSeek brand, showing the current period in real time:

In one sentence: "峰" means you are inside peak hours, "谷" means off-peak. With the English UI text enabled the badge reads Work hours: Peak / Work hours: Off-peak instead.

That label is the plugin's entire job. It is deliberately minimal:

• It only reports state. It does not change anything in DSH: no input handling, no model settings, no access to conversation content.
• It never blocks clicks. The label lives in a frame-wide floating layer with pointer-events: none, so clicking a brand or icon underneath it works exactly as before.
• It stays out of the way. 10 px text on a rounded translucent pill, pinned below the Windows menu bar in the top-left corner, unaffected by sidebar or conversation-list scrolling.
• Bilingual. The UI text follows the browser language by default, and can be pinned to Chinese or English with one constant (see below).

How the period is decided

• The clock is always Beijing time (UTC+8, fixed offset, no DST) — independent of your machine's timezone. Change your system timezone or travel abroad and it still reads correctly.
• Only Monday to Friday counts as peak; Saturdays and Sundays are off-peak all day.
• Evaluated by the minute, start inclusive and end exclusive: 9:00 is peak, 11:59 is still peak, and 12:00 is already off-peak.
• Period changes (12:00 / 14:00 / 18:00) are reflected within half a minute.

Default schedule:

The windows are plain constants in the source, so re-targeting them takes one edit — see "Customizing".

UI language (Chinese / English)

The badge ships both wordings. Open lib/client.js and edit the constant near the top of the file:

const LANG = "auto";

With English text the badge renders Work hours: followed by a bold Peak or Off-peak, and the hover tooltip switches to English as well.

Installation

From GitHub (recommended)

dsh plugin --profile web add github:banana770/dsh-work-badge

From a local checkout

dsh plugin --profile web add /path/to/dsh-work-badge

After installing, reload the DSH UI (restart DSH or refresh the page with Ctrl+R) and the badge appears in the top-left corner, below the menu bar.

Manual installation

The plugin is small — four files matter:

package.json       manifest: declares the client entry (dsh.client) and the bundle patch
cordis.patch.yml   mounts the plugin into the profile's bundle roster (insert: work-badge)
lib/index.js       host half: an empty no-op that keeps the loader entry alive
lib/client.js      the real logic: registers the top-left label into the shell.overlay slot

Drop the whole directory into the profile's install location and make sure the insert entry in cordis.patch.yml (id: work-badge, name: dsh-work-badge) is active. There is no build step.

Uninstalling

Remove dsh-work-badge from the Installed list on the sidebar Plugins page (the remove action on the component row), then reload the UI. For a manual install, delete the matching insert entry from cordis.patch.yml and restart DSH.

Customizing

Refresh cost

The badge recomputes in exactly three situations: on mount, when the browser tab becomes visible again, and once every 30 seconds. It costs essentially nothing, a period switch lags at most half a minute, and a tab that spent a long time in the background corrects itself the moment you return to it.

Privacy

• Local computation only: system clock arithmetic only. No network calls, no telemetry, no data leaves the machine.
• No file access, and no contact with conversation content, model configuration, or credentials.
• No API keys are included in or needed by this plugin.
• It adds one read-only, pointer-events: none label to the UI and touches nothing else in DSH.

Compatibility

• Targets the DSH web profile (platform: "web"); verified running on DSH desktop 0.4.2 (the label automatically avoids the Windows menu bar).
• Depends on the DSH shell.overlay client slot and on the react that DSH itself provides (declared as peerDependencies: ^18.2.0, so a second copy is never installed).
• Zero host-side dependencies: lib/index.js is an empty plugin.
• No build step: lib/client.js is the final, directly mountable bundle.

License

MIT — use, modify and redistribute freely.