峰谷计费时钟 1134478268-dev/dsh-peak-clock

dsh-peak-clock

English · 中文 · Transparency / 透明说明

DeepSeek 峰谷时段指示器 · DeepSeek Harness (DSH) Web 插件为 DeepSeek Harness Web UI 提供峰谷时段、token 用量与消费追踪。

dsh-peak-clock 是 DeepSeek Harness (DSH) Web UI 的插件。它直接在对话头部显示：

- DeepSeek 分时定价的峰时 / 闲时状态（北京时间），并实时倒计时到下一次切换
- 当前对话的 token 用量
- 本次对话的预计消费，以及今日消费（跨所有会话），单位为人民币，按官方分时费率计算

它会自动跟随你的客户端语言（中文 / 英文），并让时钟显示适配你的系统时区。

Example (idle period, Chinese UI)
❤️ 【　当前时段：闲时　】 · 本次对话 ⭐ 33.28M token ⭐ · 预计消费 ¥1.92 · 今日消费 ¥3.46 ❤️
Example (peak period, English UI)
❤️ [ Current: Peak ] · This chat ⭐ 12.5k tokens ⭐ · Est. cost ¥0.42 · Today ¥3.46 ❤️

功能

- 官方闲时规则：北京时间，周一至周五（不含中国法定节假日）09:00-12:00 和 14:00-18:00 为峰时；其余时段——包括 12:00-14:00 午间空档、晚间、周末和节假日——均为闲时，半价计费。
- 识别节假日：内置 2026 年中国法定节假日表（含首尾）。落在周末的调休补班日仍按闲时处理，与官方表述一致。
- 按调用时刻计价：一次对话跨越峰谷时段，或中途切换模型，都能正确计价。
- 识别时区：检测你的系统时区和 UTC 偏移（含夏令时）。峰谷规则始终以北京时间为准（这是计费依据），当本地时间与北京时间不一致时，提示框会并排显示你的本地时间与北京时间。
- 双语：所有 UI 文案都来自 zh / en 字典，跟随客户端语言；缺失的键回退到中文。
- 零运行时依赖，不发起任何外部网络请求，也绝不触碰你的凭据。
- 只读 HTTP API，方便其他插件或脚本查询同样的数据。

安装

from npm (once published)
dsh plugin add dsh-peak-clock

from a local tarball
dsh plugin add ./dsh-peak-clock-<version>.tgz

手动安装：把包解压到该配置档的 node_modules/，在该配置档的 package.json 里把 "dsh-peak-clock" 加入 dsh.profile.bundles 数组，然后刷新 Web UI。

HTTP API（同源、只读，仅支持 GET / HEAD）

| 端点 | 返回 |
| GET /peak-clock/v1/now | 当前时段（peak / idle）、原因（window / off-window / weekend / holiday）、北京时间、你的本地时间、系统时区 + UTC 偏移、下次切换时间戳 |
| GET /peak-clock/v1/session[?id=<sessionId>] | 当前会话的 token 分桶 + 预估费用，今天跨会话总计，系统时区。不带 id 时，取最近活跃的会话 |

// GET /peak-clock/v1/session?id=session-xxxx
{
"ok": true,
"session": {
"sessionId": "session-xxxx", "model": "deepseek-flash", "provider": "deepseek-account",
"calls": 194, "peakCalls": 0,
"tokens": { "input": 118547, "output": 285513, "cacheRead": 32871040, "cacheWrite": 0, "total": 33275100 },
"cost": 1.91802, "currency": "CNY"
},
"today": { "cost": 3.4567, "currency": "CNY", "zone": "Asia/Shanghai", "offsetMinutes": 480, "calls": 42, "sessions": 3 },
"system": { "zone": "Asia/Shanghai", "offsetMinutes": 480 }
}

计价依据

DeepSeek 官方分时段费率（人民币 / 每 1M token；hit = 缓存命中输入，miss = 缓存未命中输入，out = 输出）：

| 模型 | 谷时（hit / miss / out） | 峰时（hit / miss / out） |
| deepseek-flash (DeepSeek-V4.1-Flash) | 0.02 / 1 / 4 | 0.04 / 2 / 8 |
| deepseek-v4-pro | 0.15 / 4.5 / 13.5 | 0.3 / 9 / 27 |

- 用量事件按 (turn, step) 归并：以最后一次累计快照为准，不会重复计数。
- 缓存写入 token 按缓存未命中输入计费。
- 金额只是估算（不含账号级折扣与赠送额度）；以 DeepSeek 官方账单为准。
- 来源：<https://api-docs.deepseek.com/zh-cn/quick_start/pricing/>

开发

npm test # 6 suites, 71 assertions: period logic, pricing, usage, timezone/today, routes, edge cases

