dsh-price-phase

English | 中文

DSH Web GUI 的 DeepSeek 峰谷时段徽标：在输入卡底部的工具行居中显示当前处于高峰还是空闲时段，并给出距下次切换的倒计时。

依据 DeepSeek 官方分时定价：高峰时段为北京时间周一至周五 09:00–12:00、14:00–18:00，其余时间（含周六、周日全天）为空闲时段，空闲价格为高峰价格的一半（5 折）。

---

这个插件不做什么

同时段指示器已经有几个实现，本插件的取向是只做一件事，因此刻意省略：

• 不做多时区转换（官方规则以北京时间为准，直接按 UTC+8 换算最不容易出错）
• 不做 24 小时时段轴、价格对照表、详情弹窗
• 不做点击交互、不读宿主状态、不发任何网络请求
• 零第三方依赖，只 require('react')

全部判断来自浏览器本地时钟的 UTC+8 换算，因此离线可用、无延迟、也不会因为接口失败而显示错误状态。

功能

能力	说明
实时时段	高峰 / 空闲，每 30 秒随系统时钟重算
倒计时	距下次状态真正翻转的时刻，格式 2h13m / 45m / 38s
悬停详情	当前北京时间（含星期）、前后时段、下一次切换说明
窄屏适配	手机端自动改为行内短标签并省掉圆点，避免压住模型 chip
准确的跨周末倒计时	周五 18:00 之后指向下周一 09:00，而不是周六 09:00

安装

dsh plugin --profile web add dsh-price-phase

重启 DSH 后，输入卡底部工具行中央就会出现时段徽标。

dsh plugin add 会读取本包 package.json 里的 dsh.bundle.patch，自动把插件插进配置树，不需要手工编辑 cordis.patch.yml。下面是它替你做的事，仅供排查时参考：

- insert:
    - id: dsh-price-phase
      name: 'dsh-price-phase'

也可以用 npm 直接装（例如自建 profile 或离线分发），但要自己补上面那条 insert：

npm install dsh-price-phase

开发

npm run build:bundle   # 由 lib/price-phase.js 重新生成 bundle 的内联段
npm run check          # 语法预检 + 校验内联段与源文件一致
npm test               # 23 项测试：纯逻辑 + bundle 契约
npm run verify         # 以上全部

lib/client.js 里的判定逻辑不是手写的，而是由 scripts/inline-price-phase.mjs 从 lib/price-phase.js 构建期内联进去的。原因是 DSH 的 bundle 解析器只认平台 seed 字面量与已注册的包 id，require 自身子路径必定失败；而逻辑又不能直接手写在 bundle 里，否则无法在 Node 下单测。改动 lib/price-phase.js 后需重跑 build:bundle。

测试分两层：

• test/price-phase.test.js —— 分时判定、跨日与跨周末边界、倒计时落点。时间戳按 Date.UTC(y, m, d, H-8, M) 构造（北京 = UTC+8），期望值照官方脚注逐条翻译，不是从实现里反抄的。

• test/client-contract.test.js —— 在 node:vm 里造一个最小浏览器环境，真正执行 lib/client.js，验证 id 与包名一致、只请求平台 seed 字面量、不请求自身子路径、内联符号齐全、槽位注册正确、样式注入幂等。

  这一层是必需的：bundle 的打包错误在宿主侧只表现为「loaded without registering」或浏览器控制台里一句 missed the module table，node --check 这类语法检查完全抓不到。本插件第一版就因为在 bundle 里 require 自身子路径而带着这个 bug 发布过，正是这条测试补上了它。

已知边界

• 时段以北京时间为准：官方规则写死了北京时间，海外用户看到的是北京时间所对应的时段，这是刻意的——按本地时区换算反而会算错。
• 不处理价格数值：只提示时段，不显示单价。单价会变，硬编码在客户端早晚会过期。
• 只注册 conversation.input.right 槽位：该槽位是 kind: list，可以与其他插件共存，靠 order: 90 排序。
• 依赖 DSH 0.1.5 的客户端槽位契约；更早版本未验证。

许可

MIT