前言¶
用 DeepSeek Harness（DSH）跑 Web 界面时，钱包余额、本月大概花了多少、当前是峰时还是谷时，往往要另开页面或自己对照定价表心算。本地会话日志里已经有 token 用量，但默认界面不会把这些信息收成一块可点的摘要。
下面介绍社区插件 dsh-usage-dashboard（维护者 MrXiongBear，分类：客户端）。它在 DSH Web 左下角侧边栏实时显示 API 余额、基于本地用量的消费估算、峰谷时段倒计时；点击可展开完整用量仪表盘，并可在面板里切换默认 LLM 服务商。数据在本机读取与展示，不上传第三方服务器。
这是什么¶
dsh-usage-dashboard 是面向 DSH Web 的客户端 bundle 插件：Host 端通过 Cordis 补丁注册认证路由，浏览器端注入侧边栏与布局相关模块，在左下角固定展示摘要，点击打开仪表盘。
仓库说明其为实验性、自用性质，紧贴 DSH 的 apply / inject / client bundle 等接缝，仅在作者验证过的 DSH 版本上测试；宿主升级后可能失效。代码与文档标注为 AI 生成，未经专业人工审计，生产环境需自行评估。
许可为 MIT（package.json 版本 1.0.0）。社区目录页：skillhub.cn 插件页；源码与说明：GitHub 仓库。
核心功能¶
侧边栏摘要¶
- 余额：通过
deepseekAccount.getBalance读取 DeepSeek 账户钱包（人民币 / 美元），固定显示，不可在设置里关闭。 - 消费估算：按本地持久化的 token 用量，结合每次调用所处峰时或谷时对应单价估算，不是官方账单。
- 峰谷倒计时：按北京时间与 DeepSeek 官方计费窗口计算。峰时为周一至周五
09:00–12:00、14:00–18:00（不含法定节假日）；其余含周末与节假日为谷时。显示形如峰时：01:32:10或谷时：15:00:00，峰时与谷时用颜色区分（文档描述为珊瑚红 / 绿色，标签文字仍保留）。
底部固定两行：第一行 余额 + 消费，第二行 峰谷状态 + 倒计时。消费过长时在行内省略，完整值可在仪表盘中查看。
完整用量仪表盘¶
点击侧边栏摘要打开面板，主要包括：
- Token 用量：日 / 月 / 年 / 全部累计及各自估算消费；面板内 token 为完整千分位，左下角摘要仍用紧凑单位。数据来自本机 DSH 会话日志（含缓存命中与推理 token），按会话版本缓存。
- 分任务用量：按会话列出标题、今日与累计 token、今日估算消费；子代理带
sub标记，最近活跃带recent。支持按标题或 ID 搜索、按今日或累计 token 排序，默认 12 条，可展开至最多 100 条。 - 默认 API 切换：列出可用
llm服务商与模型，切换后写入agentDefaultModel，对新建会话生效。
侧边栏显示设置¶
仪表盘内「侧边栏显示」可开关：消费估算、峰谷状态、日 / 月 / 年 token（日 / 月 / 年默认关）；余额不可关。字号 10px–16px，默认 12px。配置保存在浏览器 localStorage 键 dsh-usage-dashboard:footer-items。
Host 端在 /api/usage-dashboard/ 下提供需认证的 Connection Fetch 路由；价格表 PRICING_CNY、2026 年节假日 HOLIDAY_RANGES_2026 等在 index.js 中维护，定价与国务院通知链接见 README「已知限制」。
安装与启用¶
DSH 的 profile 加载为全有或全无：任一插件 import 失败可能影响整个 profile。安装前建议备份 profile 内的 package.json 与 cordis.patch.yml。
官方安装命令（Web profile）：
dsh plugin --profile web add github:MrXiongBear/dsh-usage-dashboard
装完后重启 dsh web，左下角应出现摘要区域。
若提示需要 allowBuilds 授权，将 pnpm 输出的包名写入该 profile 的 pnpm-workspace.yaml：
allowBuilds:
dsh-usage-dashboard: true
然后重新执行上面的 add。本项目为纯 JavaScript，通常不会触发构建授权。
如需锁定 commit，避免后续更新静默变更运行代码：
dsh plugin --profile web add github:MrXiongBear/dsh-usage-dashboard#<commit-sha>
查看与卸载：
dsh plugin --profile web list
dsh plugin --profile web remove dsh-usage-dashboard
插件以当前 DSH 进程权限运行；安装前宜浏览仓库源码与 MIT 许可条款，确认符合你的安全与合规要求。
典型用法¶
- 按上一节命令安装并重启
dsh web。 - 若需看余额，使用已登录 DeepSeek 账户的环境（仅用 API Key 时仍可用 token 统计与服务商切换，但余额不可用）。
- 日常在左下角查看余额、估算消费与峰谷倒计时；需要明细时在摘要上点击进入仪表盘，搜索或排序任务用量，在面板中调整侧边栏显示项与字号。
- 若要更换默认模型，在仪表盘「默认 API 切换」中选择服务商与模型，之后新建会话会使用新默认值。
适用场景与注意¶
适合：长期在单机 DSH Web 上开发智能体、希望少开外部页面、用本地日志粗算消费并关注 DeepSeek 峰谷计费的开发者。
限制（来自 README）：
- Token 统计仅覆盖当前机器上的 DSH，不含其他工具或设备。
- 节假日表目前只覆盖 2026 年；跨年后需更新
index.js中HOLIDAY_RANGES_2026，否则仪表盘会提示峰谷判断可能失效。 - 官方调价后需更新
index.js中PRICING_CNY。 - 余额依赖 DSH 自身认证通道；隐私说明称无第三方依赖、无外部脚本与埋点。
卸载或回滚：从 dsh.profile.bundles 移除登记 → pnpm remove 或删除 link → 重启；异常时用备份的 package.json 与 cordis.patch.yml 还原。
结尾¶
dsh-usage-dashboard 把余额、估算消费、峰谷倒计时和分任务 token 用量收到 DSH Web 左下角与可展开面板里，并支持切换默认 LLM，适合在本机 DSH 上持续跑 Web 工作流的开发者。DeepSeek Harness 生态强调「一切皆插件」；社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
- 目录页：https://www.skillhub.cn/plugins/MrXiongBear/dsh-usage-dashboard
- GitHub：https://github.com/MrXiongBear/dsh-usage-dashboard
问题可在仓库 Issues 反馈。
