前言¶

在 DeepSeek Harness（DSH）的 Web 聊天界面裏，請求已經產生 Token 用量，但花費金額和賬戶餘額不一定直接可見。對於在 DSH 上做智能體開發的同行，dsh-token-price 插件主要解決這件事：把每輪迴復的花費、會話總花費和賬戶餘額顯示在 Web UI 中。

DSH 的理念是「一切皆插件」。這裏的插件目錄頁是獨立站點，不是官方應用商店。

插件定位¶

dsh-token-price 是 DSH 客戶端插件，由 spoon-man569 維護，許可證爲 MIT。它爲 DeepSeek Harness Web 聊天界面提供準確的 Token 花費與賬戶餘額顯示。

核心功能¶

• 顯示每輪 assistant 回覆的 token 花費，以 ¥ 展示，並在統計行懸停時可見。
• 顯示會話總花費，包含已取消但產生 usage 的請求步驟。
• 顯示基於 USD/CNY 市場匯率的估算人民幣金額；USD 不在 UI 中渲染。
• 顯示官方 GET /user/balance 返回的賬戶餘額，優先使用返回的 CNY 餘額。
• 通過 dsh.bundle 和 dsh.client 同時激活宿主服務與瀏覽器展示。
• 未知 provider/model 路由顯示爲“未定價”，不顯示爲零成本。

安裝與啓用¶

安裝命令需要 pnpm。執行：

dsh plugin --profile web add dsh-token-price

上面的命令用於給 DSH Web profile 添加 dsh-token-price。插件會同時激活宿主服務與瀏覽器展示。

配置示例¶

token-price 插件可以配置以下項：

- id: token-price
  name: dsh-token-price
  config:
    balanceBaseURL: <餘額接口地址>
    balanceApiKeyEnv: <保存 DeepSeek API 密鑰的環境變量名>
    balanceRefreshIntervalMs: <餘額刷新間隔，毫秒>
    referenceRateRefreshIntervalMs: <參考匯率刷新間隔，毫秒>
    requestTimeoutMs: <請求超時，毫秒>

其中 balanceApiKeyEnv 指定保存 DeepSeek API 密鑰的環境變量，密鑰保留在宿主端。餘額刷新失敗時，保留最後一次餘額樣本。

估算口徑¶

這裏的 ¥ 金額是基於 USD/CNY 市場匯率的估算值，不是賬戶扣款，也不是官方 per-request 收費。未知 provider/model 路由會顯示爲“未定價”，不會作爲零成本金額展示。

開發與構建¶

開發時運行：

npm install
npm test

npm test 會構建 lib/、生成類型聲明並運行會計測試。重新構建後，需要重啓 DSH Web 進程以加載新產物。運行環境要求 Node >=18。

適用場景與注意¶

適合在 DSH Web 聊天界面查看 Token 花費和賬戶餘額的開發者或使用者。插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。

鏈接¶

• 插件目錄頁：https://www.skillhub.cn/plugins/spoon-man569/dsh-token-price
• GitHub：https://github.com/spoon-man569/dsh-token-price