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 和评分是快照中的导航信号。

安装与排错 · 项目问题反馈

同类项目