前言¶
在 DSH 开发与使用场景中，监控 cc-switch 的 provider 余额以及 DSH 会话的 token 用量与花费是刚需。ccs-balance 插件为此提供了统一的视图，将分散的信息整合到 DSH 面板中。
功能概览¶
该插件主要提供三个维度的数据监控：
- 余额页：拉取 cc-switch 中每个 provider 的余额。支持的 provider 类型包括 newapi / general / DeepSeek / OpenAI / Moonshot / SiliconFlow。支持每个 provider 独立币种（￥/$）设置，并支持全局 USD→CNY 汇率换算。
- 用量页：按日 / 按月 / 总量统计输入、输出、缓存读、缓存写的 token 数量与花费。按日视图支持查看近 7 天 / 近 30 天 / 全部数据。界面提供堆叠柱状图展示模型构成。
- 会话页：按会话统计 token 用量与花费。支持搜索和排序功能。加载全部会话后，可直接在列表中滚动查看，无需展开单条详情。
- 面板尺寸：余额 / 用量 / 会话三个页面高度均固定为 500px，内容超出时在面板内滚动。
安装与启用¶
通过官方命令安装插件：
dsh plugin add ccs-balance
若需手动配置，需在 dsh.profile.bundles 中加入 "ccs-balance"，并在依赖中指定版本 ^1.0.0。
安装并启用后，侧边栏底部会出现「CCS 余额」入口。
使用说明¶
余额设置¶
- 余额页底部有使用说明，点击 ⚙ 图标可展开。
- 花费默认显示为元（￥）。如果你的中转站是真实美元计费，将余额页的「USD→CNY 汇率」改为相应值（例如 7.2）；如果中转站按元计费，保持该值为 1。
- 每个 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
