前言¶

用 DeepSeek API 做开发或跑智能体时，计费会随「高峰 / 空闲」时段变化：工作日上午、下午若干区间是全价，其余时间（含周末）按高峰价的 50% 计。DSH Web 界面本身不会常驻提醒当前处于哪一档、距离下次切换还有多久，余额也要另找入口查看。dsh-plugins-price-badge 是社区维护者 cypher-yht 发布的标准 DSH bundle 插件（分类：客户端），在页面右下角挂一个胶囊徽标，用北京时间规则做峰谷判定、倒计时下次切换，并周期性拉取账户余额。下面介绍它做什么、怎么装、使用时要注意什么。

这是什么¶

插件全名对应仓库 cypher-yht/dsh-plugins-price-badge，在 DSH 插件目录 skillhub.cn 可查。它是 DeepSeek Harness 生态里的社区插件，与 DeepSeek / 幻方无官方从属关系；DSH 侧理念是「一切皆插件」，目录站为独立社区站点。

实现上分为两个半区：index.js 在宿主侧提供余额接口；client.js 在浏览器里完成峰谷判定、倒计时与 UI。装完并重启宿主、硬刷新页面后即可生效，无需额外配置文件（资料中未列出可编辑配置项）。

核心功能¶

右下角常驻徽标¶

徽标注册到 shell.overlay 插槽（id: price-badge，order: 50），固定在视口右下角（right/bottom: 16px）。每秒更新一次；外层容器 pointer-events: none，只有徽标本体可点击，尽量不挡正文操作。

峰谷判定（北京时间）¶

计费口径与 README 中的表一致：

徽标文案为「高峰」或「空闲 · 5 折」，圆点分别用警告色 / 成功色。代码不识别法定节假日：若节假日落在上述工作日区间内，仍会显示为高峰；展开面板里也有相应提示。

倒计时与切换提示¶

倒计时不是简单跳到下一个整点，而是向后扫描 8 天内的 09:00、12:00、14:00、18:00 四个边界，找到会让峰谷状态真正翻转的时刻，显示为 mm:ss 或 hh:mm:ss。

峰谷翻转瞬间徽标会短暂放大并带描边光晕，并弹出「已进入高峰时段」或「已进入空闲时段（5 折）」，约 6 秒后自动消失。

展开面板与余额¶

点击徽标可展开约 272px 宽的面板，内容包括当前时段说明、下次切换的具体时刻（北京时间与周几）、余额、完整计费规则，以及法定节假日未单独识别的说明；再点一次或按「收起」关闭。

徽标右侧显示余额，格式为 余额 ¥x.xx；有赠金且大于 0 时显示 余额 ¥x.xx（赠金 ¥y.yy），赠金为 0 时不展示赠金段。客户端每 60 秒请求一次余额；单次失败保留上一次成功值。未登录显示「未登录账户」，接口不可用时显示「余额不可用」。

余额数据来自宿主侧 GET /plugins/price-badge/balance：仅接受回环地址（否则返回 403 local access only），仅 GET（否则 405），服务端缓存 30 秒。响应形态包括 { status: 'ready', currency, balance, bonus? }、{ status: 'signed-out' }、{ status: 'unavailable' }、{ status: 'error', reason }，底层调用 deepseekAccount.getBalance()。

语言¶

内置 zh / en 字典；切换 DSH 语言时面板在原地重渲染，不重新注册插槽。

安装与启用¶

在已安装 DSH CLI 的环境中，从 GitHub 安装：

dsh plugin add github:cypher-yht/dsh-plugins-price-badge

本地改源码调试可用软链（改完即生效，路径换成你的实际目录）：

dsh plugin add link:D:\path\to\dsh-plugins-price-badge

若使用 DSH 桌面客户端（Electron），资料说明其读取 desktop profile，应在桌面端会话里的 plugin_manager 中安装，而不是只装在 Web 用的 profile 里。

经过上面的步骤后，需要重启 DSH 宿主，浏览器端用 Ctrl+F5 硬刷新，徽标才会稳定出现。

典型用法¶

安装并刷新后，日常无需命令行操作：打开 DSH Web 界面即可在右下角看到当前高峰或空闲状态、倒计时和余额摘要。

需要核对规则或下次切换的精确时间时，点一下徽标打开面板即可。若你在非高峰时段批量跑任务，可结合倒计时规划开始时间，避免误落在 09:00–12:00 或 14:00–18:00 的全价窗口（以插件内置表为准，不含节假日特殊安排）。

适用场景与注意¶

适合长期在 DSH Web 里调试模型、编排智能体、关注 API 单价与账户余额的开发者。峰谷逻辑完全在客户端按固定时间表计算，不依赖外部日历 API；余额则依赖本机 DSH 宿主与 DeepSeek 账户登录状态。

安装前建议自行查看 仓库源码 与 MIT 许可证。插件以当前 dsh 进程权限运行；余额接口仅允许回环访问，这是有意限制，避免把账户信息暴露到非本机调用方。社区目录与 GitHub 上的星标数会变动，写作时仓库为 0 star，以你打开页面时为准。

结尾¶

dsh-plugins-price-badge 把 DeepSeek 官方文档里的峰谷计价表，做成 DSH 界面里一眼能看到的徽标加倒计时，并把余额贴在同一行，减少切页面查价、查余额的次数。更多信息见目录页 skillhub.cn/plugins/cypher-yht/dsh-plugins-price-badge 与 GitHub github.com/cypher-yht/dsh-plugins-price-badge。