前言¶
在 DeepSeek Harness（DSH）里长时间对话或跑任务时，账户余额和官方「高峰 / 空闲」计费时段往往要切到平台页面才能确认。DSH 自带输入框下方的上下文占用与 token 用量指标已经够用，但余额、赠送额度、当前模型和用量入口仍缺少一个常驻、轻量的入口。社区插件 @mark.zy/usage-widget（仓库 zy12342/usage-widget）把上述信息收进侧边栏徽章与弹出面板，由维护者 zy12342 以个人分享形式发布，采用 MIT 许可证；当前 package 版本为 1.0.3，要求 DSH Web 客户端 >= 0.2.0。
这是什么¶
该插件是 DSH 的 Web 客户端插件，定位是「账户余额快速查看」：侧边栏底部（设置按钮旁）显示鲸标与余额，窄栏模式下仅显示鲸标；点击打开账户面板。它不再重复展示上下文占用与 composer 里的 token 用量——Harness 已在输入框下方自行渲染，插件 README 明确说明此前曾侧重 context usage，现已改为专注账户信息。
核心功能¶
侧边栏徽章¶
- 显示 Harness 品牌鲸标与当前余额；按主钱包金额（优先 CNY，其次 USD，再取第一个钱包）套用四档质感：低于 10 为红宝石（暗边、宝石红），10–29.99 为琥珀 / 黄水晶，30–99.99 为翡翠，100 及以上为金属黄金（含约 5 秒微光）。
- 同区域标注官方计费时段：
高峰或空闲（北京时间），规则对齐 DeepSeek Models & Pricing：工作日 09:00–12:00、14:00–18:00 为高峰，周末与中国法定节假日为空闲；主机每日同步公开定价页，失败则每小时重试，面板内可看到下次切换时间与最近同步日期。
弹出面板（Popover）¶
点击徽章后展示：
- 大号余额；低于 10 时显示
Low balance警告。 - 赠送额度（bonus credit）。
- 当前模型（来自 DSH 本地
modelSelection投影，不上传）。 - 跳转平台用量页的快捷链接（仅渲染
http:/https:，以noopener noreferrer打开新标签）。
余额在打开面板时刷新，之后每 60 秒自动刷新；未登录或账户服务不可用时徽章显示 -。
主题与安全¶
颜色跟随当前 DSH 主题，明暗模式均可读。各可选服务失败时隔离处理，显示 - 而不阻塞 DSH。客户端不发起外部网络请求、不写 localStorage / cookie / 文件；主机模块仅为计费时段抓取 api-docs.deepseek.com 定价页与 timor.tech 节假日日历，不发送账户数据，不读取 API 密钥或邮箱、手机号。
安装与启用¶
在 DSH 插件管理器中：Settings → Plugins，安装包名 @mark.zy/usage-widget。若从本地源码目录安装 bundle，可在插件管理器中使用 install_bundle，目标指向该目录的绝对路径。
安装或更新后必须完全退出 DSH 再重新打开——客户端插件在启动时加载，仅刷新页面不够。
卸载可在 Settings → Plugins 中禁用或移除，或在终端执行：
dsh plugin --profile desktop remove @mark.zy/usage-widget
典型用法¶
- 安装并重启 DSH 后，在侧边栏底部找到鲸标与余额（或仅鲸标）。
- 点击徽章打开账户面板；点击面板外区域关闭。
- 需要查平台侧用量统计时，使用面板内的平台用量链接。
若安装后看不到徽章：确认插件已启用、已完全重启 DSH；若一直为 -，检查是否已登录 DeepSeek 账户。
适用场景与注意¶
适合经常在 DSH 里开发、调试智能体、又希望少切网页确认余额与高峰计费的开发者。插件以当前 DSH 进程权限运行，安装前建议在 GitHub 阅读源码、SECURITY.md 与许可证（MIT），自行判断是否满足环境要求。
社区目录页：skillhub.cn/plugins/zy12342/usage-widget。DSH 生态强调「一切皆插件」，该目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
usage-widget 把余额、赠送额度、当前模型、计费时段与用量入口收到侧边栏一处，并与 DSH 自带的上下文 / token 展示分工明确。需要时可从目录页或 GitHub 仓库 获取安装说明与问题反馈入口。
