前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在开发或调用 DeepSeek API 的过程中，实时监控余额、Token 消耗以及请求频率至关重要。dsh-deepseek-balance 是为此需求设计的 Web 界面插件，它将 API 用量信息直接嵌入到侧边栏中，无需离开当前页面即可掌握核心数据。
这是什么¶
这是一个 DeepSeek Harness (DSH) Web 界面插件。由开发者 qianTouchFish 维护，采用 MIT 许可证。它的核心作用是在侧边栏常显 DeepSeek API 的用量条，并提供展开卡片以查看更详细的消费数据。
核心功能¶
-
侧边栏常显用量条
在侧边栏「设置」按钮正上方，常显余额、消费金额、API 请求次数和 Tokens。数据每分钟自动刷新，当余额较低时会变为黄色警示。 -
展开查看详细数据
点击用量条可展开完整卡片。支持按模型和时间维度（今天、昨天、近7天、近30天、本月、上月）查看消费，并附带迷你柱状图。 -
官方累计消费
显示官方累计消费数据。此数据来源于平台控制台，需配置平台令牌；若未配置，系统会自动回退为余额差值估算。 -
高峰/空闲时段标识
在模型选择器旁实时显示当前计费时段。北京时间 09:00-12:00 和 14:00-18:00 标识为高峰时段，其余为空闲时段。 -
令牌一键获取
支持从本机 Chrome、Edge 或 Chromium 浏览器一键提取平台令牌（DEEPSEEK_PLATFORM_TOKEN）。 -
主题与持久化
插件自动适配浅色/深色主题。时间维度、API Key 和模型选择会自动持久化保存。
安装¶
在终端执行以下命令：
dsh plugin --profile web add github:qianTouchFish/dsh-deepseek-balance
安装完成后，重启 Web 应用（桌面图标或 dsh web）并刷新页面，侧边栏底部即可看到用量条。
配置与使用¶
-
填写 API Key
首次使用需到 DSH 的「设置 → 模型」页面填写DEEPSEEK_API_KEY。 -
获取官方数据
若需查看官方累计消费和更精确的数据，打开用量卡片，点击底部【自动获取】按钮。插件会尝试从本机已登录 https://platform.deepseek.com 的浏览器中提取令牌。 -
手动配置令牌（可选）
如果自动获取失败，可手动获取。在浏览器登录平台后，按F12打开控制台，执行以下代码提取令牌：
JSON.parse(localStorage.getItem('userToken')).value
将获取到的令牌追加到 ~/.dsh/.credentials.yaml 文件中：
DEEPSEEK_PLATFORM_TOKEN: <那串令牌>
注意事项¶
- 本插件依赖已安装的 DSH CLI 与 pnpm。
- 使用【自动获取】功能时，浏览器必须已登录 https://platform.deepseek.com，且不支持隐身模式。若浏览器使用非默认配置（如 Profile N），需在插件设置中调整。
总结¶
dsh-deepseek-balance 通过在侧边栏提供常显的用量条和展开的详情卡片，解决了开发者频繁切换页面查看 API 余额和消费的痛点。配合高峰时段标识和自动刷新机制，能更好地辅助智能体开发和成本控制。
插件目录：[catalog_url]
GitHub 仓库：[github_url]
