dsh-peak-price
一个 DeepSeek Harness（DSH）插件：在输入框旁边常驻显示 DeepSeek API 现在是峰价还是谷价，附倒计时、官方价格表、计费规则和数据来源。
- 只读展示，不改变任何 Agent 行为：不注册工具、不写会话日志、不改别的插件
- 零依赖、零构建：纯 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 为高峰时段；其余时段，包括周末及中国法定节假日全天均为空闲时段。
这段话没有写死在代码里。插件运行时会：
- 分别解析官方中文页和英文页——英文页写的是 UTC 窗口，中文页写的是北京时间窗口，换算后必须一致；
- 解析价格表，并校验每个模型每一项都满足 谷价 = 峰价 ÷ 2；
- 读取两套互相独立的中国法定节假日数据集，两者对"哪天放假"必须一致；
- 任一环节不合规就保留上一次成功的数据并在卡片上标明，绝不猜、也绝不静默降级。
节假日按整个放假区间计（例如国庆 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 文件。
它会做什么
出站请求（全部由 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）本地磁盘：只在插件自己的目录下写一个文件
cache/dataset.json（公开数据的缓存，可随时删除）。一条本地 HTTP 路由：
GET /dsh-peak-price/data.json，把上面那份公开数据集提供给浏览器半边。- 它不需要鉴权——因为它只包含公开的定价与节假日数据；
- Harness 的 Web 服务默认只绑
127.0.0.1，所以只有本机能访问； - 如果你把 Harness 绑到了
0.0.0.0（dsh web --host的显式暴露模式），同网段的其他人也能读到这条路由——内容仍然只是公开数据，但你应该知道这件事。
浏览器不直接访问外网：页面只轮询上面那条同源路由，因此不存在跨域问题，也不会把你的浏览器环境暴露给第三方。
一点需要知情的宿主行为：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
No comments yet. Be the first to write one.