前言¶

在 DeepSeek Harness（DSH）里跑 web profile 时，模型调用会消耗平台账户余额。若只在 DeepSeek 开放平台网页里查账，需要切换上下文；Harness 侧又缺少统一的余额与用量视图。社区插件 dsh-deepseek-balance（仓库 DSH-DeepSeek-Balance，维护者 OwlNjust）在浏览器右下角提供悬浮组件，轮询官方接口展示余额与周期消耗，并按官方定价文档标注峰时「梁文峰」与谷时「梁文谷」窗口。下面介绍其定位、能力与安装用法。

这是什么¶

dsh-deepseek-balance 是面向 DeepSeek Harness web profile 的联网类插件：零 npm 运行时依赖，通过 Harness 插件管理器以 GitHub 包或本地 link 方式接入。它在页面右下角显示可拖动的「药丸」摘要，展开后可配置 API key、选择统计时间窗并手动刷新；服务端定期拉取 DeepSeek 官方 balance / usage 接口，状态持久化在本地配置文件中。

核心功能¶

以下能力均来自仓库 README 与 package.json 说明（当前包版本 0.2.0，MIT 许可证）。

余额与用量

• 通过官方 GET /user/balance 获取总余额与充值余额，默认每 5 分钟轮询一次。
• 周期消耗：支持今天、24 小时、7 天或自定义起始日，并按模型拆分（/usage/cost）。
• Token 用量：cache-hit 输入、cache-miss 输入、输出，与平台控制台口径一致（/usage/amount）。可选填写平台 userToken 以获取更精确的费用与 token 统计；未配置时消耗估算会回退到余额快照方式。

峰谷价提醒

• 梁文峰（峰时）：北京时间周一至周五 09:00–12:00、14:00–18:00，不含法定节假日，价格为基准 ×2。
• 梁文谷（谷时）：其余时段，含周末与法定节假日全天，价格为基准 50%。
• 界面提供当前窗口、倒计时；峰时高亮，节假日有标识。窗口规则遵循 DeepSeek 官方定价说明。

交互与界面

• 右键按住药丸可拖动位置，左键展开面板；面板内可「重置位置（右下角）」。
• 语言跟随 Harness 或浏览器，面板头栏可手动切换中/英并本地记忆。
• 标签页隐藏时暂停自动刷新；展开面板后可通过「刷新」立即拉数。

服务端接口

• 插件注册 /dsbal/* 共四条路由，需先通过 Harness 与 /api 相同的 Host/Origin 与会话校验；未登录返回 401，跨站 403。可选验证：curl -s http://127.0.0.1:3080/dsbal/state（在 web 服务已启动且已登录会话的前提下理解其结果）。

环境与依赖¶

• 已部署 DeepSeek Harness，并使用 web profile（dsh web）。
• Node.js ≥ 20。README 注明曾在 v0.1.2-rc.1 适配验证，并复测至 v0.2.0-rc.2，多版本间插件本身未改用法。
• DeepSeek API key（platform.deepseek.com → API keys）。
• 可选：userToken（platform.deepseek.com → DevTools → Application → Local Storage）。

安装与启用¶

安装只需一步：把仓库 URL 交给 Agent，或由插件管理器添加同一地址。包内声明 dsh.bundle.patch，Harness ≥ 0.2.0 时推荐走 profile bundle 路线，无需手改 patch 文件。

路线 A（推荐）

桌面端：菜单栏 →「Manage plugins」→ 输入：

https://github.com/OwlNjust/DSH-DeepSeek-Balance

CLI（将 <profile> 换成实际 profile 名，例如 web）：

dsh plugin --profile <profile> add https://github.com/OwlNjust/DSH-DeepSeek-Balance

管理器会把包写入 profile 的 dsh.profile.bundles，并应用包内 cordis.patch.yml 激活插件。重载或重启 profile 后，右下角应出现组件。

勿混用两种安装方式

若已用路线 A，不要再在 profile 的 cordis.patch.yml 里手写同名 insert，否则插件 id 可能被插入两次，排查困难。自检（结果应为 1）：

dsh --profile web --dump-config | grep -c 'id: dsh-deepseek-balance'

若输出为 2，按 README「Agent notes」删除手写块或从 bundles 移除其一，再重启 dsh web。

首次配置

硬刷新页面（如 Ctrl+Shift+R）后，点击组件 → 配置 → 粘贴 API key（可选 userToken）→ 保存。凭据与余额历史写在 ~/.deepseek-balance.json（权限 0600），请勿在日志或终端中 echo 该文件内容。

卸载

从 cordis.patch.yml 移除对应行（若仅通过 bundle 安装则按管理器流程移除 bundle），删除 profile 下 node_modules/dsh-deepseek-balance，重启 dsh web。

典型用法¶

在 profile 的 patch 层可为插件 id 覆盖配置（config: 会整对象替换，未列字段用默认值）。示例字段：

- id: dsh-deepseek-balance
  config:
    pollIntervalMs: 900000     # 轮询间隔，30s .. 24h，默认 5 min
    historyDays: 180           # 快照保留 / 自定义窗口上限，1 .. 400，默认 90

适用场景与注意¶

适合谁

• 长期在 DSH web 里开发或调试、希望不离开 Harness 页面即可盯余额与近期消耗的智能体开发者。
• 需要对照官方峰谷时段控制批量调用成本的用户（提醒依据官方文档，非 Harness 内置能力）。

安全与权限

• 插件与当前 dsh 进程同权限 运行，并代表你向 DeepSeek 平台发起 HTTPS 请求；安装前应阅读 GitHub 源码 与 MIT 许可证，确认可接受凭据本地存储方式。
• 写入凭据的路由仅面向已登录的本地浏览器会话；仍勿在不可信环境暴露 web 控制台。

生态说明

DSH 采用「一切皆插件」的扩展方式；SkillHub 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-deepseek-balance 把 DeepSeek 账户余额、分模型消耗、token 分项与峰谷价窗口收进 Harness web 右下角，配置 API key 即可使用。进一步了解可访问目录页与仓库：

• 目录：https://www.skillhub.cn/plugins/OwlNjust/DSH-DeepSeek-Balance
• GitHub：https://github.com/OwlNjust/DSH-DeepSeek-Balance