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:

DeepSeek-V4 Token Pricing Reference

Rates per 1 Million tokens in USD:

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.