Sync cc-switch provider balances and track token usage & cost by day/month/total with relay-aware currency settings.
Install
# from npm (prebuilt)
dsh plugin --profile web add ccs-balance
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:kikomaotu/ccs-balance
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
This plugin publishes its README in Chinese only.
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。
使用说明
- 安装并启用插件后，侧边栏底部会出现「CCS 余额」入口。
- 余额页底部有使用说明（点 ⚙ 展开）。
- 花费默认显示为元（￥）。如果你的中转站是真实美元计费，把余额页的 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 流水记录，或模型未命中定价表。
- 汇率改了没反应？切到其他标签页会自动重新计算。
Links
More in this category
bowenliang123/dsh-context★ 1969
DSH context insight panel: Context dashboard + /context command + Context browser — one-stop context lifecycle management with categorized composition, content details, evolution trends, compaction/injection events, and stats.
Han-1413141/dsh-cost-meter★ 388
Per-session and daily API cost, budget with usage %, official balance, history dashboard, and one-click official price sync with peak/off-peak pricing.
wssfk12138/dsh-damage-pulse★ 257
Tracks DeepSeek token usage, per-call and session costs, and account balance with cache-aware charge animations in the DSH Web UI.
zh667/TokenLedger★ 202
Sidebar usage panel that attributes tokens to the relay site that served each request, read from your existing provider config: today/month/all-time totals, per-site and per-model breakdowns, a year activity heatmap, and New API / Sub2API / DeepSeek balances.
Ychris12138/dsh-usage-stats★ 171
Multi-provider usage dashboard with provider/model token breakdowns, calendar drill-downs, account balances, and OpenCode Go / Z.ai subscription quota tracking.
PolinniZhong/dsh-personal-center★ 118
Personal center for DeepSeek Harness: cross-session usage statistics, per-model cost estimation, global custom instructions, a global font-size adjuster, a data-driven desktop pet with bitmap & vector skins, and a conversation status overview, all local and offline.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.