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

1. Add @dsh-external/dsh-peak to ~/.dsh/profiles/web/package.json:

   {
     "dependencies": {
       "@dsh-external/dsh-peak": "github:ibrhr/dsh-peak"
     }
   }
   

2. Add the bundle entry into dsh.profile.bundles:

   {
     "dsh": {
       "profile": {
         "bundles": [
           "@deepseek-ai/dsh-base",
           "@deepseek-ai/dsh-web-app",
           "@dsh-external/dsh-peak"
         ]
       }
     }
   }
   

3. 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.