前言¶

在 DSH 開發與使用場景中，監控 cc-switch 的 provider 餘額以及 DSH 會話的 token 用量與花費是剛需。ccs-balance 插件爲此提供了統一的視圖，將分散的信息整合到 DSH 面板中。

功能概覽¶

該插件主要提供三個維度的數據監控：

1. 餘額頁：拉取 cc-switch 中每個 provider 的餘額。支持的 provider 類型包括 newapi / general / DeepSeek / OpenAI / Moonshot / SiliconFlow。支持每個 provider 獨立幣種（￥/$）設置，並支持全局 USD→CNY 匯率換算。
2. 用量頁：按日 / 按月 / 總量統計輸入、輸出、緩存讀、緩存寫的 token 數量與花費。按日視圖支持查看近 7 天 / 近 30 天 / 全部數據。界面提供堆疊柱狀圖展示模型構成。
3. 會話頁：按會話統計 token 用量與花費。支持搜索和排序功能。加載全部會話後，可直接在列表中滾動查看，無需展開單條詳情。
4. 面板尺寸：餘額 / 用量 / 會話三個頁面高度均固定爲 500px，內容超出時在面板內滾動。

安裝與啓用¶

通過官方命令安裝插件：

dsh plugin add ccs-balance

若需手動配置，需在 dsh.profile.bundles 中加入 "ccs-balance"，並在依賴中指定版本 ^1.0.0。

安裝並啓用後，側邊欄底部會出現「CCS 餘額」入口。

使用說明¶

餘額設置¶

1. 餘額頁底部有使用說明，點擊 ⚙ 圖標可展開。
2. 花費默認顯示爲元（￥）。如果你的中轉站是真實美元計費，將餘額頁的「USD→CNY 匯率」改爲相應值（例如 7.2）；如果中轉站按元計費，保持該值爲 1。
3. 每個 provider 的幣種（￥/$）在餘額頁 provider 名旁的下拉框中設置。

數據查看¶

• 餘額：顯示爲 0 或負數，說明該中轉站餘額查詢失敗或已透支，請檢查 provider 配置和 API key。
• 花費：顯示爲 0，可能該會話沒有 cc-switch 流水記錄，或模型未命中定價表。
• 匯率更新：修改匯率後，切到其他標籤頁會自動重新計算。

數據來源¶

• 餘額：讀取 cc-switch 數據庫中的 provider 配置，通過各中轉站 API 查詢實時餘額。
• 用量與花費：讀取 cc-switch 的 usage_daily_rollups 和 proxy_request_logs（即中轉站實際扣費數據）。若上述數據缺失，系統會回退按 model_pricing 估算。
• 會話列表：直接讀取 DSH session store。

結語¶

ccs-balance 爲 DSH 用戶提供了從 provider 餘額到具體會話花費的全鏈路統計能力。其核心價值在於統一了數據來源，減少了在不同系統間切換查看的耗時。

插件目錄：https://www.skillhub.cn/plugins/kikomaotu/ccs-balance
源碼倉庫：https://github.com/kikomaotu/ccs-balance