Introduction¶

When developing or using DeepSeek Harness daily, you often encounter scenarios where you need to determine the current billing period: API peak and valley prices differ, and the official pricing page describes everything in UTC, requiring you to calculate weekends and statutory holidays yourself when converting to Beijing time. Relying on memory makes it easy to make mistakes, and repeatedly opening web pages to check interrupts your flow. The plugin introduced below turns this into a small badge below the input box: it continuously counts down to the next peak-valley switch based on Beijing time, automatically showing the number of days when crossing weekends or holidays.

This plugin is a community-maintained third-party plugin. The repository is guanzi279-source/dsh-peak-valley-countdown, the directory page is on skillhub.cn, and it has no official affiliation with DeepSeek/Fangfang.

What is this¶

This is a countdown badge registered below the DSH input box, maintained by guanzi279-source, implemented based on the community philosophy that “everything is a plugin.” It does only one thing: display whether the current period is peak or valley, and how long until the next switch. It does not display a price list, nor does it replace the official pricing page; it simply provides an instantly visible local time indicator.

Core Features¶

• The badge is registered in the conversation.composer.dock slot, displayed side-by-side with activity and usage, and does not obscure the input box.
• During valley hours it displays “Distance to Liang Wenfeng …”, and during peak hours it displays “Distance to Liang Wengu …”; refreshed every second.
• Calculated strictly in Beijing time (UTC+8), unaffected by the browser’s time zone.
• Displays the number of days when crossing weekends or statutory holidays; for example, after 18:00 on Friday it displays 2 days 14:00:00.
• Weekends and statutory holidays are calculated as valley hours all day, with an embedded 2026 China statutory holiday table.
• English and Chinese terms, color scheme following light/dark themes; displays current billing rules on mouse hover.
• No internet connection, no file writing, no data reporting, only reads the system clock.

Billing periods are based on the DeepSeek API Pricing Page. The official description is in UTC, while the plugin converts it to UTC+8: peak hours are Monday to Friday 09:00–12:00 and 14:00–18:00, and all other times (including weekends and statutory holidays) are valley hours. DeepSeek may adjust prices and periods, and the official page takes precedence.

The built-in HOLIDAY_RANGES covers the 2026 schedule, based on State Council Invention Telegraph No. 7, 2025: New Year 01-01–01-03, Spring Festival 02-15–02-23, Qingming 04-04–04-06, Labor Day 05-01–05-05, Dragon Boat Festival 06-19–06-21, Mid-Autumn Festival 09-25–09-27, National Day 10-01–10-07. Once the 2027 schedule is announced, you can simply add a date range to HOLIDAY_RANGES; dates not listed are judged as weekdays or weekends.

Installation and Enabling¶

The official website provides two installation methods: from npm and from GitHub source code. The commands are taken from the original README.

Install from npm (Recommended):

dsh plugin --profile web add dsh-peak-valley-countdown

Install from GitHub source:

dsh plugin --profile web add github:guanzi279-source/dsh-peak-valley-countdown

After installation, refresh the page, and the badge will appear below the input box. If the profile you are using is not web, replace --profile web with the actual profile, for example desktop.

Typical Usage¶

No configuration is needed after installation. The badge automatically displays the current period and the remaining countdown; hover the mouse to view peak-valley rules; when the countdown reaches zero, the badge switches to the next period. Taking the current environment as an example, after 18:00 on Friday, the badge will directly display 2 days 14:00:00, indicating the time point for the next entry into a weekday peak hour.

Applicable Scenarios and Notes¶

Suitable for two types of people: first, AI agent developers who plan tasks based on peak-valley price differences and want to confirm which billing period they are currently in; second, daily users of DSH who want to avoid checking prices or converting time zones.

A few points to note:

1. The plugin will load and run with the permissions of the current dsh process during installation; you should check the source code and license before installing. The license for this repository is MIT.
2. Tested and passed on the Web profile of DeepSeek Harness 0.2.1-rc.2, relying on the Web-side conversation.composer.dock slot and locale service (DSH 0.2.x); other versions are not documented in the materials.
3. Pure JavaScript implementation, no build steps, no runtime dependencies, and no build scripts are executed during installation.
4. The holiday table only includes 2026; maintenance is required for cross-year use.

Conclusion¶

The value of this plugin lies in fixing “whether the current period is peak or valley and how long until the switch” next to the input box, reducing the cost of manual conversion and checking pages. It does not connect to the internet, does not report data, and is suitable for those who have high requirements for local rendering.

• Directory Page: https://www.skillhub.cn/plugins/guanzi279-source/dsh-peak-valley-countdown
• GitHub: https://github.com/guanzi279-source/dsh-peak-valley-countdown