前言¶
在 DeepSeek Harness（DSH）里切到 DeepSeek 线路后，计费时段和账户余额往往要另开网页或 Settings 才能确认。下面介绍的 dsh-plugin-deepseek-clock 由社区维护者 Elmeis 发布，分类为客户端插件：在 Composer 工具栏、模型选择器旁增加一块仅在 DeepSeek 路由选中时出现的 chip，用绿/红点表示北京时间的峰谷窗口，并显示 API Key 或已登录账号的充值余额摘要。
这是什么¶
插件全名 dsh-plugin-deepseek-clock（npm 包名与安装名一致）。它在会话当前 provider 为 DeepSeek 路由（如 deepseek-official、deepseek-account 等）时，于 Composer 工具行注入 contextual meter；选其他 provider 时不改动该行、也不渲染 chip。
维护者：Elmeis。源码与说明见 GitHub 仓库；社区目录页：skillhub.cn 插件页。DSH 社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
Chip 表面¶
- 圆点：绿色表示谷时（半价），红色表示峰时；峰谷规则在本地计算，不发起网络请求。
- 文字：余额数字。来自 API Key 时形如
$12.34；来自已登录账号的 Platform 钱包时形如$14.46。账号已登录但读不到钱包时显示login；两种路由都不可用时显示no key。
弹出层（Popover）¶
除 chip 外，popover 展示：当前窗口的时段表、下一次切换时间、当前窗口下每 1M tokens 的 published 费率、充值/赠送余额及账号状态。
峰谷时段（北京时间 UTC+8）¶
DeepSeek 在峰时外按半价计费。峰时为周一至周五 09:00–12:00、14:00–18:00；其余夜间与周末为谷时（与 官方定价页 一致）。插件不跟踪中国法定节假日，因此法定假日若落在周一仍会按峰时规则显示。
Popover 中列出的 Flash / Pro 模型在当前窗口下的 per 1M 费率（CNY；余额为 USD 时也会展示 USD 相关展示），例如：
| per 1M | cached | input | output |
|---|---|---|---|
| Flash（谷 / 峰） | 0.02 / 0.04 | 1 / 2 | 4 / 8 CNY |
| Pro（谷 / 峰） | 0.15 / 0.30 | 4.5 / 9 | 13.5 / 27 CNY |
余额来源¶
| 事实 | 来源 |
|---|---|
| 峰谷窗口 | 本地计算 |
| 余额（API Key） | GET https://api.deepseek.com/user/balance，携带 DEEPSEEK_API_KEY |
| 余额（账号） | grant 记录 deepseek-account-platform/* 与 Platform 钱包 |
API Key 路径：Key 的解析顺序与 DSH 一致——ctx.credentials → 环境变量 → $DSH_HOME/.credentials.yaml 的 refs 块。接口返回 balance_infos（含 currency、total_balance、granted_balance、topped_up_balance 等）。
账号（设备登录）路径：使用 deepseek-account-platform/default 中存储的 grant，以 x-dsh-auth-token 请求 GET https://platform.deepseek.com/api/v0/users/get_user_summary（与应用 Settings 卡片同源）。data.biz_data.normal_wallets 为充值余额，bonus_wallets 为赠送余额。Token 不离开宿主进程；仅当 grant 的 issuer 与配置的 platformOrigin 一致时才请求。
两者同时存在时以 API Key 为准。读数缓存一分钟；刷新失败时保留上次成功值并标记 stale。
服务端路由¶
插件暴露：
GET /api/deepseek/meter[?refresh=1]
→ { ok, price, account, api, rates, fetchedAt }
行配置中可覆盖 apiBase（默认 https://api.deepseek.com）。
安装与启用¶
DSH Desktop：Settings → Plugins → add plugin，输入包名。
CLI 示例（<your-profile> 与 <name> 按你的 profile 与包名填写）：
dsh plugin --profile <your-profile> add <name>
安装使用的包名为：
name: dsh-plugin-deepseek-clock
添加后需重启 harness 方可加载。
运行环境（来自 package.json）：Node >=20，DSH >=0.2.1-0 且 <0.3.0。许可证 MIT，当前资料中版本为 0.1.0。
典型用法¶
无需单独配置文件即可使用：在 DSH 中选择 DeepSeek 路由，Composer 工具行会出现 chip；点击可查看 popover 中的时段与费率。
维护者在仓库中提供自检命令：
node test/smoke.mjs # 固定时刻的峰谷边界、余额路由、账号检测、非 DeepSeek provider 下 chip 不渲染
node test/preview.mjs # 渲染 chip + popover 便于截图
Smoke 测试将时钟固定在 2026-10-26（周一），断言北京时间窗口边界、余额规范化、一分钟缓存、stale 回退、no key 场景等。
适用场景与注意¶
适合：经常在 DSH Composer 里使用 DeepSeek 官方或账号路由、希望在选模型旁一眼看到峰谷与余额的开发者。
限制（README 明示）：
- 不建模法定节假日。
- Chip 只显示一种余额货币；popover 取 API 返回的第一条
balance_infos。 - 账号路由读 Platform 钱包，不提供逐请求消耗明细（需在 Platform「View usage」查看）。
安全与权限：插件以当前 DSH 进程权限运行，会读取 credentials、环境变量及 $DSH_HOME/.credentials.yaml，并在有 Key 或合法 grant 时访问 DeepSeek API / Platform。安装前请阅读 源码 与 MIT 许可证，确认符合你的密钥与合规要求。
客户端插件若误用 inject 参数或未完成 remote.session 声明，chip 可能静默不出现；实现细节见仓库 README「Client-runtime notes」一节。
结尾¶
dsh-plugin-deepseek-clock 把 DeepSeek 峰谷价窗口与余额摘要收进 Composer 工具行，且仅在 DeepSeek 路由选中时出现，避免干扰其他 provider。更多信息与 issue：
- 目录页：https://www.skillhub.cn/plugins/Elmeis/dsh-plugin-deepseek-clock
- GitHub：https://github.com/Elmeis/dsh-plugin-deepseek-clock