| 文件 | 作用 |
| lib/host.js | 宿主端：时段逻辑、计价、时区辅助函数、两个只读路由 |
| lib/client.js | 浏览器端：徽标 UI、i18n 词典、用量轮询 |
| cordis.patch.yml | 加载器补丁，用来挂载插件 |
| test/smoke.mjs | 测试套件（npm test） |

说明

- 透明度：参考了哪些社区插件（API 契约 / 数据格式）、哪些是原创、这个插件永远不会做什么 —— 见 TRANSPARENCY.md。

- 宿主端是 ESM 模块：更新之后必须重启 DSH 一次（Node 会永久缓存 ESM；替换文件、禁用再启用插件行、甚至改入口文件名，都已验证不能*热重载）。浏览器端只需刷新页面。
- 节假日表必须每年从国务院安排刷新一次（两个文件：lib/host.js 和 lib/client.js）。在那之前插件只是偏保守 —— 它会把节假日的周中当成工作日。
- 价格按插件版本固定（不实时拉取），这样历史会话可以用当时生效的费率回放。

致谢

完全由 DeepSeek V4.1-Flash 构建 —— 设计、代码、测试、审计与文档。

许可证

MIT

DeepSeek 峰谷时段指示器 · DeepSeek Harness (DSH) Web 插件在会话头部显示当前处于高峰还是闲时，并统计本次对话的 token 用量、按官方分时价折算的预计消费，以及今日消费（跨会话）。时间显示随时区自动适配本机，并与北京时间对照。

闲时：❤️ 【　当前时段：闲时　】 · 本次对话 ⭐ 33.28M token ⭐ · 预计消费 ¥1.92 · 今日消费 ¥3.46 ❤️ 高峰：❤️ 【　当前时段：高峰　】 · 本次对话 ⭐ 12.5k token ⭐ · 预计消费 ¥0.42 · 今日消费 ¥3.46 ❤️

悬停徽标可查看：本机时间与北京时间（时区不同时并列显示）、距下次切换的时间、今日统计口径、完整计费规则与价格来源。

功能

- 峰谷判断：北京时间周一至周五（不含中国法定节假日）09:00-12:00、14:00-18:00 为高峰时段；其余为闲时（半价）。12:00-14:00 午休空档属于闲时。
- 节假日感知：自动识别周末与中国法定节假日（含首尾日期）；调休上班的周末仍按闲时，与官方口径一致。
- 本次对话用量：token 总量 + 预计消费（人民币），每 15 秒刷新。
- 今日消费：按本机时区当天 00:00 起算，跨会话合计（只统计今天发生的调用）。
- 时区自适应：自动识别本机时区与 UTC 偏移（含夏令时）；峰谷判断始终按官方口径的北京时间，显示则同时给出本机时间。
- 按调用时刻计价：不是整段按一个价，而是按每次调用实际发生时刻的峰谷单价折算；会话中途切换模型也按当时的模型价格计算。
- 零依赖：无运行时依赖、无对外网络请求、不读取任何凭据。
- 只读接口：供其它插件/脚本程序化查询（见下）。

计费口径

价格取自 DeepSeek 官方定价页（元 / 百万 tokens）：

| 模型 | 闲时 命中/未命中/输出 | 高峰 命中/未命中/输出 |
| deepseek-flash（V4.1-Flash） | 0.02 / 1 / 4 | 0.04 / 2 / 8 |
| deepseek-v4-pro | 0.15 / 4.5 / 13.5 | 0.3 / 9 / 27 |

- 同一 (turn, step) 的 usage 是累计快照，只计最后一次（避免重复计数）
- 缓存写入计入"未命中输入"
- 金额为估算，不含账户级优惠/赠送额度，实际以 DeepSeek 账单为准
- 来源：<https://api-docs.deepseek.com/zh-cn/quick_start/pricing/>

安装

方式 1：从 npm 安装（推荐）
dsh plugin add dsh-peak-clock

方式 2：从本地 tarball 安装
dsh plugin add ./dsh-peak-clock-<version>.tgz

手工方式：把包解压到 profile 的 node_modules/dsh-peak-clock/，并在该 profile package.json 的 dsh.profile.bundles 数组里加入 "dsh-peak-clock"。

安装后刷新 Web 界面（Ctrl+Shift+R）即可看到徽标。

接口（同源只读）

GET|HEAD /peak-clock/v1/now —— 当前时段

{
"period": "idle",
"reason": "holiday",
"holiday": "国庆节", "beijingTime": "2026-10-04 04:26", "localTime": "2026-10-04 04:26", "systemZone": "Asia/Shanghai", "systemOffsetMinutes": 480, "timeZone": "Asia/Shanghai", "nextChangeAt": 1791421200000, "nextPeriod": "peak",
"peakWindows": ["09:00-12:00", "14:00-18:00"],
"holidayTableYear": 2026,
"source": "https://api-docs.deepseek.com/zh-cn/quick_start/pricing/"
}

