前言¶

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