峰谷计价时钟 dacs2019/dsh-deepseek-price-timer

⏱️ dsh-deepseek-price-timer

License
Version
Stars
CI
Last commit

一个用于 DeepSeek Harness Web GUI 的实时小组件，显示当前的 DeepSeek 高峰 / 低谷定价（deepseek-v4-flash 和 deepseek-v4-pro）。

它会自动检测你电脑的时区，并始终显示你本地时间与 UTC 之间的对比，让你一眼就能知道自己处于 PEAK（2 倍费率）还是 OFF-PEAK（半价）。

小组件截图

西班牙语版本 — README.es.md

✨ 功能特性

| 🌐 | 实时官方价格 — 每 30 分钟从 api-docs.deepseek.com/quick_start/pricing 获取价格表（离线时使用内置回退数据） |
| 🕐 | 电脑本地时钟，并显示检测到的 UTC 偏移量（12:34 PM (UTC-5)） |
| 🌍 | UTC 时钟始终显示在旁边（17:34 UTC） |
| 🔴🟢🟡 | PEAK / OFF-PEAK / FLAT 标签，带脉冲圆点 — FLAT 会倒计时到价格切换时刻 |
| 📊 | 24 小时时间线，以你的本地时间显示：低谷时段为绿色，高峰时段为红色，并标注开始/结束时间和“当前”标记 |
| 💰 | 价格表，包含官方页面上的所有模型（低谷和高峰） |
| 🧮 | 根据真实 token 用量进行的实时会话成本估算（低谷和高峰） |
| 🔔 | 时段切换时提醒：“PEAK started!” / “VALLEY — half price” |
| 📌 | 会话标题栏标签 — 始终显示在 Session log 按钮旁边 |
| 🗜️ | 折叠为极简标签（适合移动端） |
| 🖱️ | 时间线上的工具提示，包含详细信息 |
| 🌍 | i18n ES/EN，根据浏览器语言自动切换 |
| ⚙️ | 适用于任何时区：高峰时段从 UTC 转换为你的本地时间（支持跨午夜和夏令时） |
| 🔄 | 自动更新 — 小组件会从仓库下载、验证并应用新版本，然后重启 |

官方高峰时段（以 UTC 定义）

- 01:00 – 04:00 UTC
- 06:00 – 10:00 UTC
- 其他所有时间均为 OFF-PEAK（高峰费率的一半）
- 新定价于 2026-08-16 16:00 UTC 生效（以你的本地时间显示）

每 100 万 token 的价格（美元）

| 模型 | 缓存命中（低谷/高峰） | 缓存未命中（低谷/高峰） | 输出（低谷/高峰） |
| deepseek-v4-flash | $0.007 / $0.014 | $0.22 / $0.44 | $0.66 / $1.32 |
| deepseek-v4-pro | $0.022 / $0.044 | $0.66 / $1.32 | $1.98 / $3.96 |

📦 安装

需要：DeepSeek Harness（dsh web）。

方式 A — 自动（Windows、Linux 和 macOS）

从项目根目录运行 — 安装程序会自动检测操作系统
npm run install:profile

或按系统分别运行：

npm run install:profile:win # Windows（使用 scripts/install.ps1）
npm run install:profile:unix # Linux/macOS（使用 scripts/install.sh）

方式 B — 手动

1. 链接/复制该包到扁平 profile 回退目录（可从每个 profile 解析）：

Windows（junction — 编辑一次，运行时生效） cmd /c mklink /J "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-deepseek-price-timer" "C:\path\to\dsh-deepseek-price-timer"

Linux/macOS
ln -s /path/to/dsh-deepseek-price-timer "$HOME/.dsh/profiles/node_modules/dsh-deepseek-price-timer"

2. 注册该行到主目录级补丁中（适用于所有 profile：web、headless、自定义）：

$HOME/.dsh/cordis.patch.yml
- insert:
- id: dspt-permanent
name: 'dsh-deepseek-price-timer'

你也可以将该行放入特定 profile 的补丁中（~/.dsh/profiles//cordis.patch.yml）。

