前言¶
用 DeepSeek Harness（DSH）写智能体或长对话时，Composer 里选模型、切 Provider 是常态，但余额落在哪张钱包、当前模型按什么单价计费、此刻是高峰还是空闲，往往要另开页面或凭记忆估算。下面介绍社区插件 @jimmyzm/dsh-billing-card：在 Web GUI 侧边栏底部固定一张卡片，把账户或开放平台余额、所选模型的 input/cache/output 单价，以及高峰/空闲时段与切换倒计时放在同一视图里，并随 Composer 的模型与计费 Provider 联动刷新。
这是什么¶
维护者为 jimmyzm，插件分类为客户端，以 npm 包 @jimmyzm/dsh-billing-card 发布，许可证 MIT。当前资料中的版本为 1.3.0。
定位一句话：DSH 侧边栏 footer 卡片——余额、实时单价、高峰/空闲倒计时；中文界面还可显示法定节假日与调休标签。
核心功能¶
余额¶
展示 DSH 账户余额（充值 + 赠送），或在你切换到「按 DeepSeek 开放平台计费」的 Provider 时，改为展示 API Key 对应开放平台余额——以 Composer 当前选中的计费 Provider 为准。余额约每 30 秒刷新；切换 Provider 时会立即重新拉取开放平台余额。
未配置 DEEPSEEK_API_KEY 时显示 DSH 账户余额；未登录 DSH 账户时则显示开放平台余额（而非空白）。
单价与 Provider 行¶
卡片按「事实一行」排版：Provider 名称在模型行上方，便于对照价格归属渠道。对当前选中模型展示 input、cached、output 单价，且对应当前生效的计费档位（高峰/空闲）。若模型由非 DeepSeek 官方 Provider 提供，则不显示价格。
界面语言为中文时引用官方定价页的 CNY 报价，其他语言引用 USD 页面；不做货币换算，余额仍保持钱包原币种。
计费时段与倒计时¶
高峰定义为北京时间周一至周五 09:00–12:00、14:00–18:00，法定节假日除外；其余为空闲（Idle）。卡片用绿色 Idle、黄色 Peak 标识当前时段，左上角倒计时保留 Peak in / Idle in 文案并随时段着色。
节假日（中文界面）¶
中文 UI 下可在卡片顶部显示蓝色节假日名称条；调休工作日显示灰色 调休 芯片。上游日历拉取失败时使用内置数据。
主题与交互¶
卡片自带 --dbc-* 主题 token，随应用明/暗主题切换；中英字典内置。余额数字、模型名、时段芯片等支持悬停说明（240 ms 延迟，无空间时在下方展开）；价格块与节假日条本身不再叠一层 hover 文案。
侧边栏收起到图标轨时卡片会隐藏；需要带 Web GUI、sidebar footer 插槽与 account 服务的 DSH 构建。
安装与启用¶
依赖 DSH 0.2.0-rc.1 或更新（package.json 中 engines.dsh 声明范围；footer 插槽、locale 与 webServer 等服务在该版本起可用）。README 注明端到端验证环境含 DSH 0.2.1-rc.3。
按你实际使用的 profile 安装（桌面应用用 desktop，dsh web 用 web）。以下命令与 DSH 插件页「从 npm 安装」等价：
dsh plugin --profile web add @jimmyzm/dsh-billing-card
插件 Host 半部在每次应用启动时加载一次，安装或升级后需重启应用；重启前卡片会使用内置数据。安装完成后刷新 GUI，卡片出现在侧边栏底部。
卸载：
dsh plugin --profile web remove @jimmyzm/dsh-billing-card
典型用法与工作方式¶
无需额外配置文件：安装并重启后，打开带 Web GUI 的 DSH（如 dsh web），在 Composer 中选择模型与 Provider，即可在侧边栏底部查看余额与单价。Client 半部挂在 sidebar.footer.action，通过 GET /deepseek-billing-card/data 读取 Host 在启动时拉取的价目表与中国大陆节假日日历，并跟随 Composer 模型选择器。
Host 侧数据来源（资料原文）：
| 内容 | 来源 |
|---|---|
| 账户余额、模型 | DSH account 服务；Composer 模型选择 |
| 开放平台余额 | GET https://api.deepseek.com/user/balance，授权使用 Models 页存储的 DEEPSEEK_API_KEY（启动环境为后备） |
| 价格 | 中文定价页 与 英文定价页 |
| 节假日 | https://calendars.icloud.com/holidays/cn_zh.ics |
价目与节假日在每次应用启动时各读取一次；无 HTTP GUI 或无 uiSession / modelDirectories 服务时，会退回到内置副本或对目录默认模型报价。
适用场景与注意¶
适合长期在 DSH Web 界面里切换模型、关心 DeepSeek 高峰/空闲单价差异，或需要一眼看到 DSH 账户与开放平台余额切换的用户。
使用前请注意：
- 插件以当前 DSH 进程权限运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
- 价格与节假日不会在运行中自动更新，需重启应用才能重新抓取上游。
- 非 DeepSeek 官方 Provider 服务的模型无单价行。
- 社区目录 SkillHub 插件页 与 GitHub 为独立生态入口，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-billing-card 把计费相关的「余额—单价—时段」收进侧边栏 footer，减少切页查价。进一步了解可访问目录页 jimmyzm/dsh-billing-card 与仓库 github.com/jimmyzm/dsh-billing-card。
