峰谷计价 XG221B/dsh-peak-price

dsh-peak-price

一个 DeepSeek Harness（DSH）插件：在输入框旁边常驻显示 DeepSeek API 现在是峰价还是谷价，附倒计时、官方价格表、计费规则和数据来源。

- 只读展示，不改变任何智能体行为：不注册工具、不写会话日志、不改别的插件
- 零依赖、零构建：纯 JavaScript + Node 内置模块，没有安装脚本、没有依赖树
- 数据零维护：计费规则、价格表、法定节假日全部自动抓取、校验并缓存，次年放假安排公布后会自动接上

它长什么样

输入框下方多出一行徽标（与上下文占用指示器并排）：

● 谷价 · 距峰价 5天15小时

点一下展开详情卡（再点或按 Esc 收起）：

┌────────────────────────────────────────────────────────────────┐
│ ● DeepSeek API 计费时段 谷价 · 半价 ✕ │ │ 国庆节假期（10月1日–10月7日）全天谷价 │ │ 北京时间 10月2日 18:07（周五） │ │ 下次切换：10月8日 09:00 转峰价（约 5天15小时） │ │ 当前价格（谷价）· 元 / 百万 tokens │ │ 模型 缓存命中 缓存未命中 输出 │ │ deepseek-flash 0.02 1 4 │ │ deepseek-v4-pro 0.15 4.5 13.5 │ │ 峰价时段为规则公布的工作日高峰窗口（…） │ │ 节假日按国务院公布的放假区间计，调休上班的周末仍按谷价 │ │ 规则与价格：DeepSeek 官方文档（10月2日 18:07 自动核对） │ │ 节假日：holiday-cn@jsdelivr（覆盖 2026） │ │ 已与独立数据源交叉校验一致 │ │ 价格与规则来源：api-docs.deepseek.com + holiday-cn │ └────────────────────────────────────────────────────────────────┘

（上面是文字示意，不是截图。颜色沿用宿主主题：谷价用成功色、峰价用警告色，明暗主题自动跟随。）

安装

任选一种方式，然后重启一次 Harness（首次安装通常可直接生效；替换已装版本必须重启，原因见「已知边界」）。

GitHub（推荐）

dsh plugin --profile <你的 profile> add github:XG221B/dsh-peak-price

桌面版等价操作：侧边栏 Plugins → Add plugin，填 github:XG221B/dsh-peak-price。

tarball

pnpm pack # 在仓库根目录执行，产出 dsh-peak-price-1.1.0.tgz
dsh plugin --profile <你的 profile> add ./dsh-peak-price-1.1.0.tgz

npm（若已发布到 registry）

dsh plugin --profile <你的 profile> add dsh-peak-price

本包没有 install/prepare 脚本，因此不涉及 pnpm 的 allowBuilds 构建授权——不需要允许任何"安装时在你机器上执行代码"。这是刻意的设计选择。

卸载

dsh plugin --profile <你的 profile> remove dsh-peak-price

顺手删掉插件目录下的 cache/ 即可，无其他残留。

它是怎么判断峰价/谷价的

官方口径（DeepSeek API 文档 · 模型 & 价格）：

空闲时段价格为高峰时段价格的一半。北京时间周一至周五（不含中国法定节假日）9:00 - 12:00、14:00 - 18:00 为高峰时段；其余时段，包括周末及中国法定节假日全天均为空闲时段。

这段话没有写死在代码里。插件运行时会：

1. 分别解析官方中文页和英文页——英文页写的是 UTC 窗口，中文页写的是北京时间窗口，换算后必须一致；
2. 解析价格表，并校验每个模型每一项都满足 谷价 = 峰价 ÷ 2；
3. 读取两套互相独立的中国法定节假日数据集，两者对"哪天放假"必须一致；
4. 任一环节不合规就保留上一次成功的数据并在卡片上标明，绝不猜、也绝不静默降级。

节假日按整个放假区间计（例如国庆 10/1–10/7 全算谷价），调休上班的周末仍按谷价。

刷新与降级

| 时机 | 行为 |
| Harness 启动 | 先读磁盘缓存（立刻可服务），再后台抓取一次 |
| 每 6 小时 | 定时重新抓取 |
| 有请求且数据超过 1 小时 | 补刷一次（单飞 + 5 分钟下限，防抖） |
| 浏览器端 | 每 15 分钟轮询；失败按 15s→30s→60s→120s 退避；切回前台且数据超 5 分钟则立即刷新 |

规则/价格：官方中文页 + 官方英文页 ─┬─ 双失败 → 上次成功的磁盘缓存 ─┬─ 也失败 → 内置快照（2026-10-02）节假日： holiday-cn + chinese-days ─┘ ┘

