dsh-usage-footer

DSH Web 界面「用量与费用」插件（独立项目），包含两个包：

包	角色	入口
dsh-usage-status	宿主插件：注册 GET /usage-status 路由（查询 DeepSeek 余额 API），并注册 usage-footer 设置命名空间作为开关门控	lib/index.js
dsh-client-ui-usage-footer	浏览器插件：在页面右下角渲染一枚悬浮金币按钮，悬停/点击弹出用量面板；并在 设置 → 通用 增加「用量与费用栏」开关	lib/client.js（自包含 bundle）

功能

• 悬浮按钮（右下角）：悬浮圆钮（金币徽标），外环与角点颜色指示当前时段——绿=空闲、琥珀=高峰（呼吸动画）、红=余额查询失败
• 悬停弹窗（120ms 延迟出现、260ms 宽容关闭；点击可钉住，点外部/Esc 关闭；自按钮左上方展开）：
  • 账户余额：官方 API GET https://api.deepseek.com/user/balance（每 60 秒刷新，点击"更新"手动刷新），含充值/赠送拆分
  • 峰谷时段：按北京时间实时判定高峰/空闲，显示当前时刻与下次切换时间，并附 24 小时峰谷条（高峰 9:00-12:00 / 14:00-18:00，当前小时高亮）
  • 本会话用量：累计 token + 输入（未缓存）/缓存命中/缓存写入/输出 四项分条
  • 今日消费（余额差值，官方口径）：当天首次查询时把余额快照写入 $DSH_HOME/usage-footer-balance-baseline.json，之后每次查询用「当日快照 − 当前余额」算出今日真实消费（已对充值/赠送做修正运算，日切自动重锚）；余额结算有延迟，且不含当日首次查询前产生的消耗
  • 本机今日用量（token 统计）：按会话去重累计本机今日产生的 token，显示 token 数与按峰谷价目估算的金额（空闲/高峰两档），日切自动清零，存于浏览器 localStorage（dsh-usage-footer.today.v1）；这是本机观测统计，非官方账单
  • 消费估算（本会话）：token 数 × DeepSeek 峰谷定价（2026-08-17 起，deepseek-v4-pro），空闲/高峰两档并排
  • 本月账户用量（可选）：配置 DEEPSEEK_PLATFORM_TOKEN 后显示
• 自助开关：设置 → 通用 → 「用量与费用栏」开启/关闭，实时生效；关闭后停止轮询、服务端路由拒绝查询
• 视觉：毛玻璃面板（backdrop-blur + 半透明菜单底色）、表格数字（tabular-nums）、细线分隔、入场位移+缩放动画，全部使用宿主 --dsw-* 设计令牌，自动适配明暗主题

说明：账户级"今日/本月用量与消费"的官方数据源（platform.deepseek.com 私有接口）需要浏览器登录态 userToken，配置 DEEPSEEK_PLATFORM_TOKEN 后可用；未配置时"今日消费"来自余额差值快照、"本机今日用量"为本机观测估算。

安装方法（任意机器通用）

1. 前置条件