前言¶

在 DSH 網頁版裏跑模型任務時，經常會需要確認兩件事：DeepSeek 賬戶還剩多少餘額，當前會話大概花了多少錢。如果每次都要打開後臺、翻日誌或手動查賬單，會打斷正常開發流程。

dsh-deepseek-billing 是一個 DSH WebUI 插件，把 DeepSeek 賬戶餘額和當前會話費用估算放在左側邊欄，方便在對話過程中直接查看。它是社區插件，倉庫地址爲 https://github.com/Jolly-J/dsh-deepseek-billing，許可證爲 MIT。

這是什麼¶

dsh-deepseek-billing 的定位是：DSH WebUI 插件，用於在側邊欄顯示 DeepSeek 賬戶餘額，並按當前會話估算費用。

當前倉庫 package.json 版本爲 0.1.0-rc.8。依賴要求如下：

• Node：^22.19.0 或 >=24.0.0
• React peer dependency：^18.2.0

用戶安裝直接使用倉庫內提交的 lib/ 產物，無需本地構建。

核心功能¶

餘額顯示¶

插件會在 DSH 網頁版左側邊欄底部常駐顯示 DeepSeek 賬戶餘額。

餘額數據直接調用 DeepSeek 官方餘額接口，並使用當前模型正在用的同一把 API Key，不需要另外配置一套餘額查詢密鑰。

刷新方式：

• 每 60 秒自動刷新一次
• 也可以手動點擊刷新按鈕

會話費用估算¶

插件會顯示當前會話的費用估算值。

費用統計方式是：按每條成功的助手回覆逐條計價，然後累加爲會話總額。它不是把所有 token 合成一個總數後再統一乘以某個費率。

展開卡片後，可以看到：

• 充值餘額
• 贈送餘額
• token 明細
• 緩存命中率
• 輸入費用小計
• 輸出費用小計
• 當前費率說明

界面行爲包括：

• 數字變化時有滾動動畫
• 切換會話時自動更新
• 側邊欄收起時自動隱藏

需要特別說明：卡片上的會話費用是估算值，不是賬單。餘額是唯一真值，卡片費用僅作歸因參考。

安裝與啓用¶

方式一：通過 DSH 插件市場安裝¶

在 DSH 網頁版插件市場 dsh-market 中搜索 dsh-deepseek-billing，點安裝。

裝完後重啓：

dsh web

方式二：通過命令安裝¶

執行：

dsh plugin --profile web add https://github.com/Jolly-J/dsh-deepseek-billing.git

裝完後重啓：

dsh web

方式三：通過 DSH 智能體安裝¶

把倉庫地址發給 DSH 智能體，讓其執行上面的 dsh plugin --profile web add ... 安裝命令，並提示你重啓 dsh web。

更新插件¶

執行：

dsh plugin --profile web update dsh-deepseek-billing

更新後重啓：

dsh web

典型用法¶

安裝完成並重啓 dsh web 後，可以按下面方式使用：

1、打開 DSH 網頁版，在左側邊欄底部查看 DeepSeek 賬戶餘額和當前會話費用估算。

2、點擊卡片展開詳情，查看充值/贈送餘額、token 明細、緩存命中率、輸入/輸出費用小計和當前費率說明。

3、切換會話時，卡片會跟隨當前會話自動更新費用估算。

4、需要立即查看最新余額時，手動點擊刷新按鈕。

如果要做開發驗證，可以把 deepseek-harness 和 dsh-deepseek-billing 克隆到 DSH monorepo 的擴展目錄：

packages/extensions/dsh-deepseek-billing

然後執行：

pnpm install
pnpm run build:lib:host
pnpm --filter dsh-deepseek-billing verify

適用場景與注意¶

這個插件適合以下場景：

• 長期使用 DSH 網頁版
• 需要頻繁查看 DeepSeek 賬戶餘額
• 希望在當前會話中粗略瞭解費用變化
• 希望減少打開後臺或查詢賬單的操作

使用前請注意：

• 插件會以當前 dsh 進程權限運行，安裝前應檢查源碼和許可證。
• 會話費用是估算值，不是賬單。
• 餘額是唯一真值，卡片費用僅作歸因參考。
• 卡片不計入失敗重試。
• 卡片不計入後臺模型調用，例如會話標題生成、聯網搜索查詢等。
• 卡片不計入 reasoning token。
• 卡片不計入子代理會話用量。
• 費用只統計當前會話，子代理會話暫未彙總。
• 不保存按模型 × 時段的分組明細。
• 界面只顯示會話總額與輸入/輸出小計。
• reasoning token 目前只統計、不計價。
• 價格表內置在代碼裏，官方調價後需要更新插件版本。
• 官方沒有價格查詢接口。
• 文案目前是中文。

密鑰安全¶

插件不存儲、不偷、不外傳 API Key。

它只臨時使用 DEEPSEEK_API_KEY 調用 DeepSeek 官方餘額接口，用完即棄。

密鑰的處理範圍如下：

• 只在本機插件進程內存裏存在一瞬間
• 只放進發往 DeepSeek 官方的請求頭 Authorization
• 不進命令行參數
• 不進環境變量
• 不進日誌
• 不進入網頁接口返回
• 不落盤

已知通用風險包括：

• 同機器、同權限的進程理論上能讀取宿主進程內存
• 局域網內能訪問 DSH 網頁端口的人可以看到餘額數字，但看不到密鑰

如果對此介意，建議在部署層給 /billing/status 加訪問限制。

結尾¶

dsh-deepseek-billing 的價值很具體：在 DSH 網頁版側邊欄常駐顯示 DeepSeek 賬戶餘額，並給出當前會話費用估算。它不替代賬單，只幫助在任務執行過程中快速覈對餘額和費用歸因。

倉庫地址：

https://github.com/Jolly-J/dsh-deepseek-billing