规则与节假日各自独立降级，卡片会明确写出当前用的是哪一档、核对时间，以及是否通过交叉校验。

隐私与安全

这一节是完整披露，因为插件要联网、还要在本机开一条路由。

它不做什么
- 不含任何凭据：代码里没有 API key、token、cookie、账号信息；它读的是完全公开的定价页与节假日数据。
- 不收集、不上报任何数据：没有遥测、没有统计、不访问你的会话内容、不读取你的工作区文件。
- 不修改宿主与其他插件：不写会话日志、不注册工具、不改配置、不改任何 profile 文件。

它会做什么

1. 出站请求（全部由 Host 半边发起，20 秒超时，公开数据，无凭据）：

| 用途 | 域名 |
| 计费规则与价格（中文） | api-docs.deepseek.com |
| 计费规则与价格（英文，交叉校验） | api-docs.deepseek.com |
| 法定节假日（主源 + 两个 CDN 边缘 + 最后兜底） | cdn.jsdelivr.net、fastly.jsdelivr.net、cdn.statically.io、raw.githubusercontent.com |
| 法定节假日（独立数据集，交叉校验） | cdn.jsdelivr.net（npm 包 chinese-days） |

2. 本地磁盘：只在插件自己的目录下写一个文件 cache/dataset.json（公开数据的缓存，可随时删除）。

3. 一条本地 HTTP 路由：GET /dsh-peak-price/data.json，把上面那份公开数据集提供给浏览器半边。
- 它不需要鉴权——因为它只包含公开的定价与节假日数据；
- Harness 的 Web 服务默认只绑 127.0.0.1，所以只有本机能访问；
- 如果你把 Harness 绑到了 0.0.0.0（dsh web --host 的显式暴露模式），同网段的其他人也能读到这条路由——内容仍然只是公开数据，但你应该知道这件事。

4. 浏览器不直接访问外网：页面只轮询上面那条同源路由，因此不存在跨域问题，也不会把你的浏览器环境暴露给第三方。

一点需要知情的宿主行为：DSH 自带一个诊断组件会把"当前已装插件的包名与版本"作为请求元数据附在官方 API 请求上。装上本插件后，dsh-peak-price 与它的版本号会出现在这个字段里。这是 Harness 自身的行为，与本插件无关，但既然你装了新插件，值得知道。

数据来源与许可

| 数据 | 来源 | 许可 |
| 计费规则、价格表 | DeepSeek API 文档 | 官方公开文档（本插件仅运行时读取，不转载） |
| 中国法定节假日（主源，带国务院通知溯源） | NateScarlet/holiday-cn | MIT |
| 中国法定节假日（独立数据集，用于交叉校验） | vsme/chinese-days | MIT |

本插件不内置上述节假日数据；它在运行时按需读取。仓库里的 tools/fixtures/ 只保留解析测试所需的最小样本（价格页样本是从公开页面裁剪出的表格+规则段，见 tools/README.md）。

本项目以 MIT 许可发布。

已知边界

- 需要 Web 界面：浏览器半边轮询的是一条同源路由。如果你的部署没有 Web carrier（例如 headless 模式），卡片会退化为只显示内置快照并明确标注。
- 需要能出网：抓不到 api-docs.deepseek.com 或 CDN 时会降级到缓存/内置快照；在需要代理的环境请参考 DSH 的网络代理配置。
- 替换已装版本必须重启 Harness：Host 按解析后的 URL 缓存已导入的模块，重新启用插件不会重新导入。数据更新不受影响（那是运行时抓取），只有代码更新需要重启。
- 兼容性：本插件在 DSH 0.2.0-rc.2（技术预览）上验证。它使用 conversation.composer.dock、conversation.input.dock 两个槽位与 ctx.webServer 服务，这些属于预发布 API，DSH 升级后可能需要适配。
- 两处口径来自单一来源：规则页的"峰价星期 / 谷价比例 / 是否免除节假日"取自中文页，没有第二个独立来源可比对（窗口有中英文交叉校验，节假日有两套数据集交叉校验）。
- 极端情况仍需改代码：官方价格页结构大改、或节假日数据源换格式时，解析会失败。此时插件不会静默出错——它会继续提供上次成功的数据，并在卡片上写明。

开发

node tools/test-dataset.mjs # Host 数据层：解析、校验、降级、双源交叉校验（92 项）
node tools/test-client.mjs # 浏览器层：窗口边界、切换计算、合并语义（69 项）
node tools/test-host.mjs # Host 端到端：路由注册 + 真联网抓取 + 缓存落盘（34 项）

test-host.mjs 需要网络；离线时其中联网部分报 SKIP 而非失败。样本的来龙去脉与再生成方式见 tools/README.md，打包/发布/提交隐私配置见 DEVELOPING.md。

English documentation: README.en.md