---

📖 About

dsh-peak-hours-banner keeps a permanent status banner at the top of the chat area in the DSH Web GUI. Based on your computer's clock it splits the day into "peak" and "off-peak" windows anchored on UTC+8, reminding you to watch your API balance — or to take a break.

• 💰 Cost awareness — weekday peak windows explicitly remind you to watch your balance;
• 🍵 Health reminder — off-peak windows tell you to rest and keep a good balance;
• 🌏 Timezone friendly — judgement and the displayed range are both converted to your local timezone;
• 🔒 Zero intrusion — pure front-end: it never reads or uploads any conversation content;
• 🔁 Persistent — installed with the web profile, it survives harness restarts.

🖥️ Display rules

Scenario	Banner shows
Weekdays · 09:00–12:00 (UTC+8)	🔴 Peak hours now (09:00-12:00). Watch your balance usage.
Weekdays · 14:00–18:00 (UTC+8)	🔴 Peak hours now (14:00–18:00). Watch your balance usage.
Weekdays · other times	🟢 Off-peak hours now. Please rest and keep a good balance.
Weekends (UTC+8)	🟢 Off-peak hours now. Please rest and keep a good balance.

Details:

• Boundaries are left-closed, right-open: 9:00 and 14:00 sharp start a peak window; 12:00 and 18:00 sharp start an off-peak period.
• "Weekend" means the UTC+8 day of week; holidays are currently judged by the weekday they fall on.
• The time range in the text is rendered in your local timezone (e.g. a UTC-5 user sees 20:00–23:00).
• Bilingual zh/en text follows the DSH language setting and switches live.
• After crossing a boundary the banner switches within ≤15 seconds — no page reload needed.

📦 Install

Prerequisite: DeepSeek Harness installed, with the Web GUI started at least once (so the web profile exists).

Option 1: one-line dsh install (recommended)

dsh plugin --profile web add github:thrudcoco/dsh-peak-hours-banner

One command: pulls this repository and registers it with the web profile. Prebuilt artifacts are committed, so no local build and no build-script authorization is needed.

Developers can also install from a local checkout (rebuild lib/ and it takes effect on the next restart):

git clone https://github.com/thrudcoco/dsh-peak-hours-banner.git
dsh plugin --profile web add link:dsh-peak-hours-banner/packages/dsh-peak-hours-banner

Option 2: PowerShell one-click script

Requires Node.js ≥ 18.

irm https://raw.githubusercontent.com/thrudcoco/dsh-peak-hours-banner/main/install.ps1 | iex

The script downloads the sources, builds lib/, and installs the bundle through the official dsh plugin --profile web add link:… flow.

Option 3: manual (from source)

git clone https://github.com/thrudcoco/dsh-peak-hours-banner.git
cd dsh-peak-hours-banner
node packages/dsh-peak-hours-banner/scripts/build-client.js          # build lib/
dsh plugin --profile web add link:"$PWD/packages/dsh-peak-hours-banner"

Activate

Restart the DSH process after installing, open any session, and the banner appears at the top center of the chat area.

Uninstall

dsh plugin --profile web remove @thrudcoco/dsh-peak-hours-banner

Then restart the DSH process.

❓ FAQ

Why is my banner a different color than someone else's?

The banner converts your computer's clock into the UTC+8 windows. In different timezones the same instant maps to a different UTC+8 wall time — that is expected.

Do weekends ever show the peak warning?

No. UTC+8 Saturdays and Sundays are all-day off-peak (green); holidays are currently judged by the weekday they fall on.

How long after a boundary does it switch?

≤15 seconds. A 15-second heartbeat watches for minute-boundary changes; even if the tab is throttled or the machine sleeps, the correct state is picked up as soon as it returns.

Does it collect any data?

No. The plugin only reads your local clock and renders text in your browser — it performs no network requests at all.

🧱 Repository layout

dsh-peak-hours-banner/
├── install.ps1                     # PowerShell one-click installer
├── packages/dsh-peak-hours-banner/ # the installable bundle (plugin proper)
│   ├── cordis.patch.yml            #   composition patch: inserts the plugin row
│   ├── package.json                #   dsh.client declaration (platform: web)
│   ├── scripts/build-client.js     #   build: inline core logic → module-loader wrap
│   ├── src/index.js                #   host half (no-op stub)
│   ├── src/client/index.js         #   readable browser-half source
│   ├── lib/                        #   prebuilt artifacts (why github installs need no build)
│   └── README.md / README.zh.md    #   package-level English / Chinese notes
├── src/core.js                     # period logic as pure functions (Node-testable)
├── src/client.template.js          # client template for dynamic debugging
├── scripts/build-client.js         # build script for the dynamic-debug variant
└── test/                           # node:test suite (72 cases)

Build & test commands: see packages/dsh-peak-hours-banner/README.md.

📄 License

Released under the Apache License 2.0.

👤 Creator

• Author: @thrudcoco
• Licensed under Apache License 2.0: free to use, modify and distribute — please keep the license and attribution.
• Community project, not affiliated with DeepSeek. DeepSeek Harness and related names belong to their respective owners.

---

#dsh-plugin