dsh-peak
dsh-peak is a lightweight, theme-adaptive status indicator plugin for DeepSeek Harness (DSH).
DeepSeek API offers a 50% discount on token pricing during off-peak hours. dsh-peak integrates directly into the DSH Web UI header right next to your session mode tag, showing real-time discount status, dynamic transition countdowns, multi-timezone clocks, and DeepSeek-V4 model rate cards.
Features
- Understated & Native Design: Built using DSH design tokens (
--dsw-*), allowing it to automatically blend with any active skin or theme (including dark, light, and custom monorepo skins like maid-atelier).
- Seamless Header Integration: Placed directly to the right of the session title and mode tag, participating in normal header flex flow without overlapping action buttons.
- Accurate Real-Time Status: Millisecond-accurate evaluation of DeepSeek's official UTC peak/off-peak windows with live countdown timers (
● Off-peak · 10h 32m / ● Peak · 1h 14m).
- Interactive Details Popover: Click the badge to open a floating panel with synchronized UTC (billing standard), Beijing (CST / UTC+8), and Local browser clocks.
- DeepSeek-V4 Rate Matrix: Reference pricing for DeepSeek-V4 Flash and DeepSeek-V4 Pro across Cache Hit, Cache Miss, and Output tokens.
- Strict Cordis Lifecycle Hygiene: Zero orphan timers or DOM leaks on hot-reload or plugin disposal via
ctx.effect(() => () => { ... }).
- Integrated AI Agent Skill: Includes
.agents/skills/dsh-peak-install for automated AI installation and scheduling.
- Zero-Build Distribution: Ships pre-compiled in
lib/ for instant installation without local compiler requirements.
DeepSeek API Peak & Off-Peak Schedule
DeepSeek API pricing is evaluated against UTC Standard Time:
| Window | UTC Time | Beijing Time (CST / UTC+8) | Pricing Rate | Status |
|---|
| Morning Off-Peak | 00:00 – 01:00 UTC | 08:00 – 09:00 CST | 50% Discount | Off-peak |
| Morning Peak | 01:00 – 04:00 UTC | 09:00 – 12:00 CST | Standard (100%) | Peak |
| Midday Off-Peak | 04:00 – 06:00 UTC | 12:00 – 14:00 CST | 50% Discount | Off-peak |
| Afternoon Peak | 06:00 – 10:00 UTC | 14:00 – 18:00 CST | Standard (100%) | Peak |
| Evening / Night Off-Peak | 10:00 – 24:00 UTC | 18:00 – 08:00 (+1d) | 50% Discount | Off-peak |
DeepSeek-V4 Token Pricing Reference
Rates per 1 Million tokens in USD:
| Model | Token Type | Peak Rate | Off-Peak Rate (50% OFF) |
|---|
| DeepSeek-V4 Flash | Input (Cache Hit) | $0.014 | $0.007 |
| Input (Cache Miss) | $0.440 | $0.220 |
| Output | $1.320 | $0.660 |
| DeepSeek-V4 Pro | Input (Cache Hit) | $0.044 | $0.022 |
| Input (Cache Miss) | $1.320 | $0.660 |
| Output | $3.960 | $1.980 |
Installation
Method 1: DSH CLI (Recommended)
In your deepseek-harness root directory, run:
pnpm dsh plugin --profile web add github:ibrhr/dsh-peak
The DSH CLI will automatically register @dsh-external/dsh-peak into your profile's dsh.profile.bundles.
Method 2: AI Agent Automation
Since this repository ships with an agent skill, prompt your DSH Agent:
"Install this plugin: https://github.com/ibrhr/dsh-peak"
Method 3: Manual Profile Setup
- Add
@dsh-external/dsh-peak to ~/.dsh/profiles/web/package.json:
{
"dependencies": {
"@dsh-external/dsh-peak": "github:ibrhr/dsh-peak"
}
}
- Add the bundle entry into
dsh.profile.bundles:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@dsh-external/dsh-peak"
]
}
}
}
- Run
pnpm install in ~/.dsh/profiles/web and restart dsh web.
Development & Testing
# Install dependencies
pnpm install
# Run Vitest test suites
pnpm test
# Type check
pnpm run typecheck
# Build pre-compiled bundles to lib/
pnpm run build
License & Attribution
This project is licensed under the BSD-3-Clause License.
For architectural invariants and Cordis effect lifecycle rules, see AGENTS.md.
