前言¶
在使用 DeepSeek Harness 进行开发或日常对话时，我们通常需要知道当前的余额、近期的 Token 消耗以及价区（峰谷）价格。这些信息在官方平台以卡片或表格形式展示，但需要手动跳转。DeepSeek Harness 提供插件化能力，可以在同一界面中完成这些信息的实时查询与展示。deepseek-balance-dsh 正是为此目的开发的插件，它通过一个悬浮组件在页面右下角提供余额、周期消费、Token 使用与价区提醒。
插件定位¶
deepseek-balance-dsh 是一个面向 DeepSeek Harness 的余额与用量监控插件，由维护者 OwlNjust 维护，分类为联网工具。它通过一个悬浮组件显示总余额、周期消费（今天/24h/7天/自定义）、Token 使用情况（缓存命中/未命中/输出），并提供梁文峰（峰期）与梁文谷（谷期）的价区提醒与倒计时。插件无运行时依赖，通过 npm 包 deepseek-balance-dsh 发布，并在 DeepSeek Harness 中以 bundle-layer 或 manual patch-layer 的方式启用。
核心功能¶
- 余额显示：通过官方
GET /user/balance接口获取总余额与充值余额，轮询间隔默认 5 分钟。 - 周期消费：支持今天、24 小时、7 天、自定义起始日期，按模型拆分消费数据（
/usage/cost）。 - Token 使用：缓存命中输入、缓存未命中输入、输出，与平台仪表盘一致（
/usage/amount）。 - 价区提醒：区分梁文峰（峰期：工作日 09:00–12:00、14:00–18:00，除法定节假日外，价格 ×2）与梁文谷（谷期：其余时间，包括周末与法定节假日，价格 50%），实时倒计时，峰期高亮，节假日显示 🎉 徽章。
- 悬浮组件：右下角悬浮胶囊，显示当前价区、余额与周期消费概览。点击展开面板，支持拖拽调整位置（右键按住胶囊拖动），位置自动保存，窗口调整时自动回弹。面板底部提供「重置位置（右下角）」按钮。
- 语言跟随：优先使用宿主偏好，否则使用浏览器语言；面板顶部提供 EN/中 切换按钮，状态本地保存。
安装与启用¶
插件以 bundle-layer 方式安装（推荐），需要 DeepSeek Harness 版本 ≥ 0.2.0。
- 在终端中执行以下命令之一（选择一个即可）：
dsh plugin --profile <profile> add deepseek-balance-dsh
或
dsh plugin --profile <profile> add https://github.com/OwlNjust/deepseek-balance-dsh
-
使用桌面应用：菜单栏 → “Manage plugins” → 输入
deepseek-balance-dsh或仓库地址，确认安装。 -
重启 DeepSeek Harness（
dsh web或桌面应用重启），刷新页面后右下角应出现悬浮胶囊。
本地 checkout + 手动 patch-layer 的方式需要编辑 ~/.dsh/profiles/web/cordis.patch.yml，详见 README 的 Route B。
配置与使用¶
- API Key / userToken：点击悬浮胶囊 → 配置，粘贴 DeepSeek API Key（从 platform.deepseek.com → API keys 获取），可选粘贴 userToken（从 DevTools → Application → Local Storage 获取，用于精确统计）。
- 时间窗口：点击胶囊展开面板，使用顶部标签切换今天、24h、7天或自定义日期。
- 刷新：面板内「刷新」按钮，或依赖配置的
pollIntervalMs（默认 5 分钟）；标签页隐藏时自动暂停轮询。 - 语言：默认跟随宿主/浏览器；面板顶部 EN/中 按钮可手动切换，状态本地保存。
- 拖拽布局：右键按住胶囊拖动到任意位置；左键点击展开面板；窗口调整时胶囊自动回弹到视图内；面板底部「重置位置（右下角）」恢复默认。
架构与权限¶
插件采用模块化结构，host 端负责配置校验、状态/服务构建、路由注册与定时轮询；client 端通过 window.__ModuleLoader__ 加载悬浮组件与本地化文案。所有 /dsbal/* 路由均通过宿主的认证门禁（ctx.connection.admit(req)），基于 Host/Origin 信任与浏览器 Cookie 认证。配置与历史状态存储于 ~/.deepseek-balance.json（权限 0600），避免明文泄露。
注意事项¶
- 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证（MIT）。
- 不要同时使用 bundle-layer 与手动 patch-layer，否则可能重复插入插件条目（建议使用
dsh --profile web --dump-config | grep -c 'id: deepseek-balance-dsh'检查条目数量）。 - npm 包名为
deepseek-balance-dsh，不要使用dsh-deepseek-balance（该名称属于无关项目）。 - 卸载时需从
cordis.patch.yml移除插件条目，并删除node_modules/deepseek-balance-dsh目录。
适用场景¶
- 需要持续监控 DeepSeek 账户余额与周期消费的开发者。
- 需要实时了解峰谷价区与倒计时的用户，以优化调用时机。
- 使用 DeepSeek Harness 进行批量调用或长时间对话，希望在一个界面获取多维度数据。
总结¶
deepseek-balance-dsh 将余额、周期消费、Token 使用与价区提醒集成到 DeepSeek Harness 的右下角悬浮组件中，避免手动切换平台页面，提升使用效率。插件安装简单、配置透明，适合需要精细管理与成本控制的场景。
- 目录页：https://www.skillhub.cn/plugins/OwlNjust/deepseek-balance-dsh
- GitHub：https://github.com/OwlNjust/deepseek-balance-dsh
