使用文档
计算器页
按导入用量或手动填写的 Token，用模型报价估算费用。
计算器页在左侧「计算器」（/calculator）。它把 Token 用量按模型和计费类型套入报价，给出一个便于比较的预计费用。自动模式读取当前浏览器已导入的数据；手动模式不会读取或上传任何用量数据。
结果用于预算、模型选型和用量复盘，不等同于供应商最终账单：实际收费还可能受套餐、区域、请求类型、缓存规则、最低消费和税费影响。
两种计费数据来源
页面右上角可切换。该开关只决定 Token 用量来源（以及是否显示手动 Token 输入框），不限制你能否选供应商或改单价：
| 模式 | 适合场景 | 用量来源 |
|---|---|---|
| 自动汇总 | 复盘已发生的使用成本 | 当前数据来源、汇总开关和统计周期；与图表、表格页同步 |
| 手动填写 | 预算一次调用、项目或任意 Token 规模 | 你填写的输入、缓存命中和输出 Token |
桌面端默认进入自动汇总，移动端默认手动填写；地址中的 mode=auto 或 mode=manual 会固定对应模式。
自动汇总时，先在图表页导入本地目录或快照。切换统计周期、数据来源或汇总模式后，计算器会立即使用同一范围重新估算。表格页点某日的「估算花费」会跳到 /calculator?date=YYYY-MM-DD&mode=auto，此时只计算该自然日，不受当前统计周期大小影响。
自动按模型计价
自动模式会将每个识别到的模型单独匹配价格预设，再把各模型费用相加。这样同一周期里同时用了多个模型时，不会误按一个模型的单价计算。页面顶部的预计总费用以该按模型合计为准。
每个模型行会展示输入、缓存和输出 Token、匹配到的报价与该模型预计费用：
- 自动匹配成功的模型会直接计入总价；也可在该行下拉中改选其他价格预设。
- 每个模型卡片的「选择价格预设」支持搜索，可按模型名称、套餐类型或供应商名称筛选；清空搜索词即可恢复全部报价。
- 显示「未匹配价格」时，必须在该行选择一个价格预设后才会计入总价。
- 改选结果会保存到当前浏览器，之后同名模型会继续使用该映射。
- 未匹配模型的 Token 不会计入预计总费用。页面会显示未匹配数量，请处理完再比较总价。
- 当前范围没有可识别的按模型用量时，无法形成自动模型报价；可改用手动填写，或使用下方的统一单价试算做整体估算。
面板顶部有紧凑的币种与汇率控件，用于按模型计价的展示币种；与下方「调整计价参数」共用同一套币种/汇率状态。
Cursor 出现大量「未知模型」时，可先在图表页设置「Cursor 全局模型映射」，再回到计算器匹配价格。
统一单价试算
自动模式下，按模型计价下方仍可使用「选择模型预设」「调整计价参数」和「费用拆解」。这是一套统一单价试算：用当前范围的汇总 Token × 所选单个预设（或自定义单价），便于对照「如果全部按某一模型计价会怎样」。
- 试算合计会在蓝色说明条中显示，不会覆盖上方汇总卡里的按模型合计。
- 费用拆解对应试算结果，与按模型合计相互独立。
手动填写模式下，没有按模型明细，预计总费用就是这套统一单价估算；同样可以选供应商、改币种/汇率和任一单价。
手动估算
切到「手动填写」后，依次填写：
| 字段 | 含义 |
|---|---|
| 输入 Token | 未命中缓存、按普通输入单价计费的请求内容 |
| 缓存命中 | 从提示词缓存读取的内容 |
| 输出 Token | 模型生成的内容 |
然后在「选择模型预设」中先选供应商，再选模型；模型卡展示该预设原始币种下的每 1M Token 报价。供应商列表和当前供应商的模型列表各有独立搜索框，搜索不区分大小写；切换供应商会清空模型搜索。选定预设后，可在「调整计价参数」中修改币种、汇率或任一单价；手动改价后会标记为「自定义价格」。
供应商搜索按供应商名称或类型匹配，模型搜索按模型名称或套餐类型匹配。搜索只过滤当前显示列表，不会改变已经选中的预设；清空搜索词即可恢复完整列表。
费用拆解会把缓存命中、输入、缓存写入和输出分别列出，以便看出哪一类 Token 占成本最多。
费用如何计算
单价均以「当前币种 / 1M tokens」表示。每一项的计算方式是：
费用 = Token 数 ÷ 1,000,000 × 对应单价
总费用为各项费用之和。缓存写入 Token 在已导入的数据中通常没有独立字段，因此自动按模型计价会按输入 Token 数，并使用缓存写入单价估算这部分成本；这是一项近似值。统一单价试算与手动模式同样以（汇总或填写的）输入 Token 作为缓存写入数量用于拆解。
报价、币种与刷新
计算器优先从价格服务读取在线价格目录，并缓存最近一次成功结果，以减少重复请求。费用卡的「计费数据来源」会显示当前状态：
- 在线价格目录：正在使用价格服务返回的报价。
- 缓存价格目录：本次使用浏览器中上次成功同步的报价。
- 默认价格：在线报价不可用时使用内置兜底报价。
点击「刷新价格」可重新请求价格目录。报价会随供应商调整；做严格对账时，建议记录估算时的模型、币种、汇率和报价更新时间。
可在页面中选择 CNY 或 USD。切换币种会按当前填写的 1 USD = X CNY 汇率换算预设价格，费用卡同时显示另一种币种的近似金额。该汇率是估算参数，不是实时汇率。向下滚动后，精简版总价条会固定在顶栏下方，便于对照下方报价面板。
常见问题
自动模式总价为 0
先确认图表页已导入数据且当前周期包含记录；再查看是否所有模型都显示「未匹配价格」。未匹配项目不会进入总价。
自动模式与统一单价试算（或手动模式）的数字不同
按模型合计为每个模型分别套用报价后相加；统一单价试算与手动模式按选定的一个模型或自定义单价计算汇总 Token。两者目的不同。比较时请确认 Token 范围、模型和币种相同。
为什么和供应商账单不一致
本页只根据本地可读的 Token 与报价估算。完整模型 prompt、缓存写入量、供应商计费精度、套餐折扣和税费都可能造成差异，最终以供应商账单为准。
我修改的模型映射或价格还在吗
模型映射和价格目录缓存保存在当前浏览器。清除站点数据、换浏览器、无痕窗口或换设备后需要重新设置；不会写回本地用量文件。