mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-09 20:42:28 +08:00
bbed2a1fe1
Reorganize docs/user-manual/ from flat structure to language subdirectories (zh/, en/, ja/) with shared assets/. Move existing Chinese docs into zh/, fix image paths, add multilingual navigation README, and translate all 23 markdown files (~4500 lines each) to English and Japanese.
7.7 KiB
7.7 KiB
4.4 用量统计
功能说明
用量统计功能记录和分析 API 请求数据，帮助你：
- 了解 API 使用情况
- 估算费用支出
- 分析使用模式
- 排查问题
前提条件
使用用量统计功能需要：
- ✅ 启动代理服务
- ✅ 开启应用接管
- ✅ 开启日志记录
打开用量统计
设置 → 用量 Tab
统计概览
汇总卡片
页面顶部显示关键指标：
| 指标 | 说明 |
|---|---|
| 总请求数 | 统计周期内的请求总数 |
| 总 Token | 输入 + 输出 Token 总数 |
| 估算费用 | 基于定价配置计算的费用 |
| 成功率 | 成功请求的百分比 |
时间范围
可选择统计的时间范围：
| 选项 | 范围 |
|---|---|
| 今日 | 当天 00:00 至今 |
| 最近 7 天 | 过去 7 天 |
| 最近 30 天 | 过去 30 天 |
趋势图表
请求趋势
折线图展示请求数量的变化趋势：
- X 轴：时间
- Y 轴：请求数量
- 可按小时/天查看
- 支持缩放和拖拽
Token 趋势
展示 Token 使用量的变化：
- 输入 Token（蓝色）- 用户发送的 prompt 内容
- 输出 Token（绿色）- AI 生成的回复内容
- 缓存创建 Token（橙色）- 首次创建缓存消耗的 Token
- 缓存命中 Token（紫色）- 复用缓存节省的 Token
- 成本（红色虚线，右侧 Y 轴）- 估算费用
💡 缓存 Token 说明：Anthropic API 支持 Prompt Caching 功能。缓存创建时收取较高费用（通常为输入价格的 1.25 倍），但后续命中缓存时只收取 0.1 倍的价格，可大幅降低重复请求的成本。
时间粒度
- 今日：按小时显示（24 个数据点）
- 7 天/30 天：按天显示
详细数据
页面下方有三个数据 Tab：
请求日志
每条请求的详细记录：
| 字段 | 说明 |
|---|---|
| 时间 | 请求时间 |
| 供应商 | 使用的供应商名称 |
| 模型 | 请求的模型（计费模型） |
| 输入 Token | 输入的 Token 数 |
| 输出 Token | 输出的 Token 数 |
| 缓存读取 | 缓存命中的 Token 数 |
| 缓存创建 | 缓存创建的 Token 数 |
| 总费用 | 估算费用（美元） |
| 耗时信息 | 请求耗时、首 Token 时间、流式/非流式 |
| 状态 | HTTP 状态码 |
耗时信息说明
耗时信息列显示多个徽章：
| 徽章 | 说明 | 颜色规则 |
|---|---|---|
| 总耗时 | 请求总时长（秒） | ≤5s 绿色，≤120s 橙色，>120s 红色 |
| 首 Token | 流式请求首个 Token 时间 | ≤5s 绿色，≤120s 橙色，>120s 红色 |
| 流式/非流式 | 请求类型 | 流式蓝色，非流式紫色 |
查看详情
点击请求行可查看详细信息：
- 完整的请求参数
- 响应内容摘要
- 错误信息（如果失败）
筛选日志
支持按以下条件筛选：
| 筛选项 | 选项 |
|---|---|
| 应用类型 | 全部 / Claude / Codex / Gemini |
| 状态码 | 全部 / 200 / 400 / 401 / 429 / 500 |
| 供应商 | 文本搜索 |
| 模型 | 文本搜索 |
| 时间范围 | 开始时间 - 结束时间（日期时间选择器） |
操作按钮：
- 搜索：应用筛选条件
- 重置：恢复默认（过去 24 小时）
- 刷新：重新加载数据
供应商统计
按供应商分组的统计数据：
| 字段 | 说明 |
|---|---|
| 供应商 | 供应商名称 |
| 请求数 | 该供应商的请求总数 |
| 成功数 | 成功的请求数 |
| 失败数 | 失败的请求数 |
| 成功率 | 成功百分比 |
| 总 Token | Token 使用总量 |
| 估算费用 | 该供应商的费用 |
模型统计
按模型分组的统计数据：
| 字段 | 说明 |
|---|---|
| 模型 | 模型名称 |
| 请求数 | 该模型的请求总数 |
| 输入 Token | 输入 Token 总量 |
| 输出 Token | 输出 Token 总量 |
| 平均延迟 | 平均响应时间 |
| 估算费用 | 该模型的费用 |
定价配置
打开定价配置
设置 → 高级 → 定价配置
配置模型价格
为每个模型设置价格（每百万 Token）：
| 字段 | 说明 |
|---|---|
| 模型 ID | 模型标识符（如 claude-3-sonnet） |
| 显示名称 | 自定义显示名称 |
| 输入价格 | 每百万输入 Token 的价格 |
| 输出价格 | 每百万输出 Token 的价格 |
| 缓存读取价格 | 每百万缓存命中 Token 的价格 |
| 缓存创建价格 | 每百万缓存创建 Token 的价格 |
操作
- 添加：点击「添加」按钮新增模型定价
- 编辑：点击行末的编辑图标修改
- 删除：点击行末的删除图标移除
预设价格
CC Switch 预设了常用模型的官方价格（每百万 Token）：
Claude 系列（美元）：
| 模型 | 输入 | 输出 | 缓存读取 | 缓存创建 |
|---|---|---|---|---|
| Claude 4.5 系列 | ||||
| claude-opus-4-5 | $5 | $25 | $0.50 | $6.25 |
| claude-sonnet-4-5 | $3 | $15 | $0.30 | $3.75 |
| claude-haiku-4-5 | $1 | $5 | $0.10 | $1.25 |
| Claude 4 系列 | ||||
| claude-opus-4 | $15 | $75 | $1.50 | $18.75 |
| claude-opus-4-1 | $15 | $75 | $1.50 | $18.75 |
| claude-sonnet-4 | $3 | $15 | $0.30 | $3.75 |
| Claude 3.5 系列 | ||||
| claude-3-5-sonnet | $3 | $15 | $0.30 | $3.75 |
| claude-3-5-haiku | $0.80 | $4 | $0.08 | $1.00 |
OpenAI 系列 / Codex（美元）：
| 模型 | 输入 | 输出 | 缓存读取 |
|---|---|---|---|
| GPT-5.2 系列 | |||
| gpt-5.2 | $1.75 | $14 | $0.175 |
| GPT-5.1 系列 | |||
| gpt-5.1 | $1.25 | $10 | $0.125 |
| GPT-5 系列 | |||
| gpt-5 | $1.25 | $10 | $0.125 |
注：Codex 预设包含了 low/medium/high 等变体，价格与基础模型一致。
Gemini 系列（美元）：
| 模型 | 输入 | 输出 | 缓存读取 |
|---|---|---|---|
| Gemini 3 系列 | |||
| gemini-3-pro-preview | $2 | $12 | $0.20 |
| gemini-3-flash-preview | $0.50 | $3 | $0.05 |
| Gemini 2.5 系列 | |||
| gemini-2.5-pro | $1.25 | $10 | $0.125 |
| gemini-2.5-flash | $0.30 | $2.50 | $0.03 |
中国厂商模型（人民币）：
| 模型 | 输入 | 输出 | 缓存读取 |
|---|---|---|---|
| DeepSeek | |||
| deepseek-v3.2 | ¥2.00 | ¥3.00 | ¥0.40 |
| deepseek-v3.1 | ¥4.00 | ¥12.00 | ¥0.80 |
| deepseek-v3 | ¥2.00 | ¥8.00 | ¥0.40 |
| Kimi (月之暗面) | |||
| kimi-k2-thinking | ¥4.00 | ¥16.00 | ¥1.00 |
| kimi-k2 | ¥4.00 | ¥16.00 | ¥1.00 |
| kimi-k2-turbo | ¥8.00 | ¥58.00 | ¥1.00 |
| MiniMax | |||
| minimax-m2.1 | ¥2.10 | ¥8.40 | ¥0.21 |
| minimax-m2.1-lightning | ¥2.10 | ¥16.80 | ¥0.21 |
| 其他 | |||
| glm-4.7 | ¥2.00 | ¥8.00 | ¥0.40 |
| doubao-seed-code | ¥1.20 | ¥8.00 | ¥0.24 |
| mimo-v2-flash | 免费 | 免费 | - |
自定义价格
如果使用中转服务，价格可能不同：
- 点击「编辑」按钮
- 修改价格
- 保存
常见问题
统计数据为空
检查：
- 代理服务是否运行
- 应用接管是否开启
- 日志记录是否开启
- 是否有请求通过代理
费用估算不准确
可能原因：
- 定价配置与实际不符
- 使用了中转服务的特殊定价
解决方法：
- 更新定价配置
- 参考供应商的实际账单
Token 数量与供应商不一致
CC Switch 使用自己的方式估算 Token 数，可能与供应商的计算方式略有差异。以供应商账单为准。