Sev7een/ds-api-usage
61最近提交 2026年8月13日
ds-api-usage DSH 插件
安装后，DeepSeek Harness 的设置页面会新增一个“API 用量”页面。该页面显示账户余额、估算花费、Token 数量和 API 请求次数（最近 24 小时或 14 天），并以时间线柱状图呈现。插件复用已有的 DEEPSEEK_API_KEY 凭据，无需额外配置。
如何安装 ds-api-usage DSH 插件
dsh plugin --profile web add github:Sev7een/ds-api-usage复制不会执行命令。安装 ds-api-usage DSH 插件前请核对仓库和版本。
ds-api-usage DSH 插件数据来源
ds-api-usage DSH 插件快照日期：2026年8月16日
discovered
ds-api-usage DSH 插件能做什么
- 显示余额卡片，包含总余额、赠送/充值拆分、币种代码和可用性徽章，数据来自官方 DeepSeek API。
- 展示指标卡片：24 小时估算花费（CNY）、输入/输出 Token 计数和 API 请求次数。
- 提供时间线柱状图，支持 24 小时（每小时）或 14 天（每日）视图，可在成本、Token 和请求次数之间切换，悬停查看精确值。
- 客户端每 30 秒自动刷新，并带有手动刷新按钮；主机端余额每 60 秒刷新一次。
- 无需额外设置密钥——直接复用部署环境中的 DEEPSEEK_API_KEY 凭据，通过 Harness 的凭据服务获取。
ds-api-usage DSH 插件适合哪些场景
- 监控每日 API 花费，确保预算可控。
- 分析 Token 使用趋势（小时/天），优化模型调用策略。
- 在不离开 DeepSeek Harness 的情况下快速检查余额。
- 追踪 API 请求次数，发现异常使用模式。
- 查看历史用量数据（最多 14 天），即使重启 Web 应用后数据仍保留。
ds-api-usage DSH 插件适合谁
- DeepSeek Harness 的使用者，希望在工具内部监控 API 用量。
- 需要管理 API 成本、追踪 Token 消耗的开发者和管理员。
ds-api-usage DSH 插件的限制
- 花费为估算值，基于 DeepSeek 公开定价表和高峰/低谷时段计算，实际账单可能不同。
- 需要主机系统上安装有 `curl` 命令，用于获取余额接口。
- 数据持久化在本地的插件存储文件中；删除文件会重置历史记录。
- 仅支持 DeepSeek API（不支持其他提供方），因为它依赖 DeepSeek 特有的 Token 用量报告和定价。
ds-api-usage DSH 插件的仓库 README 摘录
以下文字摘自 ds-api-usage DSH 插件的上游仓库 Sev7een/ds-api-usage 的 README，版权归原作者，仅作引用。
**English** | [简体中文](./README.zh-CN.md) | [Português (Brasil)](./README.pt-BR.md) After installation, open **Settings → API Usage** in [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness) to view your DeepSeek API usage. The page shows your account balance, estimated spend, token counts, and API request count over the last 24 hours (14 days in the daily view), rendered as a timeline bar chart similar to the official DeepSeek platform usage page. ## Features - 💰 **Balance card** — total balance with granted / topped-up split, labeled with the API-reported currency code (CNY or USD), plus an availability badge, fetched from the official [`GET /user/balance`](https://api-docs.deepseek.com/api/get-user-balance/) endpoint. - 📊 **Metric cards** — 24h estimated spend (CNY), token counts (input / output split), and API request count. - 📈 **Timeline chart** — hourly bars over the last 24 hours, or daily bars over 14 days, toggled between cost, tokens, and request counts (hover for exact values). - 🔄 **Live refresh** — balance refreshes every 60 s on the host; the page polls every 30 s and has a manual refresh button. - 🔑 **No extra key setup** — reuses the deployment'
阅读完整 README仓库许可: MIT
ds-api-usage DSH 插件常见问题
如何安装 DS API 用量插件？
在 DeepSeek Harness 环境中运行命令 `dsh plugin --profile web add github:Sev7een/ds-api-usage`。这会从 GitHub 下载并安装插件。如果你使用的是其他配置文件，请将 `web` 替换为你的配置文件名。安装完成后，重启 Harness 或刷新设置页面即可看到新的“API 用量”部分。
安装后在哪里找到 API 用量页面？
打开 DeepSeek Harness 并进入设置。在设置侧边栏中会出现一个名为“API 用量”（或本地化标签）的新条目。点击它即可查看余额、估算花费、Token 计数和请求图表。该页面由插件自动添加。
显示的花费准确吗？我会按这个金额付费吗？
花费是基于 DeepSeek 公开定价表计算的估算值，并考虑了高峰/低谷时段逻辑。它使用模型在流式传输中报告的 Token 数量来计算价格。但实际账单可能因四舍五入或定价更新而有细微差异。该数字主要用于监控趋势，而非最终账单。
如何重置 14 天视图中的历史用量数据？
删除存储文件 `$DSH_HOME/storages/ds-api-usage.json`。插件会重新开始累积数据。注意，删除此文件不会影响 Harness 自己独立的每会话 Token 投影数据。删除后，重启 Harness 或刷新设置页面即可看到重置后的数据。
这个插件是否支持其他 API 提供商，比如 OpenAI？
不支持。该插件专为 DeepSeek API 设计，依赖于 DeepSeek 的 Token 用量格式（StreamChunk 中的 TokenUsage）和 DeepSeek 的定价表，并且从 DeepSeek 的 `/user/balance` 接口获取余额。除非修改代码，否则无法与其他提供商一起使用。