3. 重启 Web 服务器（dsh web）并重新加载页面。该小组件会显示在输入框上方（conversation.input.dock），并在会话标题栏中显示为一个紧凑的胶囊标签。

卸载

schtasks /delete /tn "DSH Web Restart" /f # 如果你使用了自动重启任务移除补丁行并删除该包的 junction/副本

⚙️ 配置（环境变量）

| 变量 | 描述 | 示例 |
| DSH_DSPT_REPO | 你的 GitHub 仓库（owner/repo）。启用更新检查器：当你发布新版本时（main 分支上的 version.json），小组件会显示“⬆ update vX.Y.Z available”。 | DSH_DSPT_REPO=dacs2019/dsh-deepseek-price-timer |
| DSH_DSPT_PEAK_WINDOWS | 覆盖高峰时段（UTC 一天中的分钟数，start-end,start-end）。如果 DeepSeek 更改了时段，可在此处修改，无需改动代码。 | DSH_DSPT_PEAK_WINDOWS=60-240,360-600 |

更改这些变量后，请重启 Web 服务器（dsh web）。

🔄 价格和插件如何更新

- 价格：每 30 分钟自动从官方页面获取（+ ↻ 按钮）——当 DeepSeek 更改费率时，无需任何更新。
- 代码/时段：将更改推送到 GitHub，安装程序会执行 git pull（或重新复制）+ 重启。当设置了 DSH_DSPT_REPO 时，小组件会通过更新检查器提示用户。

🗺️ 小组件的位置

- 插槽：conversation.input.dock（输入框上方的一行），id 为 deepseek-price-timer
- 标题栏胶囊标签：conversation.session.header.utilities，id 为 deepseek-price-timer-pill
- 宽度：与输入框匹配（--dsh-composer-card-max-width）
- 主题：原生 harness 令牌（--dsw-alias-*）—— 适配浅色/深色

⚙️ 工作原理

1. 官方高峰时段以 UTC 定义（DeepSeek 的计费规则）→ PEAK/OFF-PEAK 始终按 UTC 计算（对任何用户都正确）。
2. 时间线和时钟通过 Date.getTimezoneOffset() 转换为 PC 的本地时间（支持夏令时以及 UTC+5:30 之类的分钟级偏移）。
3. 跨越本地午夜的高峰时段会拆分为两个时间线段。
4. 在 2026-08-16 切换之前，该小组件会显示一个 FLAT 阶段，并带有到新定价的实时倒计时。

⚠️ 已知限制

- 夏令时变更日的时间线标签：区块位置是正确的（按一天中的百分比），但在夏令时变更当天，小时标签可能会偏移 1 小时。
- 会话成本：使用第一个模型的价格（harness 快照不会暴露正在使用的模型）。
- 价格：通过解析 DeepSeek 官方页面获取；如果其结构发生变化，该小组件会回退到内嵌价格，并将其标记为“内嵌价格（离线）”。
- 自更新：信任来自所配置仓库（DSH_DSPT_REPO）的 HTTPS，并重启 harness；在 Windows 上需要 DSH Web Restart 计划任务（由 install.ps1 创建），在 Linux/macOS 上需要进程管理器或手动重启。

📄 许可证

MIT —— 参见 LICENSE。

更新日志

v1.5.0 —— 会话标题栏胶囊、带切换倒计时的 FLAT 阶段、无障碍支持（role/aria/data-phase）、带测试的 phaseAt() 逻辑。
v1.4.1 —— 跨平台 npm 安装程序（自动检测操作系统）、inject 的单一事实来源。
v1.4.0 —— 审计轮：修复 CI、不再重复调用 writeHead、NaN 价格（不是 $0）、自更新上的 CSRF、.bak 回滚、零宽高峰时段、完整 i18n、effect 中的定时器、版本水印。
v1.3.x —— 基于 header 的价格解析器、同源 CORS、经过验证的自更新、.tmp.js 扩展名修复。
v1.2.0 —— 跨平台自更新、Unix 安装程序、测试 + CI、防 BOM。
v1.1.0 —— 内部自更新、实时官方价格、本地/UTC 时间。