DeepSHPlugins
ccs-balance 專案預覽
GITHUB / COMMUNITY PROJECT

ccs-balance

安全與運維JavaScriptMIT

同步 cc-switch 各 provider 餘額,按日/月/總量統計 token 用量與花費,支援中轉站幣種與匯率設定。

2 Starskikomaotu 更新時間 2026-08-26
訪問 GitHub 倉庫
ccs-balance 專案預覽

專案介紹

中文

同步 cc-switch 各 provider 餘額,按日/月/總量統計 token 用量與花費,支援中轉站幣種與匯率設定。

English

Sync cc-switch provider balances and track token usage & cost by day/month/total with relay-aware currency settings.

專案資訊與收錄訊號

快照 2026-09-11
作者 / 組織
kikomaotu
倉庫
kikomaotu/ccs-balance
GitHub Stars
2
Forks
0
開發語言
JavaScript
許可證
MIT
最近推送
2026-08-26
Manifest
資料中檢測到宣告

公開倉庫不自動等於可商用;許可證與當前相容性以原專案文件為準。Manifest 和資料評分不構成安裝安全認證。

資料評分

57/ 100
維護活躍
90
文件與實用資訊
100
生態關注度
14
安裝便捷訊號
80
專案宣告訊號
100

近 16 天仍在更新;README 含完整安裝與使用說明;關注度尚低(2)。

評分來自已有資料快照的五維模型,僅作瀏覽參考,不是實際使用評測或安全檢測結論。

安裝與使用

所有專案資料與許可均以對應 GitHub 倉庫為準。

dsh plugin --profile web add github:kikomaotu/ccs-balance

複製命令不會自動執行。請先閱讀倉庫文件,確認環境要求與許可證。

專案截圖

倉庫 README

GitHub 原文

已儲存的倉庫文件快照;文件抓取時間未記錄,可能與上方目錄介紹處於不同版本。安裝前請核對當前倉庫說明。

儲存庫檔案保留原文,指令與授權文字不作自動改寫。

ccs-balance

DSH 插件:同步 cc-switch 各 provider 的余额,并统计 DSH 会话的 token 用量与花费。

功能

  • 余额页:拉取 cc-switch 中每个 provider 的余额(支持 newapi / general / DeepSeek / OpenAI / Moonshot / SiliconFlow),支持每个 provider 独立币种(¥ / $)与全局 USD→CNY 汇率。
  • 用量页:按日 / 按月 / 总量统计输入、输出、缓存读、缓存写 token 与花费;按日视图支持近 7 天 / 近 30 天 / 全部;堆叠柱状图 + 模型构成。
  • 会话页:按会话统计 token 用量与花费,支持搜索、排序;加载全部会话并直接滚动查看,不再展开单条详情。
  • 面板尺寸:余额 / 用量 / 会话三个页面高度均固定为 500px,内容超出时在面板内滚动。

安装

dsh plugin add ccs-balance

或手动加到 profile 依赖:

{ "dependencies": { "ccs-balance": "^1.0.0" } }

并在 dsh.profile.bundles 里加入 "ccs-balance"。

数据来源

  • 余额:cc-switch 数据库中的 provider 配置,通过各中转站 API 查询。
  • 用量与花费:cc-switch 的 usage_daily_rollups 与 proxy_request_logs(中转站实际扣费),缺失时回退按 model_pricing 估算。
  • 会话列表:DSH session store。

使用说明

  1. 安装并启用插件后,侧边栏底部会出现「CCS 余额」入口。
  2. 余额页底部有使用说明(点 ⚙ 展开)。
  3. 花费默认显示为元(¥)。如果你的中转站是真实美元计费,把余额页的 USD→CNY 汇率改成相应值(如 7.2);USD 当元的中转站保持 1。

配置

  • 插件设置保存在插件目录 settings.json。
  • 每个 provider 的币种(¥/$)在余额页 provider 名旁下拉框设置。

开发

node --check lib/index.js
node --check lib/client.js
python -m py_compile lib/ccs_host_helper.py

License

MIT

FAQ

  • 余额显示为 0 或负数?说明该中转站余额查询失败或已透支,检查 provider 配置和 API key。
  • 花费显示为 0?可能该会话没有 cc-switch 流水记录,或模型未命中定价表。
  • 汇率改了没反应?切到其他标签页会自动重新计算。

使用前核對

安裝步驟、相容版本與授權範圍以原專案當前文件為準。Stars 和評分是快照中的導航訊號。

安裝與排錯 · 專案問題反饋

同類專案