dsh-high-fee-alert

dsh-high-fee-alert

DeepSeek Harness 高峰资费提醒插件：每次启动 DSH 时从 DeepSeek API 定价文档 抓取最新定价，从 ntp.ntsc.ac.cn（中国科学院国家授时中心）获取北京时间 （精确到分，UTC+8），处于高峰时段（峰谷定价中的“峰”）时在页面中央弹出 710×430 的提醒窗口。

行为

• 启动抓取：宿主启动时抓取一次官方定价文档并解析高峰时段，之后每 6 小时刷新一次。解析器兼容两种文档格式：
  • 现行版（脚注给出高峰窗口，如 Peak hours are 01:00 - 04:00 and 06:00 - 10:00 UTC, Monday through Friday） → 换算为北京时间多段高峰窗口 + 工作日限定；当前官方时段为 周一至周五 09:00–12:00、14:00–18:00（北京时间）；
  • 旧版（脚注给出低谷窗口，如 off-peak pricing between 16:30 and 00:30 (UTC)） → 反推高峰窗口（每天）。
• 精确时间：每次状态查询经 NTP 取北京时间，失败自动回退本机时钟， 并在 30 秒内复用上一次结果，避免高频请求授时中心。
• 高峰弹窗：浏览器端挂载后立即查询状态，之后每 30 秒复查一次； 一旦处于高峰时段即弹出居中窗口（见下文视觉规格）。
• 两个按钮（位于窗口右下角）：
  • 左「好的」——蓝底 rgb(103, 158, 254)、白字：请求宿主关闭 DeepSeek Harness 前后端（ctx.appExit → 整棵树 dispose → 进程退出， 窗口随之关闭）；
  • 右「继续」——rgb(67, 69, 74) 底、白字：仅关闭本次提醒窗口， 本次页面生命周期内不再重复弹出。
• 回退：文档抓取/解析失败时回退到内置默认时段（当前官方载明的 工作日两段高峰），状态接口会注明 pricingSource: fallback； NTP 失败时注明 timeSource: local。

弹窗视觉规格

项	值
设计尺寸	710 × 430 px
位置	屏幕正中央（上下左右对称），小屏时等比收缩并保留 24px 对称边距
圆角	16px
背景	rgb(27, 27, 28)
文案	现在是 <实际时间>，API调用价格偏高，请等待至 <最近的下一非峰时刻> 再使用。

安装

# 安装到指定 profile（例如 web），CLI 会自动把本包追加进 bundles
dsh plugin --profile web add "file:D:/Deepseek Harness/chajian/dsh-high-fee-alert"

安装后重启 DSH 生效（profile 在启动时扫描 bundle 层）。

卸载：

dsh plugin --profile web remove dsh-high-fee-alert

配置

全部配置项均可在 profile 的 cordis.patch.yml 中按行 id 覆盖 （dsh-high-fee-alert），均有内置默认值：

配置项	默认值	说明
pricingUrl	https://api-docs.deepseek.com/quick_start/pricing	定价文档地址
ntpHost	ntp.ntsc.ac.cn	NTP 服务器
ntpPort	123	NTP 端口
ntpTimeoutMs	2500	NTP 超时
fetchTimeoutMs	8000	定价文档抓取超时
pricingRefetchMs	21600000	定价刷新间隔（6h）
exitCode	0	「好的」退出码
peakWindows	[]	显式高峰窗口（北京时间 HH:mm-HH:mm 数组，覆盖文档解析）
weekdaysOnly	null	高峰是否仅限周一至周五（布尔；缺省跟随文档/回退）
offPeakStart	''	旧语义：每日低谷开始（北京时间 HH:mm，反推高峰）
offPeakEnd	''	旧语义：每日低谷结束（北京时间 HH:mm）

示例（固定工作日 09:00–18:00 为高峰）：

- id: dsh-high-fee-alert
  config:
    peakWindows:
      - '09:00-12:00'
      - '14:00-18:00'
    weekdaysOnly: true

HTTP 接口（同源）

方法	路径	说明
GET	/dsh-high-fee-alert/status	当前时间、是否高峰、高峰窗口、下一非峰时刻、数据来源
POST	/dsh-high-fee-alert/exit	关闭前后端；仅接受同源 POST（Origin == Host）

结构

dsh-high-fee-alert/
├── package.json          # dsh.bundle + dsh.client 声明
├── cordis.patch.yml      # bundle patch：插入宿主行（inject: [webServer]）
├── index.js              # 宿主端入口：路由、退出、缓存
├── lib/
│   ├── ntp.js            # NTPv4 客户端与报文解析
│   ├── pricing.js        # 定价文档抓取/解析（新旧两种格式）/回退
│   └── schedule.js       # 高峰窗口纯逻辑（多段窗口 + 工作日限定）
├── client/client.js      # 浏览器端 bundle（__ModuleLoader__ 工厂格式）
├── demo/popup-demo.html  # 弹窗视觉规格静态演示页（npm 打包不含此目录）
└── test/logic.test.mjs   # node --test 单元测试
    test/client.test.mjs  # jsdom 弹窗渲染测试（缺依赖时自动跳过）

开发验证

node --test test/

test/client.test.mjs（jsdom 弹窗渲染测试）需要 react、react-dom、 jsdom：优先从当前 DSH 的 profile node_modules（$DSH_HOME/profiles/web） 解析，也可安装到插件旁的 .test-deps 目录；三者均不可用时该测试自动跳过：

npm install --prefix .test-deps --no-save jsdom react react-dom