DeepSeek 时段价格 · 悬浮窗插件

在 Harness Web GUI 上方浮出一个可拖动、可吸附的 DeepSeek 时段与花费小窗口，显示：

• 当前时段价格与倒计时（空闲时段绿色 / 高峰时段橙色）
• 24 小时时段进度条（绿色空闲段、橙色高峰段、当前时间游标）
• 蓝色账户余额与「本项目」累计花费
• 可折叠的「模型与价格」「计费规则」「法定节假日」三段内容
• 输入框下方保留一个小入口，用来打开/收起悬浮窗

窗口位置可拖动，靠近屏幕边缘会自动吸附，位置记录在浏览器 localStorage（dsh-time-price.floating.v1），双击标题恢复默认位置；方向键可微调，Home 复位，Esc 收起。

时段规则

DeepSeek 现行峰谷定价（2026-08-17 起，2026-09-19 明确节假日口径）：

• 高峰时段：北京时间周一至周五（不含中国法定节假日）09:00–12:00、14:00–18:00
• 空闲时段：其余所有时间，含周末、法定节假日全天、调休上班的周末
• 空闲价 = 高峰价的一半

旧版每日 00:30–08:30 的错峰优惠已于 2025-09-06 取消；本插件按现行峰谷规则实现。

官方来源：https://api-docs.deepseek.com/zh-cn/quick_start/pricing

价格数据

单位：元 / 100 万 tokens；高峰价如下，空闲价由代码按 ×0.5 计算。

模型	输入·缓存命中（空闲/高峰）	输入·缓存未命中（空闲/高峰）	输出（空闲/高峰）
deepseek-flash	¥0.02 / ¥0.04	¥1 / ¥2	¥4 / ¥8
deepseek-v4-pro	¥0.15 / ¥0.30	¥4.5 / ¥9	¥13.5 / ¥27

价格写死在 client.js 的 MODELS 常量中（高峰价）。改价时修改该常量并更新 PRICING_UPDATED，然后重新加载插件。

余额与本项目花费

Host 半新增同源只读路由：

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

• 余额：通过 Host 服务 ctx.deepseekAccount.getBalance(...) 读取 Platform 充值钱包与赠送钱包（CNY 优先），不向浏览器暴露任何凭据；未登录/查询失败会显示「未登录/读取失败」。余额结果缓存 60 秒。
• 本项目花费：
  • 当前会话：Host 通过 ctx.sessionQuery.readSession(sessionId) 读取完整日志，逐条 assistant/message 按请求发生时刻判定峰谷、按消息的 source.model 选价并计价，结果标为精确（exact: true）。
  • 「本项目」：通过 ctx.sessionQuery.listSessions() 找到同一 cwd 的会话，再用 ctx.sessionProjectionCache.cachedSnapshot(header, ['tokenUsage']) 读取聚合 token，按当前时段的 flash 价估算（exact: false，只作累计估算）。计入最近一次投影 checkpoint 的会话，可能少于全部历史会话。
  • 公式：cost = cacheReadTokens × hit + (uncachedInputTokens + cacheWriteTokens) × miss + outputTokens × output，单位元 / 100 万 tokens。当前会话的精确值显示在花费卡片的小字里。
• 路由仅接受 GET/HEAD，拒绝 Sec-Fetch-Site 跨站请求，响应 cache-control: no-store；不写日志、不记录余额。

节假日数据

Host 半同样通过同源只读路由读取中国法定节假日：

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

上游来源按顺序尝试：

1. https://timor.tech/api/holiday/year/{YYYY} — 主来源，一次拿全年放假/补班表
2. https://cdn.jsdelivr.net/gh/NateScarlet/holiday-cn@master/{YYYY}.json — 备用
3. https://fastly.jsdelivr.net/gh/NateScarlet/holiday-cn@master/{YYYY}.json — 备用镜像
4. 单日兜底 https://timor.tech/api/holiday/info/{YYYY-MM-DD}
5. 全部失败时按星期几降级，在窗口内标注「节假日数据源不可用，时段判断可能不准」

年度数据缓存 12 小时，未发布年份的失败结果缓存 15 分钟，并发请求同一日期只发起一次上游查询。客户端优先走同源路由，路由不可用时直接 fetch timor.tech 年度接口（该接口带 CORS）。覆盖边界：2027 年放假安排尚未发布时，「下一个法定节假日」会显示「暂无后续节假日数据」；若请求的日期属于未发布年份，Host 会返回降级结果（degraded: true）而不是把该年误当普通工作日。

显示与交互

• 悬浮窗注册在 shell.overlay，点击穿透由窗口自身 pointer-events: auto 恢复；窗口收起时返回 null。
• 输入框下方的启动条显示当前时段、迷你时段条、余额与本项目花费，点击打开/收起窗口。
• 三个可折叠段：模型与价格（含实时高亮当前时段行）、计费规则、法定节假日（状态、假期区间、下一个节假日、来源与刷新）。
• 中英文文案随 Harness 语言切换；样式仅使用 --dsw-alias-* 主题 token（绿=state-success、橙=state-warn、蓝=brand-primary）。

安装

普通 Harness bundle：

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

通过 Plugin Manager 的 install_bundle 安装本目录即可。修改 client.js/index.js 后需要刷新 Harness 页面（Ctrl+F5）加载新的客户端模块；桌面打包版没有前端 dev watcher，旧页面会继续使用已加载的模块。Host 代码更新后需要一次 Harness 重启或让 HMR 重新组合；页面刷新后客户端会自动重新拉取当前 client.js。

隐私与网络

• 只请求公开节假日接口和 DeepSeek Platform 余额接口；不发送会话内容、模型内容或凭据到浏览器。
• 不写遥测；窗口位置仅保存在浏览器本地。
• 余额路由同源、无 CORS 头，但不做额外鉴权：仅适合 Harness 绑定回环地址的本机使用，请勿把 Harness 暴露到非回环网络。

已知限制

• 依赖第三方免费节假日 API 的可用性；离线时按星期几降级。
• 余额需要当前 profile 已登录 DeepSeek Platform，否则显示未登录/读取失败。
• 「本项目」是已缓存会话的累计估算；当前会话的计价按请求结算时刻判峰谷，若单次请求跨时段边界有 ≤1 次请求的误差；价格表更新后历史累计不会自动重算。
• 悬浮窗的视觉外观、明暗主题对比和拖动体验未在本环境做浏览器截图验证；已通过槽位 active=true、JS 语法、路由实测与客户端逻辑测试。