DeepSeek 价格峰谷提醒

---

在 Harness Web UI 的输入框下方显示一个小胶囊，提醒你 DeepSeek 官方 API 当前处于 峰价 还是 谷价，以及距离下次切换还有多久。点开胶囊可以查看当前价目表（人民币）、峰时规则、数据来源和抓取时间，并可从官网重新抓取。

胶囊样式和原生胶囊（会话统计、Token 用量、上下文用量）保持一致。

使用 DeepSeek Harness 的创造模式完成。

功能

• 实时读数：按官网规则计算当前时段（北京时间 09:00–12:00、14:00–18:00，周一至周五，不含中国法定节假日），并倒计时到下一次切换。
• 人民币价目表：读取官方中文定价页，显示模型、档位、缓存命中/未命中输入价、输出价，峰/谷两档同时列出，当前生效的一档高亮。
• 从官网更新：面板里的“立即更新”会读取 https://api-docs.deepseek.com/zh-cn/quick_start/pricing，同时更新价格和峰谷时段规则（时间窗口、星期、是否排除节假日）。
• 自动更新：启动时以及之后每 30 分钟检查一次，缓存超过 autoRefreshHours 小时就在后台重新抓取。抓取失败时保留旧表，并在面板里报告原因。
• Agent 工具：deepseek_price_tip，action: status | refresh，与面板共用同一份数据。

截图展示

安装

本仓库就是插件包本身（package.json 里的 dsh.bundle.patch 和 dsh.client），没有构建步骤，也没有第三方依赖，只用 Node 内置模块。

从 GitHub 安装

在 Harness 的插件管理里安装这个 bundle，安装 spec 填：

github:jaaaa34/dsh-deepseek-price-tip

也可以让 Agent 调用 plugin_manager 的 install_bundle，target 用同一个 spec。装好后重启 Harness Web UI，输入框下方就会出现胶囊。

本地开发时直接 link

在 profile 的 package.json 里把依赖指向本目录，并把包名加进 dsh.profile.bundles：

"@local/deepseek-price-tip": "link:C:/path/to/dsh-deepseek-price-tip"

数据与缓存

内容	位置
人民币价格、峰时窗口、星期规则	首次抓取后写入 data/pricing-cache.json
内置兜底数据	lib/pricing.js 的 DEFAULT_PRICING（2026-10-18 抓取，人民币）
中国法定节假日	内置 2026 年安排，来源见 HOLIDAY_SOURCE；跨年后请用配置补充

如果官网表格结构发生大改，解析会失败而不是写入半张表：界面继续显示上一次成功的数据，并提示失败原因。

配置

在 profile 的 cordis.patch.yml 中给这一行加 config：

- id: deepseek-price-tip
  name: '@local/deepseek-price-tip'
  config:
    autoRefreshHours: 6
    # 可选：覆盖峰时窗口，单位是 UTC 零点的分钟数
    # peakWindows: [[60, 240], [360, 600]]
    # 可选：覆盖星期（0 = 周日，6 = 周六）
    # weekdays: [1, 2, 3, 4, 5]
    # 可选：追加法定节假日（YYYY-MM-DD）
    # holidays: ['2027-01-01']
    # 可选：换一个抓取地址（英文页会按美元解析并显示 $）
    # sourceUrl: 'https://api-docs.deepseek.com/quick_start/pricing'

autoRefreshHours: 0 关闭自动抓取，只保留手动按钮。

验证

npm test

也可以单独跑其中一组：

node test/pricing.test.mjs   # 解析、峰谷计算、节假日、缓存校验
node test/host.test.mjs      # Host 路由、刷新、失败回退、Agent 工具
node test/client.test.mjs    # Client 注册、locale 字典、样式清理

不需要 npm install：测试只用 Node 内置模块（Node 20+）。GitHub Actions 在 Node 20/22/24 上跑同一套测试，见 .github/workflows/test.yml。

安装后在 Harness Web UI 里确认：输入框下方出现胶囊；点开有价目表；点“立即更新”后抓取时间变化。浏览器内的实际渲染效果需要在页面中查看，测试只覆盖模块注册和纯逻辑。

限制

• 峰时窗口支持官网中文页的“北京时间 … 为高峰时段”和英文页的 “Peak hours are … UTC” 两种写法；页面改版时可能需要调整解析器。
• 节假日只内置到 2026 年。2027 年及以后，界面会明确提示“未内置该年节假日”，避免把节假日误报成峰价。
• 价格表按官网当前的“模型列 + 峰/谷行”结构解析；Search & Fetch 的按次计费不在模型价目表内。
• 人民币价格直接取自官方中文页，不是按汇率从美元换算。
• 缓存写在插件包目录里的 data/pricing-cache.json（已在 .gitignore 中忽略）。重新安装或升级插件会让这份缓存丢失，下次刷新时重新抓取，期间用内置的 DEFAULT_PRICING 兜底。