1514100951/dsh-usage-footer
DSH web 用量/费用悬浮按钮插件：账户余额、峰谷时段、今日/本会话消费估算与 token 统计（含设置开关）
安装Install
dsh plugin --profile web add github:1514100951/dsh-usage-footer把 1514100951/dsh-usage-footer 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
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后显示
- 账户余额：官方 API
- 自助开关：设置 → 通用 → 「用量与费用栏」开启/关闭，实时生效；关闭后停止轮询、服务端路由拒绝查询
- 视觉：毛玻璃面板（backdrop-blur + 半透明菜单底色）、表格数字（tabular-nums）、细线分隔、入场位移+缩放动画，全部使用宿主
--dsw-*设计令牌，自动适配明暗主题
说明：账户级"今日/本月用量与消费"的官方数据源（platform.deepseek.com 私有接口）需要浏览器登录态
userToken，配置DEEPSEEK_PLATFORM_TOKEN后可用；未配置时"今日消费"来自余额差值快照、"本机今日用量"为本机观测估算。
安装方法（任意机器通用）
1. 前置条件
- 已安装并运行
dsh web（DeepSeek Harness 的 Web 界面） - 凭证中已配置
DEEPSEEK_API_KEY（写入$DSH_HOME/.credentials.yaml或环境变量，格式DEEPSEEK_API_KEY: sk-...） - 可选：
DEEPSEEK_PLATFORM_TOKEN（platform.deepseek.com 浏览器登录态的userToken），用于显示本月账户用量 - 宿主插件依赖
@deepseek-ai/schemastery：在本仓库根目录执行一次pnpm install（或把本机 DSH 模块目录 junction 到本仓库的node_modules/）
2. 把两个包放进 DSH 的模块目录
DSH 的宿主 Loader 与浏览器模块扫描器都按包名从 $DSH_HOME/profiles/node_modules（模块回退目录）解析插件。将本仓库的两个包目录链接或复制到该目录下：
dsh-usage-status→$DSH_HOME/profiles/node_modules/dsh-usage-statusdsh-client-ui-usage-footer→$DSH_HOME/profiles/node_modules/dsh-client-ui-usage-footer
Windows 上建议用 junction，之后改本仓库代码即生效：
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-usage-status" -Target "<本仓库路径>\packages\dsh-usage-status"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-client-ui-usage-footer" -Target "<本仓库路径>\packages\dsh-client-ui-usage-footer"
macOS/Linux 同理，用 ln -s 链接到 ~/.dsh/profiles/node_modules/ 下；直接复制目录也可以。
3. 在 Web profile 的组合里注册两行
编辑你的 web profile 补丁文件 $DSH_HOME/profiles/web/cordis.patch.yml，追加：
- insert:
- id: usage-status
name: dsh-usage-status
- id: ui-usage-footer
name: dsh-client-ui-usage-footer
该文件被运行中的 dsh web 热监听，保存后宿主行自动挂载；随后刷新浏览器页面即可看到悬浮按钮。想完全卸载时，把这两行置 disabled: true。
修改后如何生效
- 客户端 bundle（UI）：改
packages/dsh-client-ui-usage-footer/lib/client.js后，刷新浏览器页面即可（bundle 按请求实时读取、no-cache）。 - 宿主插件（API 路由 / 设置注册）：改
packages/dsh-usage-status/lib/index.js后，重启dsh web（宿主模块按进程缓存，无热重载）。
本地检查
pnpm run check # 语法检查两个入口文件
设置持久化
开关状态写入两处并保持一致：浏览器 localStorage（dsh-usage-footer.enabled，无需重启即可用）与宿主设置文档（重启一次 dsh web 后生效，存于 settings.yaml 的 usage-footer 段）。
安全说明
- 本项目代码不含任何密钥；API Key 始终通过 DSH 凭证服务在宿主侧解析
GET /usage-status路由仅接受本机回环（loopback）请求，局域网访问返回 403
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…