reason 取值：window（落在高峰窗口）/ off-window（午休或晚间清晨）/ weekend / holiday。

GET|HEAD /peak-clock/v1/session[?id=<sessionId>] —— 会话用量与费用

不带 id 时取最近活跃的会话。

{
"ok": true,
"session": {
"sessionId": "session-xxxxxxxx",
"model": "deepseek-flash",
"provider": "deepseek-account",
"calls": 194,
"peakCalls": 0,
"tokens": { "input": 118547, "output": 285513, "cacheRead": 32871040, "cacheWrite": 0, "total": 33275100 },
"cost": 1.91802,
"currency": "CNY",
"firstAt": 1791055145990,
"lastAt": 1791059124598
},
"today": {
"cost": 3.4567, "currency": "CNY",
"zone": "Asia/Shanghai", "offsetMinutes": 480,
"calls": 42, "sessions": 3,
"tokens": { "total": 1234567 }
},
"system": { "zone": "Asia/Shanghai", "offsetMinutes": 480 }
}

自定义

| 想改什么 | 改哪里 |
| 时段颜色 | lib/client.js → COLOR_IDLE / COLOR_PEAK |
| 金额颜色 | lib/client.js → PRICE_COLOR |
| 图标（星星/爱心） | lib/client.js → STAR / HEART |
| 旺季图标（已注释保留） | lib/client.js → EMOJI_PEAK / EMOJI_IDLE |
| 高峰窗口 | lib/host.js → PEAK_WINDOWS（北京时间小时，左闭右开） |
| 法定节假日表 | lib/host.js 的 HOLIDAYS 和 lib/client.js 的 HOLIDAYS（两处，含首尾日期） |
| 价格表 | lib/host.js → PRICES |

改完重新打包并安装：

node <node> <pnpm> pack
node <node> <pnpm> add ./dsh-peak-clock-<version>.tgz

注意

- 透明说明：参考了哪些社区插件的 API 契约与数据格式、哪些是原创、以及本插件绝不做的事 —— 见 TRANSPARENCY.md。

- 今日消费按本机时区：当天 00:00 起算，跨会话只统计今天发生的调用；价格仍按每次调用时刻的北京时间峰谷档位
- 时区：峰谷判断永远按官方口径（北京时间）；界面显示的时间随时区变化，并与北京时间并列对照（含 UTC 偏移）
- 宿主半边是 ESM 模块，改动后需重启一次 DSH 才生效（Node 会永久缓存 ESM；实测替换文件、禁用/启用插件行、换入口文件名均无法热重载）。客户端半边刷新页面即可。
- 节假日表需按国务院年度安排更新（每年一次，两处）——停止更新只会让高峰判断在节假日期间偏保守（把假期当成工作日）。
- 价格表随官方调价更新；本插件不会联网抓价，价格随版本固定，便于历史会话按当时价格重放。
- 接口为同源只读，仅接受 GET / HEAD。

开发

npm test # 6 个单测：时段逻辑、计价、会话用量、时区与今日消费、接口路由

| 文件 | 说明 |
| lib/host.js | 宿主半边：时段计算 + 两个只读接口 + 会话用量统计与计价 |
| lib/client.js | 浏览器半边：徽标渲染、时段刷新、用量轮询 |
| cordis.patch.yml | 插件装载补丁（插入 Loader 行） |
| test/smoke.mjs | 时段逻辑单测（边界、午休、周末、节假日、跨春节切换点） |
| test/smoke-cost.mjs | 计价单测（flash/pro × 峰/闲） |
| test/smoke-usage.mjs | 会话用量端到端（累计快照去重、模型切换、合计） |
| test/smoke-today.mjs | 时区随系统 + 今日消费（跨天过滤、计价） |
| test/smoke-routes.mjs | 两个接口的路由级验证（字段、405、HEAD） |
| test/smoke-edge.mjs | 边界与容错（数字格式、节假日映射、空/异常会话、无 id 兜底） |

卸载

cd <profile 目录>
node <node> <pnpm> remove dsh-peak-clock

再从 profile 的 package.json → dsh.profile.bundles 里删掉 "dsh-peak-clock"，刷新页面。

兼容性

已在 Windows 10（19041）+ DSH Desktop（web profile）+ Node 24 实测；依赖 DSH 提供的 webServer / sessionQuery 服务与 conversation.composer.dock 插槽。

License

MIT

本插件由 DeepSeek V4.1-Flash 全程制作编写（设计、代码、测试、自检与文档）。
Built entirely by DeepSeek V4.1-Flash (design, code, tests, audits and documentation).