DeepSeek Harness 的理念是「一切皆插件」。在调用大模型时，峰谷电价差异显著，且余额不足会直接中断工作流。dsh-peak-price-panel 旨在解决这两个问题，将价格表与余额状态直接展示在主界面侧边栏，让开发者能实时掌握计费情况并提前充值。
插件定位¶
这是一个 DeepSeek Harness 主界面信息面板插件，由 LucienLL 维护，属于「联网工具」类别。它集成了峰谷价格显示、余额轮询与三档阈值变色预警功能，并提供充值按钮联动。
核心功能¶
- 峰谷时段显示与倒计时：按北京时间显示当前处于高峰（工作日 9:00–12:00、14:00–18:00）还是低谷，带下次切换倒计时。周末全天按低谷价计费（自 2026-08-23 起）。临近切换（默认提前 30 分钟）弹出横幅，提示涨价或半价。
- 侧边栏实时单价展示：侧边栏卡片实时显示当前时段所配置模型的输出单价（高峰全价 / 低谷半价）。
- 价格表过期提醒：价格表数据版本超过
staleAfterDays（默认 30 天）未更新时，侧边栏「输出单价」标题变黄并提示「价格表可能过期」。 - 余额轮询与阈值变色预警：轮询
GET https://api.deepseek.com/user/balance，显示总余额，按三档阈值（默认 50 / 20 / 5）变色并预警。 - 低余额时充值联动：低余额（告急/极低档）时按钮红色脉冲联动、余额数字变红加粗。
数据与代码解耦¶
自 v0.2.0 起，价格表与峰谷时段已从代码解耦，改为数据配置。实际生效值来自设置层 prices / peakWindows，不再硬编码在代码中。
- 实时生效：在设置层修改 JSON 可实时生效，无需重装插件。
- 重启生效：通过
cordis.patch.yml修改配置则需重启 web 生效。 - 调价方式：DeepSeek 调价后，只需更新配置层的
prices（以及需要时更新peakWindows、scheduleVersion），无需改代码、无需发版。
安装与启用¶
使用以下命令安装插件：
dsh plugin --profile web add dsh-peak-price-panel
API key 通过同名环境变量（默认 DEEPSEEK_API_KEY）解析：优先取同名环境变量，未设置时回退 DSH 凭据库。
配置项¶
主要配置位于设置页面的「Plugins → Cost panel」：
- 余额阈值：
warnThreshold（50）、criticalThreshold（20）、extremeThreshold（5）。分别对应提醒、告警、极低阈值。 - 轮询与提示：
refreshSeconds（60）控制余额刷新间隔；peakLeadSeconds（1800）控制峰谷切换提前提示时间。 - 价格数据：
prices为单价表（¥/1M tokens，峰价）；scheduleVersion（默认 2026-08-23）用于判断过期；peakWindows（如 [[9,12],[14,18]]）定义工作日高峰时段。 - 显示控制：
models留空则显示价格表里全部模型；currency仅影响余额的币种显示符号，不换算单价。
验证与依赖¶
项目提供单元测试验证：
node --test test/*.mjs
插件依赖 @deepseek-ai 系列库。
适用场景与注意¶
适合需要精细控制成本、频繁调用 DeepSeek API 的开发者。安装前建议检查源码与许可证（MIT）。
