前言¶

用 DeepSeek 官方 API 做开发或跑 Agent 时，定价会按峰时、谷时切换：同一模型在不同时段单价不同。若只靠记忆或偶尔翻文档，很难在写请求、选模型时判断「当前是峰价还是谷价、离下次切换还有多久」。DeepSeek Harness（DSH）支持通过插件扩展 Web UI 与 Agent 能力；下面介绍社区插件 dsh-deepseek-price-tip（维护者 jaaaa34，分类：联网工具），在 Harness 输入框下方增加与原生统计胶囊风格一致的小胶囊，并附带 Agent 工具读取同一份价目与时段数据。

这是什么¶

dsh-deepseek-price-tip 面向在 DSH 里使用 DeepSeek 官方 API 的开发者：在 Harness Web UI 输入框下方显示胶囊，标明当前处于 峰价 还是 谷价，以及距离下次切换的倒计时；点开可查看人民币价目表、峰时规则、数据来源与抓取时间，并可从官网重新抓取。插件还提供 Agent 工具 deepseek_price_tip，与面板共用缓存数据。仓库无构建步骤、无第三方依赖，仅使用 Node 内置模块；当前包版本为 1.1.0（MIT）。

• 目录页：https://www.skillhub.cn/plugins/jaaaa34/dsh-deepseek-price-tip
• 源码：https://github.com/jaaaa34/dsh-deepseek-price-tip

核心功能¶

Web UI 胶囊¶

胶囊样式与会话统计、Token 用量、上下文用量等原生胶囊保持一致。读数按官网规则计算当前时段（README 记载：北京时间 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，与 Web 面板使用同一份数据与缓存逻辑。

安装与启用¶

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

github:jaaaa34/dsh-deepseek-price-tip

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

本地开发时，可在 profile 的 package.json 里将依赖指向本目录，并把包名加入 dsh.profile.bundles，例如：

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

插件以当前 DSH 进程权限运行；安装前建议自行查看仓库源码与 MIT 许可证。

配置¶

在 profile 的 cordis.patch.yml 中为对应 bundle 增加 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 表示关闭自动抓取，仅保留手动「立即更新」。

数据与缓存¶

缓存文件位于插件包目录，已在 .gitignore 中忽略；重新安装或升级会导致缓存丢失，下次刷新前使用内置兜底数据。

典型用法与验证¶

安装后在 Web UI 确认：输入框下方出现胶囊；点开有价目表；点「立即更新」后抓取时间变化。

在仓库根目录可用 Node 20+ 跑测试（无需 npm install）：

npm test

或分别执行：

node test/pricing.test.mjs
node test/host.test.mjs
node test/client.test.mjs

Agent 侧示例：调用 deepseek_price_tip，action: status 查看当前峰谷与价表摘要；action: refresh 触发与面板相同的官网抓取（受缓存与失败回退规则约束）。

适用场景与注意¶

适合长期在 DSH Web UI 里调 DeepSeek 官方 API、希望在不离开会话的前提下对照峰谷价目表的开发者。插件会从官网拉取定价页，属于「联网工具」类能力；需 Node >=20。

README 中记载的限制包括：峰时解析支持官网中英文两种表述，页面大改时可能需调整解析器；节假日仅内置到 2026 年，2027 年及以后会提示未内置该年节假日；Search & Fetch 按次计费不在模型价目表内；人民币价直接来自官方中文页，非美元换算。

DSH 社区插件目录（如 skillhub.cn）为独立生态站点，与 DeepSeek、幻方无官方从属关系；本文事实均来自上述 GitHub README 与 package.json。

结尾¶

dsh-deepseek-price-tip 把官方 API 峰谷状态与人民币价目表嵌进 Harness 输入区，并暴露 deepseek_price_tip 供 Agent 查询或刷新。需要安装 spec、配置项与源码时，以仓库 README 为准：https://github.com/jaaaa34/dsh-deepseek-price-tip；目录介绍见 https://www.skillhub.cn/plugins/jaaaa34/dsh-deepseek-price-tip。