前言¶

DeepSeek API 自 2026-08-17 起实行按北京时间峰谷定价：工作日部分时段为高峰价，其余时间为空闲价（约为高峰价一半）；法定节假日与调休口径还会改变「算不算工作日」。若只在官方文档里查表，很难在写 Harness 会话时一眼看到「当前是高峰还是空闲、还剩多久切换、账户还剩多少钱、当前工程大概花了多少」。社区插件 deepseek-time-price（维护者 TSRYWHY）在 Harness Web GUI 上增加可拖动的悬浮窗和输入框下方入口，把时段、价格、余额与本项目花费集中展示，并接入中国法定节假日数据以辅助时段判断。

这是什么¶

deepseek-time-price 是 DeepSeek Harness（DSH）的客户端类插件：在 Harness 界面浮出可拖动、可吸附的小窗口，显示 DeepSeek 时段价格与倒计时、24 小时时段进度条、账户余额、「本项目」累计花费，以及可折叠的模型价格、计费规则与法定节假日信息。插件以 bundle 形式通过 cordis.patch.yml 扩展 Host 只读路由，客户端注入对话与布局相关 UI 槽位；许可证为 MIT，仓库见 GitHub，社区目录页见 SkillHub。

核心功能¶

时段与价格展示¶

窗口与启动条会标明当前属于高峰还是空闲：空闲时段绿色、高峰时段橙色。高峰定义为北京时间周一至周五（不含中国法定节假日）09:00–12:00、14:00–18:00；其余时间为空闲，含周末、法定节假日全天、调休上班的周末。空闲价在代码中按高峰价 ×0.5 计算。

插件内置 deepseek-flash 与 deepseek-v4-pro 的高峰单价（元 / 100 万 tokens），写死在 client.js 的 MODELS 常量；改价需修改该常量并更新 PRICING_UPDATED 后重新加载插件。官方定价说明见 DeepSeek 定价文档。README 注明：旧版每日 00:30–08:30 错峰优惠已于 2025-09-06 取消，本插件按现行峰谷规则实现。

24 小时进度与交互¶

24 小时条上绿色表示空闲段、橙色表示高峰段，并带当前时间游标。窗口可拖动，靠近屏幕边缘自动吸附；位置保存在浏览器 localStorage（键名 dsh-time-price.floating.v1）。双击标题恢复默认位置；方向键微调，Home 复位，Esc 收起。输入框下方保留小入口，用于打开或收起悬浮窗。

余额与本项目花费¶

Host 提供同源只读接口（不向浏览器暴露凭据）：

GET /api/deepseek-time-price/finance?sessionId=<SessionId>

余额通过 Host 的 ctx.deepseekAccount.getBalance(...) 读取 Platform 充值与赠送钱包（CNY 优先）；未登录或失败时显示「未登录/读取失败」，结果缓存 60 秒，界面以蓝色展示。

本项目花费：当前会话 Host 读取完整日志，对每条 assistant/message 按请求发生时刻判峰谷、按 source.model 选价，标记为精确（exact: true）。同一 cwd 下的「本项目」聚合则通过会话列表与 tokenUsage 投影缓存估算，按当前时段 flash 价累计（exact: false）。计价公式为：cost = cacheReadTokens × hit + (uncachedInputTokens + cacheWriteTokens) × miss + outputTokens × output。

法定节假日¶

Host 路由：

GET /api/deepseek-time-price/holiday?date=YYYY-MM-DD

上游按顺序尝试 timor.tech 年度接口、holiday-cn 的 jsDelivr / fastly 镜像，以及单日兜底；全部失败时按星期几降级，并在窗口内提示数据源不可用。客户端优先走同源路由；路由不可用时可直接 fetch timor.tech（带 CORS）。2027 年安排未发布时，「下一个法定节假日」可能显示暂无数据；未发布年份 Host 返回降级结果（degraded: true）。

显示与国际化¶

三个可折叠区块：模型与价格（高亮当前时段对应行）、计费规则、法定节假日（状态、区间、下一节日、来源与刷新）。文案随 Harness 语言切换；样式使用 --dsw-alias-* 主题 token。

安装与启用¶

本插件通过 Plugin Manager 的 install_bundle 安装本目录（含 cordis.patch.yml），而不是凭仓库名拼接 CLI 的 dsh plugin add。package.json 中声明的 DSH 配置如下：

"dsh": {
  "bundle": { "patch": "./cordis.patch.yml" },
  "client": {
    "platform": "web",
    "immediately": true,
    "inject": ["@deepseek-ai/dsh-client-ui-conversation", "@deepseek-ai/dsh-client-ui-layout"]
  }
}

安装后注意：修改 client.js 或 index.js 后需刷新 Harness 页面（Ctrl+F5） 以加载新客户端模块；桌面打包版无前端 dev watcher。Host 代码更新后需重启 Harness 或依赖 HMR 重新组合。

典型用法¶

1. 在 Harness Web 中完成 bundle 安装并刷新页面。
2. 在输入框下方查看当前时段、迷你时段条、余额与本项目花费；点击打开完整悬浮窗。
3. 拖动窗口到习惯位置（会自动吸附边缘）；需要细节时展开「模型与价格」「计费规则」「法定节假日」。
4. 若需核对当前会话精确花费，查看花费卡片上的小字说明（精确 vs 估算的区别见 README）。

插件以当前 DSH 进程权限运行；余额路由同源且无额外鉴权，仅适合 Harness 绑定回环地址的本机使用，请勿把 Harness 暴露到非回环网络。安装前请自行阅读仓库源码与 MIT 许可证。

适用场景与注意¶

适合经常在 Harness 里调用 DeepSeek API、需要对照峰谷时段控成本、或想快速看 Platform 余额与同工作目录项目累计 token 花费的开发者。

已知限制（来自 README）：

• 节假日依赖第三方免费 API，离线时按星期几降级，时段判断可能不准。
• 余额需当前 profile 已登录 DeepSeek Platform。
• 「本项目」为已缓存会话的估算；当前会话按请求时刻计价，单次请求跨时段边界可能有 ≤1 次请求误差；价格表更新后历史累计不会自动重算。
• 不写遥测；窗口位置仅存本地。只请求公开节假日接口与 Platform 余额接口，不向浏览器发送会话内容或凭据。

DSH 生态主张「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

deepseek-time-price 把 DeepSeek 峰谷定价、法定假日口径、账户余额与会话/项目花费收进一个可拖动的 Harness 悬浮窗，减少反复查文档和心算时段的成本。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。