📖 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

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 from npm (recommended)

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

One command: pulls the published bundle from the npm registry and registers it with the web profile. Prebuilt artifacts ship in the package, so no local build and no build-script authorization is needed.

Installing straight from GitHub (dsh plugin --profile web add github:thrudcoco/dsh-peak-hours-banner) also works in principle, but some pnpm versions key git dependencies by repo name, which breaks plugin-row resolution — prefer npm or link:.

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

🧱 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