前言¶

DeepSeek Harness（DSH）把宿主能力拆成插件，社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不是官方应用商店。

使用 DeepSeek API 时，余额和用量通常要去官方平台查看。Sev7een/ds-api-usage 是 DeepSeek Harness 插件，在 DSH 的设置页展示 DeepSeek API 余额、估算消费、token 数和 API 请求数。它复用现有 DEEPSEEK_API_KEY，不需要额外配置一套密钥。

这是什么¶

• 插件名：Sev7een/ds-api-usage
• 包名：dsh-plugin-ds-api-usage
• 维护者：Sev7een
• 许可证：MIT
• 运行要求：Node >=20

这个插件的定位很直接：在 DeepSeek Harness 的 Settings → API Usage 页面查看 DeepSeek API 余额与用量时间线。

它既可以按会话作为动态插件加载，也可以作为持久 composition 插件写入 profile 的 cordis.patch.yml。

核心能力¶

1、余额卡片¶

展示：

• 总余额
• 赠送 / 充值拆分
• API 报告币种代码：CNY 或 USD
• 可用性徽章

数据来源为官方 GET /user/balance 接口。

2、指标卡片¶

展示 24 小时内的：

• 估算消费：CNY
• 输入 / 输出 token 数
• API 请求数

3、时间线图表¶

支持两种粒度：

• 最近 24 小时小时级条形图
• 14 天天级条形图

并可在以下指标之间切换：

• 成本
• token 数
• 请求数

4、实时刷新¶

• 主机每 60 秒刷新余额
• 页面每 30 秒轮询
• 页面提供手动刷新按钮

5、凭证复用¶

插件不需要额外密钥配置，复用部署中现有 DEEPSEEK_API_KEY，通过 harness credentials 服务解析。

6、客户端本地化¶

通过 harness locale 服务跟随活动语言，提供：

• zh
• en
• pt-BR

词条缺失时回退到 zh。

7、持久化聚合¶

插件会把聚合数据写入：

$DSH_HOME/storages/ds-api-usage.json

保留策略：

• 小时桶保留 48 小时
• 天桶保留 14 天

删除该文件可重置插件的持久化数据。

8、设置页注册¶

插件在宿主 settings.section 插槽注入本地化设置页，并暴露：

/ds-api-usage/snapshot

该端点提供 JSON 数据，供客户端展示使用。

安装与启用¶

先确认环境满足以下条件：

• DeepSeek Harness 已配置 DeepSeek LLM adapter
• DEEPSEEK_API_KEY 可通过 harness credentials 服务解析
• 主机可用 curl 调用 balance 接口

之所以需要 curl，是因为 web.fetch 无法发送 Authorization header。

从 GitHub 安装：

dsh plugin --profile web add github:Sev7een/ds-api-usage

安装后，在 DeepSeek Harness 打开：

Settings → API Usage

即可查看余额、估算消费、token 数和 API 请求数。

资料中另有一条 npm 形式命令：

dsh plugin --profile web add dsh-plugin-ds-api-usage

README 说明该命令对应 once published to npm。在未确认 npm 包已发布前，优先使用上面的 GitHub 安装命令。

动态插件方式¶

原始形态是按会话创建的动态 Cordis 插件，使用：

• cordis_define
• cordis_run

对应文件：

• code.host：src/index.js
• code.client：client/index.js

动态形态使用 harness.handle / host.call 通道。

持久 composition 插件方式¶

在 profile 的 cordis.patch.yml 中添加：

- insert:
    - id: ds-api-usage
      name: 'dsh-plugin-ds-api-usage'

这样插件会进入 host composition，由宿主加载。

典型用法¶

查看余额与用量¶

安装后打开：

Settings → API Usage

可以看到：

• DeepSeek API 余额
• 24 小时估算消费
• 输入 / 输出 token 数
• API 请求数
• 24 小时小时级或 14 天天级时间线

本地开发检查¶

做语法检查：

npm run check

运行离线测试：

npm test

更新价格表¶

本地重新解析 DeepSeek 官方价格页面并生成 PRICING 表：

npm run update:pricing

价格表位于：

__PRICING_BEGIN__
__PRICING_END__

标记之间。生成块只应通过脚本更新。

重置持久化数据¶

删除：

$DSH_HOME/storages/ds-api-usage.json

即可重置插件保存的聚合数据。

适用场景与注意¶

适合以下情况：

• 在 DSH 中调用 DeepSeek API，希望直接在设置页查看余额与用量
• 需要 24 小时小时级或 14 天天级时间线
• 想复用现有 DEEPSEEK_API_KEY，不额外配置密钥

使用前注意：

• 成本是估算值，基于 DeepSeek 公开牌价按模型和 UTC 时段计算
• token 数来自模型调用的 usage 数据
• 插件以当前 dsh 进程权限运行；安装前应检查源码、许可证和依赖是否适合你的部署
• 动态形态使用 harness.handle / host.call 通道
• 静态 bundle 使用 HTTP 路由 /ds-api-usage/snapshot
• 修改协议时，需要保持两端同步
• 仓库 CI 需要 GitHub Actions 启用，但无需 secrets 或 API keys

相关链接¶

• GitHub：https://github.com/Sev7een/ds-api-usage
• 社区目录页：https://www.skillhub.cn/plugins/Sev7een/ds-api-usage