前言¶

DeepSeek 官方对 API 采用分时定价：北京时间工作日的部分时段为高峰，其余为闲时（半价）。如果你在 DeepSeek Harness（DSH）里长时间跑对话，单靠账单或文档很难在「当下」判断当前属于哪一档，也不容易把本次会话的 token 和折算费用放在同一视线里。

下面介绍社区插件 dsh-peak-clock：在 DSH Web UI 的会话头部显示峰谷状态、倒计时、本次对话用量与按官方单价估算的消费，以及按本机日历日汇总的今日消费。插件由维护者 1134478268-dev 发布，在 SkillHub 目录中归类为「联网工具」；实现上无对外网络请求，峰谷与计价逻辑均在本地完成。

这是什么¶

dsh-peak-clock 是面向 DeepSeek Harness Web UI 的 DSH 插件（npm 包名 dsh-peak-clock，当前资料中版本 1.0.2，MIT 许可证）。它不改变你的调用方式，而是在界面顶部增加一条可读徽标，并暴露同源只读 HTTP 接口，供其它插件或脚本查询相同数据。

核心功能¶

峰谷时段与倒计时¶

判断依据为 北京时间（与官方计费口径一致），规则如下：

• 周一至周五（不含中国法定节假日）：09:00-12:00、14:00-18:00 为 高峰；其余为 闲时（含 12:00-14:00 午休、晚间、清晨）。
• 周末与中国法定节假日为闲时；资料说明 2026 年 法定假日表已内置，调休上班的周末仍按闲时处理（与官方表述一致）。
• 徽标会显示距下一次峰谷切换的倒计时；悬停可查看本机时间与北京时间（时区不同时并列）、今日统计口径及价格来源链接。

界面文案随 DSH 客户端语言在中英之间切换；峰谷规则始终按北京时间计算，显示层则适配本机时区与 UTC 偏移（含夏令时）。

用量与费用估算¶

• 本次对话：token 总量与按官方分时价折算的预计消费（人民币），约每 15 秒刷新。
• 今日消费：以本机时区当天 0:00 起算，跨会话合计（只统计当天发生的调用）。
• 按调用时刻计价：单次对话若跨越高峰与闲时，或中途切换模型，按每次调用实际发生时刻的峰谷档位与当时模型单价分别折算，而非整段会话统一用一个价。

计价使用的模型与单价（元 / 百万 tokens）来自 DeepSeek 官方定价页，并随插件版本固定（不实时拉取远端价格），便于历史会话按当时费率回放：

资料说明：同一 (turn, step) 的 usage 为累计快照，只计最后一次；缓存写入按未命中输入计费；金额为估算，不含账户级优惠或赠送额度，实际以 DeepSeek 账单为准。来源：https://api-docs.deepseek.com/zh-cn/quick_start/pricing/。

运行特性¶

• 零运行时依赖；不发起对外网络请求；不读取凭据。
• 提供同源、只读、GET / HEAD 的 HTTP API（见下文）。

界面示例（来自 README）：

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

安装与启用¶

DSH 生态里插件通常通过 dsh plugin add 安装；以下命令来自仓库 README，请勿自行拼接未在文档中出现的安装形式。

# 方式 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-peak-clock" 加入 dsh.profile.bundles 数组。

安装后刷新 Web 界面（例如 Ctrl+Shift+R）即可看到会话头部徽标。package.json 要求 Node >= 22。

维护注意（来自 README）：宿主侧为 ESM 模块（lib/host.js），更新后需 重启 DSH 一次；浏览器侧（lib/client.js）刷新页面即可。法定假日表需按国务院安排每年更新 lib/host.js 与 lib/client.js 中的表项，否则节假日的普通工作日可能被保守地当作工作日处理。

典型用法¶

在 Web UI 中查看¶

正常对话即可；徽标随当前会话更新 token 与估算费用，并反映实时峰谷状态。需要细节时悬停徽标查看时区对照、切换时间与计费说明。

通过只读 API 查询¶

其它插件或脚本可在同源下调用：

GET /peak-clock/v1/now 返回片段示例：

{
  "period": "idle",
  "reason": "holiday",
  "holiday": "国庆节",
  "beijingTime": "2026-10-04 04:26",
  "localTime": "2026-10-04 04:26",
  "systemZone": "Asia/Shanghai",
  "nextChangeAt": 1791421200000,
  "nextPeriod": "peak",
  "peakWindows": ["09:00-12:00", "14:00-18:00"],
  "holidayTableYear": 2026
}

reason 可取 window（高峰窗口内）、off-window（午休或晚间清晨等）、weekend、holiday。

会话用量示例（README 节选）：

{
  "ok": true,
  "session": {
    "sessionId": "session-xxxx",
    "model": "deepseek-flash",
    "tokens": { "input": 118547, "output": 285513, "cacheRead": 32871040, "total": 33275100 },
    "cost": 1.91802,
    "currency": "CNY"
  },
  "today": { "cost": 3.4567, "currency": "CNY", "calls": 42, "sessions": 3 }
}

适用场景与注意¶

适合谁：日常在 DSH Web UI 使用 DeepSeek 模型、希望对照官方峰谷规则安排批量调用或长对话，并需要在界面内快速看到 token 与估算人民币成本的开发者。

安装前建议：DSH 插件在 当前 dsh 进程权限 下运行。安装前应阅读仓库源码与 MIT 许可证，确认行为符合你的环境策略。本插件自述不访问凭据、不对外联网；透明说明见仓库 TRANSPARENCY.md。

生态背景：DSH 采用「一切皆插件」的扩展方式；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的 dsh-peak-clock，而非官方应用商店条目。

结尾¶

dsh-peak-clock 把 DeepSeek 官方峰谷规则、会话 token 与按分时价估算的费用收拢到 DSH 会话头部，并辅以只读 API，方便人工查看或程序化复用同一套数字。

• 目录页：https://www.skillhub.cn/plugins/1134478268-dev/dsh-peak-clock
• 源码与文档：https://github.com/1134478268-dev/dsh-peak-clock