dsh-peak-indicator (DeepSeek 高峰/平峰时段提示器)

English | 中文 (Chinese)

DeepSeek Harness (DSH) Web GUI 官方峰谷分时时段提示器：实时显示 DeepSeek V4 官方 API 高峰与平峰时段状态、秒级切换倒计时、多时区智能转换、24 小时全景可视化时段轴与官方最新价格对照表。

---

📖 背景与设计目的

根据 DeepSeek 官方于 2026 年 8 月 17 日 00:00（北京时间） 起实行的分时定价政策：

• 业务高峰时段（Peak Hours）：每日 09:00~12:00 与 14:00~18:00（北京时间 UTC+8），按官方标准价计费。
• 空闲平峰时段（Off-Peak Hours）：每日其余 17 个小时，缓存命中、未命中输入与模型输出全部享受 5 折（50% 半价） 优惠。

本插件为 DSH Web GUI 原生打造，旨在帮助开发者与团队在使用 Agent 进行高频对话、批量长任务（如代码审计、架构重构、批处理）时，实时掌握当前费率窗口，合理避峰省费。

---

📸 插件界面效果预览

1. 顶栏原生指示器与全局悬浮胶囊效果


2. 24 小时全景时间轴、官方分时价格对照表与快捷设置面板

<p align="center"> <img src="./assets/preview-modal.svg" alt="全景详情弹窗效果图" width="600"/> </p>

---

🌟 核心特性

1. 精炼排版与优雅显示 (Concise Typography)： - 英文状态：Peak Rate 与 Off-Peak。 - 中文状态：高峰价 与 平峰。 - 严格控制宽度与排版行距，与会话标题、模型切换器及额度 Chip 自然对齐。

2. 会话顶栏原生集成（零遮挡、零穿透）： - 原生注册于 conversation.session.header.actions 插槽（Order 35），紧邻额度 Chip 右侧，严格保持在 Session Log 与导出按钮的左侧。 - 遵循 Flexbox 标准文档流，不遮挡任何既有按钮。 - 提供可选的全局悬浮胶囊模式（支持右上、左上、居中停靠）。

3. 精准的 DeepSeek V4 官方定价规则： - 高峰窗口：09:00~12:00 与 14:00~18:00（北京时间）。 - 平峰窗口：00:00~09:00、12:00~14:00、18:00~24:00（全天 17 小时 5 折）。 - 聚焦 V4 核心模型：详情卡片重点展示 DeepSeek-V4-Flash-0731 与 DeepSeek-V4-Pro-0813 的分档阶梯单价。

4. 多时区自动识别与双时钟对照： - 自动探测浏览器本地时区（如 America/New_York、Europe/London、Asia/Tokyo）及 UTC 偏移。 - 实时双时钟展示本地时间与北京时间，并将下一次时段切换自动换算为本地时刻。

5. 秒级实时倒计时： - 动态更新距离下一轮时段切换的剩余时间（如 距平峰还剩 01:24:10 / 距高峰还剩 03:00:00）。

6. 24 小时全景时间轴 (Timeline Visualizer)： - 点击指示器即可展开全景详情卡片。 - 24 小时色块分段对齐（🟢 绿色代表平峰半价，🟠 橙色代表高峰价格），实时游标指示当前北京时间进度。 - 支持鼠标悬浮或键盘聚焦查看任意分段的具体起止时间。

7. 原生国际化支持 (DSH i18n)： - 接入 DSH 原生 ctx.locale（命名空间 dsh-peak-indicator）。 - 语言跟随 DSH 系统设置自动切换，支持中英双语无刷新热重载。

8. 侧边栏边缘快捷入口： - 在左侧栏底部操作区（sidebar.footer.action，Order 1000）右边缘嵌入彩色状态圆点，点击同样可展开全景详情。

---

📊 DeepSeek V4 官方 API 定价对照表

注：价格单位为人民币（元）/ 百万 tokens。官方计费文档见 api-docs.deepseek.com/pricing。

---

🚀 安装与配置

1. 配置 Profile 依赖（~/.dsh/profiles/web/package.json）

{
  "dependencies": {
    "dsh-peak-indicator": "link:/path/to/dsh-peak-indicator"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-peak-indicator"
      ]
    }
  }
}

2. 自动挂载

插件自带 bundle patch 声明，启动时由 DSH Profile Loader 自动加载，无需手动编写 patch 规则。

---

📄 开源许可

MIT License.