cc-switch-usage-auditlisted
Install: claude install-skill xingtu1996/xingtu-skills
# CC Switch 真实用量审计
把「本地代理日志」变成可对外引用的成本账。适用于:给内容做一手背书、评估换模型/迁档的真实收益、核对第三方面板数字是否可信。
## 数据源(只读)
- 库:`~/.cc-switch/cc-switch.db`(SQLite,随时间增长;另有 `backups/` 快照可对比)
- 关键表:
- `proxy_request_logs` — 逐条请求(含 input/output/cache_read/cache_creation tokens、各项成本、latency、first_token_ms、status_code、provider_type、model)
- `usage_daily_rollups` — 按天×模型聚合(字段最全,但可能滞后于明细表)
- `providers` — 供应商配置(**含密钥,只取 name/app_type/provider_type/cost_multiplier/is_current**)
- `provider_health` / `stream_check_logs` — 可用性、流检查
## ⚠️ 安全纪律
1. **绝不读 `providers.settings_config`**(内含 API key),查询时列名白名单。
2. **只读**:不加 `-w`、不做任何 UPDATE/DELETE。
3. 输出给人看之前,去掉可能含账号标识的字段。
## 步骤
1. **定位新鲜度**:`ls -la ~/.cc-switch/cc-switch.db`(判断数据截至何时)。
2. **取时段与条数**:
```sql
SELECT datetime(MIN(created_at),'unixepoch','localtime'),
datetime(MAX(created_at),'unixepoch','localtime'), COUNT(*)
FROM proxy_request_logs;
```
3. **按模型聚合**(核心一刀):
```sql
SELECT model, COUNT(*) reqs,
SUM(input_tokens) inp, SUM(output_tokens) outp, SUM(cache_read_tokens) cache_r,
ROUND(100.0*SUM(cache_read_tokens)/NULLIF(SUM(cache_read_tokens)+SUM(input_tokens),0),1) hit_pct,
ROUND(SUM(CAST(total_cost_usd AS REAL)),2) cost_usd,
ROUND(AVG(NULLIF(latency_ms,0))) lat_ms,
ROUND(AVG(NULLIF(first_token_ms,0))) ttft_ms
FROM proxy_request_logs GROUP BY model ORDER BY reqs DESC LIMIT 15;
```
4. **命中率口径**:`cache_read / (cache_read + input)`。这是成本账的开关——缓存价通常只有新输入价的 1/50。
5. **交叉验证**:与