@chenlongapps/opencode-token-usage 0.4.0 → 0.4.2

package/dist/usage.d.ts

@@ -24,6 +24,8 @@ export interface Price {
     };
     input?: number;
     output?: number;
+    /** Optional first-party rate when reasoning differs from ordinary output. */
+    reasoning?: number;
     cache?: {
         read?: number;
         write?: number;

package/dist/usage.js

@@ -14,8 +14,8 @@ export function estimate(tokens, prices = []) {
     const tier = prices.filter(p => p.tier && incoming(tokens) > p.tier.size)
         .sort((a, b) => b.tier.size - a.tier.size)[0];
     const price = tier ?? prices.find(p => !p.tier);
-    const rates = [price?.input, price?.output, price?.cache?.read, price?.cache?.write];
-    const quantities = [tokens.input, tokens.output + tokens.reasoning, tokens.cache.read, tokens.cache.write];
+    const rates = [price?.input, price?.output, price?.reasoning ?? price?.output, price?.cache?.read, price?.cache?.write];
+    const quantities = [tokens.input, tokens.output, tokens.reasoning, tokens.cache.read, tokens.cache.write];
     return {
         cost: quantities.reduce((sum, quantity, index) => sum + quantity * safe(rates[index]), 0) / 1_000_000,
         defaultPrice: total(tokens) > 0 && (!price || rates.some((rate, index) => quantities[index] > 0
@@ -200,7 +200,7 @@ export function usageRows(summary, context, performance) {
     rows.push(["Cache Rate", summary ? `${(summary.cacheRate * 100).toFixed(1)}%` : "—"], ["Total", number(summary?.total)]);
     const cost = summary && formatEstimatedCost(summary.cost, summary.costStatus);
     if (cost !== undefined)
-        rows.push(["Cost", cost]);
+        rows.push(["Est. Cost", cost]);
     if (performance?.tps !== undefined && Number.isFinite(performance.tps)) {
         rows.push(["TPS", `${performance.tpsEstimated ? "~" : ""}${Math.max(0, performance.tps).toFixed(1)} tok/s`]);
     }

package/docs/pricing.md

@@ -1,303 +1,36 @@
-# 内置官方价格快照
+# 内置原厂价格快照
 
-插件自 v0.3.0 起，在 OpenCode 当前模型目录没有可用于某条消息的完整价格时，使用本页所列的公开 API 价格补全。若 OpenCode 给出完整零价，而快照能完整计价，则使用快照价格。快照核验于 **2026-09-23**，共收录 86 个模型，金额均为美元 / 100 万 token。
+插件在 OpenCode 当前模型目录无法为一条消息提供完整价格时，使用仓库内已生成的价格快照。快照的版本、核对日期、逐模型费率和档位见 [`src/prices.generated.ts`](../src/prices.generated.ts)；来源是 [models.dev 的 API](https://models.dev/api.json)。少量经原厂核实的例外见 [`src/overrides.ts`](../src/overrides.ts)，例外的来源、原因及统一核验日期也保存在该文件。所有金额均为美元 / 100 万 token。
 
-## 规则
+## 更新方式
 
-- 每条 assistant 与 compaction 消息按自身记录的 `providerID`、模型 ID 和 token 用量分别计算。
-- OpenCode 当前解析出的完整适用非零价格优先。若完整适用价格为零，则尝试使用内置价格；只有快照能完整覆盖该消息实际使用的 token 类别时才覆盖零价，否则保留 OpenCode 的零价。OpenCode 价格不完整时，整条消息回退到内置价格，不混用两套费率。
-- 网关模型只通过精确厂商 ID、精确别名及已知包装格式匹配，例如 `openai/gpt-5.6-luna`、`us.anthropic.claude-opus-5` 和 `claude-opus-5@default`。匹配这些现有形式后，也会尝试仅移除模型 ID 的末尾 `-free` 或 `:free` 再精确匹配基础 ID，例如 `mimo-v2.6-flash-free`、`meta/muse-spark-1.3:free` 和 `muse-spark-1.3-contributor-free`；`-pro`、`-fast`、`-free-preview` 等其他后缀不会剥离。单独列出的 Fast 型号仅按完整 ID 和厂商支持的 provider 精确匹配，不会回退到标准费率。不按相似名称猜测。
-- 目录首版只新增 2026-03-22 至 2026-09-22 发布、具有明确 token 费率的模型。后续版本只限制新增窗口，已经收录的条目不会因超过半年而自动删除。
-- 采用同步 API 的公开价；Meta Contributor 条件价按单独标注的来源记录。仅收录下表明确列出的 Fast 型号，不含 Batch、Flex、其他 Fast/Priority、区域溢价、网关加价、企业折扣、工具费和税费，因此 Cost 仍是估算，不代表账单。
-- 任一有用量消息仍无法定价时，已知小计标记 `partial`；全部无法定价时显示 `—`。明确零价才显示 `$0.00`。
-- 促销价按核验日官网显示的费率收录（如 `gpt-5.6-sol`、MiniMax-M3 的"长期 5 折"标价），不用划线原价。
+GitHub Actions [价格更新工作流](../.github/workflows/update-prices.yml) 每天 UTC 03:17 从 models.dev 检查一次。生成文件与仓库版本相同就结束；有变化时先运行类型检查、测试、构建和打包检查，再创建或更新同一个仅包含 `src/prices.generated.ts` 的 PR，等待人工审阅与合并，不自动发布。也可从 Actions 页面手动触发。仓库须允许 GitHub Actions 创建 PR；使用内置 `GITHUB_TOKEN` 创建 PR 不会再次触发常规 CI，故上述检查在更新工作流内完成。
 
-## OpenAI
+本地手动更新可在联网的维护环境中运行：
 
-来源：[OpenAI API Pricing](https://developers.openai.com/api/docs/pricing)
+```sh
+npm run prices:update
+npm run typecheck
+npm test
+npm run build
+```
 
-| 模型 | 发布日期 | Input | Output | Cache Read | Cache Write | 长上下文档位 |
-| --- | --- | ---: | ---: | ---: | ---: | --- |
-| `gpt-5.5` | 2026-04-23 | 5 | 30 | 0.5 | — | >272K：10 / 45 / 1 / — |
-| `gpt-5.5-fast`（Fast） | 2026-04-23 | 12.5 | 75 | 1.25 | — | >272K：无官方 Fast 费率 |
-| `gpt-5.5-pro` | 2026-04-23 | 30 | 180 | — | — | >272K：60 / 270 / — / — |
-| `gpt-5.6-sol` | 2026-07-09 | 4 | 20 | 0.4 | 5 | >272K：8 / 30 / 0.8 / 10 |
-| `gpt-5.6-sol-fast`（Fast） | 2026-07-09 | 8 | 40 | 0.8 | 10 | >272K：16 / 60 / 1.6 / 20 |
-| `gpt-5.6-terra` | 2026-07-09 | 2 | 12 | 0.2 | 2.5 | >272K：4 / 18 / 0.4 / 5 |
-| `gpt-5.6-terra-fast`（Fast） | 2026-07-09 | 4 | 24 | 0.4 | 5 | >272K：8 / 36 / 0.8 / 10 |
-| `gpt-5.6-luna` | 2026-07-09 | 0.2 | 1.2 | 0.02 | 0.25 | >272K：0.4 / 1.8 / 0.04 / 0.5 |
-| `gpt-5.6-luna-fast`（Fast） | 2026-07-09 | 0.4 | 2.4 | 0.04 | 0.5 | >272K：0.8 / 3.6 / 0.08 / 1 |
-| `gpt-6-astra` | 2026-09-04 | 10 | 50 | 1 | 12.5 | >272K：20 / 75 / 2 / 25 |
-| `gpt-6-astra-fast`（Fast） | 2026-09-04 | 20 | 100 | 2 | 25 | >272K：40 / 150 / 4 / 50 |
-| `gpt-6-sol` | 2026-09-22 | 2 | 10 | 0.2 | 2.5 | >272K：4 / 15 / 0.4 / 5 |
-| `gpt-6-sol-fast`（Fast） | 2026-09-22 | 4 | 20 | 0.4 | 5 | >272K：8 / 30 / 0.8 / 10 |
-| `gpt-6-luna` | 2026-09-22 | 0.1 | 0.5 | 0.01 | 0.125 | >272K：0.2 / 0.75 / 0.02 / 0.25 |
-| `gpt-6-luna-fast`（Fast） | 2026-09-22 | 0.2 | 1 | 0.02 | 0.25 | >272K：0.4 / 1.5 / 0.04 / 0.5 |
-| `chat-latest`（别名 `gpt-chat-latest`） | 2026-05-05 | 5 | 30 | 0.5 | — | — |
+审阅生成文件与 `overrides.ts` 的差异后提交。更新脚本只请求 `https://models.dev/api.json`，从人工确认的**原厂 Provider + 自家模型系列**提取公开的文本模型价格；原厂平台上托管的其他厂商模型、OpenRouter 等网关报价、地域性/订阅制费率不作为回退价格来源。API 不标注模型的真实厂商，因此新增原厂或新系列需要维护者先审核并扩充 `ORIGINAL_PROVIDERS`，不能按相似名称自动猜测。
 
-`gpt-6-sol` 和 `gpt-6-luna` 的发布日期见 [OpenAI API 更新日志](https://developers.openai.com/api/docs/changelog)。表内 OpenAI 长上下文价格在传入 token 超过 272,000 时对整条请求生效。Fast 条目对应官方 Fast processing 费率；API 通过基础模型配合 `service_tier: "fast"` 选择该档，因此只有以对应 `-fast` ID 记录的 OpenAI 消息使用 Fast 价格，其他 provider 不匹配这些条目。官方未公布 `gpt-5.5` Fast 长上下文费率，故超过 272,000 个传入 token 时标记为不可估价，不沿用短上下文价。`gpt-5.6-sol` 的当前标准价是限期促销价；快照采用核验日官网显示的费率。`chat-latest` 是官方 ChatGPT SKU，OpenRouter 上的 `gpt-chat-latest` 作为精确别名指向同一条目。
+`src/prices.generated.ts` 是随 npm 包发布的离线快照：插件启动、刷新、构建、打包和测试均不请求 models.dev。`src/aliases.ts` 只记录无法按已知包装形式解决的厂商 slug 与精确模型 ID 差异；`src/overrides.ts` 只记录有原厂来源的缺失 SKU、已核实的例外费率及无法直接使用的 API 字段。普通价格变动通过重新生成快照维护，不往别名或例外表中增加常规型号。
 
-## Anthropic
+## 估算规则与边界
 
-来源：[Claude Platform Pricing](https://platform.claude.com/docs/en/about-claude/pricing)
+- 每条 assistant / compaction 消息使用自身记录的模型和五类 token 用量计价。OpenCode 当前解析出的完整非零价格优先；价格不完整时，整条消息回退到快照；完整零价只有在快照能覆盖该消息实际使用的类别时才被替换。两套价格不混用。
+- 上下文档位按该条消息的 `input + cache read + cache write` 选择，档位阈值为**严格大于**。输出与推理分开统计；原厂明确提供不同 `reasoning` 单价时分别计费，否则沿用输出单价。
+- 缺少实际用到的 token 类别费率就不能按该来源完整计价，不把缺价填作零。无法计价显示 `—`，部分可计价显示 `partial`，明确零价显示 `$0.00`。
+- 网关仅通过精确原厂 ID、唯一的完整裸 ID、明确别名及已知包装格式匹配。终尾 `-free` / `:free` 可在精确匹配失败后再去掉；不剥离 `-fast`、`-pro` 等其他后缀。Fast 模式只匹配支持它的原厂 Provider；不会把普通费率借给网关 Fast 变体。
+- 导入文本输入与文本输出的 token 费率；图片、音频、视频、存储时长、搜索和工具调用等独立计费项无法由五类 token 可靠还原。音频输出另有不同价格的型号不会导入；其余多模态请求仍可能超出此文本估算范围。
 
-| 模型 | 发布日期 | Input | Output | Cache Read | Cache Write |
-| --- | --- | ---: | ---: | ---: | ---: |
-| `claude-opus-4-7` | 2026-04-14 | 5 | 25 | 0.5 | 6.25 |
-| `claude-opus-4-8` | 2026-05-28 | 5 | 25 | 0.5 | 6.25 |
-| `claude-opus-4-8-fast`（Fast） | 2026-05-28 | 10 | 50 | 1 | 12.5 |
-| `claude-fable-5` | 2026-06-07 | 10 | 50 | 1 | 12.5 |
-| `claude-sonnet-5` | 2026-06-29 | 2 | 10 | 0.2 | 2.5 |
-| `claude-opus-5` | 2026-07-24 | 5 | 25 | 0.5 | 6.25 |
-| `claude-opus-5-fast`（Fast） | 2026-07-24 | 10 | 50 | 1 | 12.5 |
-| `claude-fable-5-1` | 2026-09-01 | 10 | 50 | 0.25 | 12.5 |
-| `claude-opus-5-5` | 2026-09-22 | 4 | 20 | 0.2 | 5 |
-| `claude-opus-5-5-fast`（Fast） | 2026-09-22 | 8 | 40 | 0.4 | 10 |
+## 人工核实的例外
 
-Cache Write 采用官方 5 分钟写入价。OpenCode 的聚合字段不区分 5 分钟与 1 小时 TTL，无法从历史消息可靠应用 1 小时写入价。OpenRouter 的 `claude-opus-4.7`、`claude-opus-4.8`、`claude-opus-5.5` 圆点写法注册为对应条目的精确别名。
+`overrides.ts` 保存较少量的可追溯例外，而不是另一份手动维护的完整价格目录。例如 DeepSeek 的历史消息没有计费时段，因此使用官网峰值价而不是 API 的低峰价；xAI 在 200K 起涨价，需要把目录中的阈值调整为符合 OpenCode 严格大于比较的 199,999；Z.ai 的缓存存储按时间收费，不把目录中的 `cache_write: 0` 解释为免费；阿里云隐式和显式缓存写入费率不同，不把聚合的 Cache Write 当作其中一种。
 
-`claude-opus-5-5` 的 Cache Read 是官方 0.05 倍基础输入价的特殊乘率（多数 Claude 模型为 0.1 倍），按官方标价 $0.20 / M 收录。
+另外，OpenAI Fast 的长上下文档、Step 5 Preview 的缓存写入、Kimi K3 的五分钟缓存写入、腾讯 Hy3 的按量价格，以及 models.dev 暂无原厂条目的少数型号（如 Aion）均按文件中标注的原厂页面和理由维护。Meta Contributor 是具有单独条件价格的原厂 SKU；仅精确匹配对应 Contributor 型号，不将普通 Muse Spark 一概按该价计算。
 
-表中 Claude Fast 条目仅适用于 Claude API 一方。Fast mode 的 Cache Read 和 5 分钟 Cache Write 分别按 Fast 输入价乘以官方缓存倍率计算；OpenCode 聚合的 Cache Write 无法区分 TTL，因此按 5 分钟写入价估算。Opus 5.5 的 Cache Read 为 Fast 输入价的 0.05 倍，其余表列 Fast 型号为 0.1 倍。
-
-## Google
-
-来源：[Gemini Developer API Pricing](https://ai.google.dev/gemini-api/docs/pricing)
-
-| 模型 | 发布日期 | Input | Output（含 thinking） | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `gemini-3.1-flash-lite` | 2026-05-07 | 0.25 | 1.5 | 0.025 |
-| `gemini-3.5-flash` | 2026-05-19 | 1.5 | 9 | 0.15 |
-| `gemini-3.5-flash-lite` | 2026-07-21 | 0.3 | 2.5 | 0.03 |
-| `gemini-3.6-flash` | 2026-07-21 | 0.75 | 3.75 | 0.075 |
-| `gemini-3.7-flash` | 2026-08-13 | 0.75 | 3.75 | 0.075 |
-| `gemini-3.8-flash` | 2026-09-02 | 0.75 | 3.75 | 0.075 |
-
-Gemini 3.6–3.8 Flash 的表中价格有效至 2026-12-31。上下文缓存还按存储时间收费；消息 token 统计无法表示该费用，因此目录不伪造 Cache Write 费率，遇到实际 cache write 且 OpenCode 也缺价时会标为不可用。
-
-## xAI
-
-来源：[Grok Models & Pricing](https://docs.x.ai/developers/models)
-
-| 模型 | 发布日期 | Input | Output | Cache Read | ≥200K Input / Output / Cache Read |
-| --- | --- | ---: | ---: | ---: | --- |
-| `grok-build-0.1` | 2026-04-16 | 1 | 2 | 0.2 | 2 / 4 / 0.4 |
-| `grok-4.3` | 2026-04-17 | 1.25 | 2.5 | 0.2 | 2.5 / 5 / 0.4 |
-| `grok-4.5` | 2026-07-08 | 2 | 6 | 0.3 | 4 / 12 / 0.6 |
-| `grok-4.6` | 2026-08-12 | 2 | 6 | 0.5 | 4 / 12 / 1 |
-| `grok-4.7` | 2026-09-21 | 2 | 6 | 0.5 | 4 / 12 / 1 |
-
-## Mistral 与 Cohere
-
-来源：[Mistral Pricing](https://docs.mistral.ai/inference/pricing)、[Cohere Pricing](https://cohere.com/pricing)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `mistral-medium-3-5-26-04` | 2026-04-29 | 1.5 | 7.5 | 0.15 |
-| `command-a-plus-05-2026` | 2026-05-20 | 2.5 | 10 | — |
-
-## Z.ai（GLM）
-
-来源：[Z.AI Pricing](https://docs.z.ai/guides/overview/pricing)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `glm-5.1` | 2026-04-06 | 1.4 | 4.4 | 0.26 |
-| `glm-5.2` | 2026-06-16 | 1.4 | 4.4 | 0.26 |
-| `glm-5.3` | 2026-08-16 | 1.4 | 4.4 | 0.26 |
-| `glm-5.3-flash` | 2026-08-26 | 0.15 | 0.5 | 0.03 |
-| `glm-5.3-flashx` | 2026-09-18 | 0.37 | 1.25 | 0.075 |
-
-官方按时间收取缓存存储费（限期免费），没有 cache write token 价，因此这些模型遇到实际 cache write 用量且 OpenCode 也缺价时标记为不可用。
-
-## DeepSeek
-
-来源：[DeepSeek Models & Pricing](https://api-docs.deepseek.com/quick_start/pricing)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `deepseek-v4.1-flash` | 2026-09-10 | 0.30 | 1.20 | 0.006 |
-| `deepseek-v4-pro-0813` | 2026-08-13 | 1.32 | 3.96 | 0.044 |
-
-表中采用官方**峰值时段最高价**作为保守估算上界；非峰值时段实际费率为表中一半。历史消息没有保留请求发生时对应的计费时段，无法准确选择峰谷档。已退役的 `deepseek-v4-flash` 与 `deepseek-v4-flash-vision-exp` 当前由官方路由到 V4.1 Flash 并按 Flash 价格计费；`deepseek-v4-flash-0731` 作为明确版本别名映射到同一条目。`deepseek-v4-pro` 当前对应 V4-Pro-0813。
-
-## Moonshot（Kimi）
-
-来源：[Kimi Model Inference Pricing](https://platform.moonshot.ai/docs/pricing)
-
-| 模型 | 发布日期 | Input | Output | Cache Read | Cache Write |
-| --- | --- | ---: | ---: | ---: | ---: |
-| `kimi-k3` | 2026-07-15 | 3 | 15 | 0.30 | 3（5 分钟 TTL） |
-| `kimi-k2.7-code` | 2026-06-12 | 0.95 | 4.00 | 0.19 | — |
-| `kimi-k2.6` | 2026-04-20 | 0.95 | 4.00 | 0.16 | — |
-
-K3 同时公布 5 分钟与 1 小时 cache write，快照沿用 Anthropic 约定取 5 分钟档；K2 系列只公布 cache 命中输入价，没有 cache write 价。
-
-## 阿里云百炼（Qwen）
-
-来源：[Model Studio Model inference pricing](https://www.alibabacloud.com/help/en/model-studio/model-pricing)（新加坡 International 站点标准价）
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `qwen3.8-max`（含别名 `qwen3.8-max-0902`） | 2026-08-03 | 2 | 6 | — |
-| `qwen3.8-2.4t-a95b` | 2026-08-12 | 2 | 6 | — |
-| `qwen3.8-27b` | 2026-08-14 | 0.5 | 3 | 0.1 |
-| `qwen3.8-flash` | 2026-08-26 | 0.15 | 0.47 | — |
-| `qwen3.7-max` | 2026-05-20 | 2.5 | 7.5 | 0.5 |
-| `qwen3.7-plus` | 2026-05-26 | 0.4 / 1.2（>256K） | 1.6 / 4.8（>256K） | 0.08 / 0.24（>256K） |
-| `qwen3.7-flash` | 2026-07-15 | 0.03 / 0.10 / 0.20（>32K、>256K） | 0.13 / 0.40 / 0.80（>32K、>256K） | 0.006 / 0.02 / 0.04（>32K、>256K） |
-| `qwen3.6-max-preview` | 2026-04-20 | 1.3 / 2（>128K） | 7.8 / 12（>128K） | — |
-| `qwen3.6-plus` | 2026-04-02 | 0.5 / 2（>256K） | 3 / 6（>256K） | — |
-| `qwen3.6-flash` | 2026-04-16 | 0.25 / 1（>256K） | 1.5 / 4（>256K） | — |
-| `qwen3.6-27b` | 2026-04-22 | 0.6 | 3.6 | — |
-| `qwen3.6-35b-a3b` | 2026-04-15 | 0.375 | 2.25 | — |
-| `qwen3.5-plus-2026-04-20`（别名 `qwen3.5-plus-20260420`） | 2026-04-20 | 0.4 / 0.5（>256K） | 2.4 / 3（>256K） | — |
-
-档位边界按官方措辞换算：`256K<Token≤1M` 即传入超过 256,000 token 启用高价档。Cache Read 收录官方隐式缓存命中价（所在档 Input 的 20%），仅限官方公布该费率的模型；`qwen3.8-max`、`qwen3.8-max-0902`、`qwen3.8-flash`、`qwen3.8-2.4t-a95b` 的缓存价只在控制台公布，不收录。隐式缓存创建按 Input 100% 计费、显式缓存创建按 125% 计费，聚合字段无法区分，因此一律不收 Cache Write。`qwen3.7-plus` 页面当前标注限期 8 折，快照采用未打折的刊例价。
-
-## 小米（MiMo）
-
-来源：[Xiaomi MiMo API Pricing](https://mimo.mi.com/docs/price/pay-as-you-go)（海外美元价）
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `mimo-v2.5` | 2026-04-22 | 0.14 | 0.28 | 0.0028 |
-| `mimo-v2.5-pro` | 2026-04-22 | 0.435 | 0.87 | 0.0036 |
-| `mimo-v2.6-flash` | 2026-09-21 | 0.14 | 0.28 | 0.0028 |
-| `mimo-v2.6-pro` | 2026-09-21 | 0.435 | 0.87 | 0.0036 |
-| `mimo-v2.6-pro-ultraspeed` | 2026-09-21 | 4.35 | 8.7 | 0.036 |
-
-V2.6 系列官方宣布沿用 V2.5 系列 API 定价。Cache Write 官方限期免费，不设 token 价。
-
-## MiniMax
-
-来源：[MiniMax Pay as You Go](https://platform.minimax.io/docs/guides/pricing-paygo)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `minimax-m3` | 2026-05-31 | 0.30 / 0.60（>512K） | 1.20 / 2.40（>512K） | 0.06 / 0.12（>512K） |
-
-M3 页面标注"长期 5 折"，快照按核验日的实收价收录；官方只公布 cache 读取价，没有 cache write 价。
-
-## 腾讯（混元）
-
-来源：[Tencent Cloud TokenHub Model pricing](https://intl.cloud.tencent.com/document/product/1300/78937)（新加坡国际站美元价）
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `hy3` | 2026-07-06 | 0.132 | 0.528 | 0.033 |
-| `hy4-preview` | 2026-08-27 | 0.834 | 2.501 | 0.042 |
-
-官方页面只公布 cache 命中价，没有 cache write 价。
-
-## StepFun
-
-来源：[StepFun Pricing Details](https://platform.stepfun.ai/docs/en/guides/pricing/details)（海外站）
-
-| 模型 | 发布日期 | Input | Output | Cache Read | Cache Write |
-| --- | --- | ---: | ---: | ---: | ---: |
-| `step-5-preview` | 2026-09-21 | 1 | 2.7 | 0.05 | 1 |
-| `step-3.7-flash` | 2026-05-28 | 0.20 | 1.15 | 0.04 | — |
-
-Step 5 Preview 官方明确说明 cache-miss Input 包含首次缓存写入，因此 OpenCode 单独上报的 Cache Write 按同一 `$1 / M` 费率计算。按 7:2:1 的 Cache Read / Input / Output token 比例，综合价为 `(7 × 0.05 + 2 × 1 + 1 × 2.7) / 10 = $0.505 / M`，约 `$0.51 / M`；该数值仅用于场景比较，插件仍按每条消息的实际五类 token 计算。Step 3.7 Flash 没有公布独立 cache write 价。
-
-## Meta（Muse Spark）
-
-来源：[Meta Model API Pricing and rate limits](https://ai.developer.meta.com/docs/pricing-rate-limits)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `muse-spark-1.1` | 2026-07-09 | 1.25 | 4.25 | 0.15 |
-| `muse-spark-1.2` | 2026-08-05 | 1.25 | 4.25 | 0.15 |
-| `muse-spark-1.3` | 2026-09-02 | 1.25 | 4.25 | 0.15 |
-
-Contributor tier 以允许 Meta 使用提示词和回答进行训练为条件，按独立 tier 记录。官方没有公布 cache write token 价。
-
-| Contributor 模型 | 发布日期 | Input | Output | Cache Read | Cache Write |
-| --- | --- | ---: | ---: | ---: | ---: |
-| `muse-spark-1.2-contributor` | 2026-08-05 | 0.10 | 0.20 | 0.002 | — |
-| `muse-spark-1.3-contributor` | 2026-09-02 | 0.10 | 0.20 | 0.002 | — |
-
-OpenCode Zen 的 `muse-spark-1.2-contributor-free` 和 `muse-spark-1.3-contributor-free` 会精确匹配各自 Contributor 条目；Cost 因此按 Meta Contributor 费率估算。
-
-## Inception
-
-来源：[Inception Models](https://www.inceptionlabs.ai/models)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `mercury-2.5`（别名 `mercury-2.5-preview`） | 2026-09-08 | 0.04 | 0.15 | 0.004 |
-
-官网在核验日同时显示 `$0.20 / $0.75 / $0.02` 的刊例价和 80% off 的当前 API 价；快照采用当前实收的促销价，未使用 OpenRouter 自行报价。官方没有公布 cache write token 价。
-
-## Upstage
-
-来源：[Solar Pro 4 model page](https://console.upstage.ai/docs/models/solar-pro-4)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `solar-pro4`（别名 `solar-pro4-260806`） | 2026-08-06 | 0.30 | 1.20 | 0.06 |
-
-Solar Pro 4 的 90% off 活动已于 2026-09-10 结束，快照采用模型页当前标准 Console API 价；官方没有公布 cache write token 价。
-
-## Arcee AI
-
-来源：[Arcee Platform Pricing](https://docs.arcee.ai/get-started/pricing)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `trinity-large-thinking` | 2026-04-01 | 0.25 | 0.80 | 0.06 |
-
-该条目是 Arcee 托管 API 的标准推理价；模型同时提供开源权重，但本目录只记录 API 费用。官方没有公布 cache write token 价。
-
-## ByteDance Seed
-
-来源：[BytePlus ModelArk Pricing](https://docs.byteplus.com/en/docs/ModelArk/1099320)、[Seed2.1 release](https://seed.bytedance.com/en/blog/seed2-1-officially-released-advancing-ai-productivity)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `dola-seed-2-1-turbo`（别名 `seed-2-1-turbo`、`dola-seed-2-1-turbo-260628`） | 2026-06-23 | 0.50 | 2.50 | 0.10 |
-
-表中采用 BytePlus ModelArk 在线标准推理价。缓存存储按 token·小时另行收费，不是可由当前五类 token 统计表示的 Cache Write 单价，因此不收录。
-
-## Sakana Fugu
-
-来源：[Sakana Fugu Pricing](https://console.sakana.ai/pricing)、[Fugu Max and Fugu Ultra v2 release](https://sakana.ai/fugu-max-release)
-
-| 模型 | 发布日期 | Input | Output | Cache Read | 长上下文档位 |
-| --- | --- | ---: | ---: | ---: | --- |
-| `fugu-ultra-v2.0`（别名 `fugu-ultra-v2`） | 2026-09-11 | 5 | 30 | 0.50 | >272K：10 / 45 / 1 |
-| `fugu-max-v1.0`（别名 `fugu-max`） | 2026-09-11 | 2 | 6 | 0.25 | — |
-
-Fugu Ultra 的编排 token 已包含在 API 返回的 input/output 用量中，按同一 token 价估算；web search/web fetch 等工具调用费不是五类 token，故不计入 Cost。官方没有公布 cache write token 价。
-
-## Aion Labs
-
-来源：[Aion Labs Models](https://www.aionlabs.ai/docs/models)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `aion-3.0`（别名 `aion-labs/aion-3.0`） | 2026-05-05 | 3.00 | 6.00 | 0.75 |
-| `aion-3.0-mini`（别名 `aion-labs/aion-3.0-mini`） | 2026-05-14 | 0.70 | 1.40 | 0.18 |
-
-表中是 Aion Labs 自家 API 目录公布的 per-token 价，不是 OpenRouter 网关价；官方没有公布 cache write token 价。Aion 3.0 与 3.0 Mini 是基于 GLM / DeepSeek 家族的多模型协作系统，按一次请求的输入输出 token 计费。
-
-## 美团（LongCat）
-
-来源：[LongCat API Docs — LongCat-2.0 Pricing](https://longcat.chat/platform/docs/Pricing/LongCat-2.0.html)、[LongCat-2.0 发布](https://www.meituan.com/news/NN260630164005904)
-
-| 模型 | 发布日期 | Input | Output | Cache Read |
-| --- | --- | ---: | ---: | ---: |
-| `longcat-2.0` | 2026-06-30 | 0.30 | 1.20 | 0.006 |
-
-官方页面同时列出刊例价（$0.75 / $2.95 / $0.015）与限时活动价；与 MiniMax-M3、Mercury 2.5 相同，快照按核验日实际计收的限时价收录。官方没有公布 cache write token 价，缓存存储也不同 token 计费。
-
-## 暂不收录
-
-- Realtime、音频、图片、视频、embedding、按页、按分钟和按工具调用收费的模型无法仅由当前五类 token 用量准确计算。
-- `grok-4.20`、`grok-4.20-multi-agent` 发布于 2026-03-09，早于目录收录窗口起点 2026-03-22。
-- Fast/Priority 等其他未列出的加速档（例如 `claude-opus-4-7-fast`、`gpt-5.5-pro-fast`、`gpt-6-astra-pro` 和 MiniMax priority 档）不收录；上表列出当前快照中官方定价页明确支持的 GPT 与 Claude Fast 型号。
-- 其他免费模型（Gemma 系列、`cohere/north-mini-code` 等开源或网关零价款）不设价格条目。
-- 无法从厂商官方页面确认标准 token 价格的模型不猜价，包括 OpenRouter stealth/alpha 匿名模型、`z-ai/glm-5v-turbo`、`qwen3.6-plus-preview`、腾讯 `hy3-preview` 与 `hy-mt2-*`、`kwaipilot/kat-coder-pro-v2.5` 及其 Air 版本、除上表 OpenCode Zen SKU 外的 `inclusionai/ling-3.0-*`、`bytedance-seed/seed-2.0-code` 等。这些模型目前只能查到 OpenRouter、AtlasCloud、DeepInfra 等网关或第三方报价，不能据此推断厂商标准价。
-- 浮动别名（`-latest` 指针与 OpenRouter `~` 前缀条目）随底层模型漂移，不收录固定价。
-- 只有询价、托管部署价或无法从厂商官方页面确认标准 token 价格的模型不猜价。
+**Est. Cost 仍只是估算，不代表提供商账单**：快照可能滞后，也不含网关加价、地域价、未记录的促销或折扣、工具费和税费。更新时应复核有时效性的人工例外。

package/docs/verification.md

@@ -1,5 +1,20 @@
 # 验证记录
 
+## v0.4.0（子代理用量浮窗）
+
+验证日期：2026-09-24。Node.js v22.23.2；SDK 2.0.11，隔离的真实 OpenCode 2.0.11 宿主。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 62 项通过 |
+| `npm run build` | 通过 |
+| `npm run test:smoke` | 通过，打包产物 + 真实 OpenCode 2.0.11 + 本地模拟提供商 |
+
+子代理视图原本通过 `session.composer.top` 常驻展示完整面板，挤占对话区高度；现在仅保留 `Token Usage · Context … · Total … · Cost … · TPS …` 一行实时摘要，不显示快捷键。点击该行可打开宿主原生居中弹窗；摘要与弹窗共享同一控制器及完整面板的精确数字和实时 TPS/TTFT。Esc 关闭浮窗后摘要继续刷新，不影响子代理运行。根会话侧边栏与 `/usage` 的五区详细弹窗保持原有入口。
+
+真实终端集成在完成父／子代理调用后，确认子代理摘要显示 `Context 1,270 / 128,000 (1.0%)`、`Total 5,080`、`Cost <$0.01` 与实时 TPS，且没有快捷键或额外完整用量行。鼠标点击摘要打开的弹窗显示全树 `Steps 4`、`Input 400`、`Cache Read 4,000`；Esc 关闭后摘要保留，关闭浮窗未向模型发送消息。原有根会话 `/usage`、窄终端详细弹窗、活动模型切换与费用回退集成检查继续通过。
+
 ## v0.4.0（`/usage` 原生弹窗）
 
 验证日期：2026-09-23。Node.js v22.23.2；`@opencode/plugin`、`@opencode/client` 等 SDK 精确锁定 2.0.11。弹窗布局参考本地 OpenCode 2.0.15 源码中的 `dialog-status.tsx`、`dialog-debug.tsx` 和 `dialog-shell-output.tsx`，通过插件公开的斜杠命令、弹窗、`session.hook("context")` 和 RPC 接口实现，并在真实 OpenCode 2.0.11 宿主中验证。
@@ -11,7 +26,7 @@
 | `npm run build` | 通过，输出 ESM 与类型声明 |
 | `npm run test:smoke` | 通过，使用 `.tgz` 安装产物、真实 OpenCode 2.0.11 与本地模拟提供商 |
 
-`/usage` 仅在会话页面注册为 CLI 斜杠／命令面板命令，打开原生弹窗而不向模型发送新消息。弹窗按当前查看会话展示最后一次已完成压缩后的上下文用量；五类 token 的占比以该条 assistant 消息的已用 context 为分母，窗口占用率以活动模型上下文上限为分母。会话树明细沿用侧边栏的完整分页、子代理汇总和分叉继承去重口径；按模型汇总的费用与全树 Cost 共用逐消息计价规则，分别处理免费、缺价、`partial` 及内置官方价格回退。
+`/usage` 仅在会话页面注册为 CLI 斜杠／命令面板命令，打开原生弹窗而不向模型发送新消息。弹窗按当前查看会话展示最后一次已完成压缩后的上下文用量；五类 token 的占比以该条 assistant 消息的已用 context 为分母，窗口占用率以活动模型上下文上限为分母。会话树明细沿用侧边栏的完整分页、子代理汇总和分叉继承去重口径；按模型汇总的费用与全树 Est. Cost 共用逐消息计价规则，分别处理免费、缺价、`partial` 及内置官方价格回退。
 
 自动化测试新增：五类 context 分类百分比、压缩边界与未知上限；混合模型和 compaction、价格回退、免费与缺价时逐模型费用对全树费用的核对；弹窗详细快照在子会话、刷新失败恢复和切换会话时的生命周期。打包集成测试确认空会话不会伪造上下文占用，真实 `/usage` 可打开与关闭、显示 1,270 token 当前上下文分类和模型费用；100 × 28 终端内滚动可到达模型费用；真实子代理合并后显示全树 5,080 token；切换活动模型后弹窗上限变为 32,000，历史消息费用仍列在原模型下。2.0.11 子代理视图最初处于宿主的子代理覆盖层，不提供斜杠输入；其全树面板验证继续由 `session.composer.top` 覆盖。
 
@@ -28,7 +43,7 @@
 | `npm run build` | 通过 |
 | `npm run test:smoke` | 通过，真实 OpenCode 2.0.11 + 本地模拟提供商 |
 
-信息架构由 `Context / Context Sources / Session Tree / Cost by Model` 改为 **Context Window / Last Request / Context Breakdown / Session / By Model**：Context Window 只呈现上下文占用（分母为活动模型上限）并带条形图；原 Context 内的五类 token 迁入 Last Request 并补充该次请求的缓存率；`Context Sources · estimated` 改名 Context Breakdown；`Session Tree` 改名 Session，因为面板本来就是全树汇总而非树结构；`Cost by Model` 改名 By Model。标题下方新增一行显示会话名与活动模型（多模型时显示模型数量），正文不再重复模型名，弹窗改用宿主 `centered` 选项垂直居中。
+信息架构由 `Context / Context Sources / Session Tree / Est. Cost by Model` 改为 **Context Window / Last Request / Context Breakdown / Session / By Model**：Context Window 只呈现上下文占用（分母为活动模型上限）并带条形图；原 Context 内的五类 token 迁入 Last Request 并补充该次请求的缓存率；`Context Sources · estimated` 改名 Context Breakdown；`Session Tree` 改名 Session，因为面板本来就是全树汇总而非树结构；`Est. Cost by Model` 改名 By Model。标题下方新增一行显示会话名与活动模型（多模型时显示模型数量），正文不再重复模型名，弹窗改用宿主 `centered` 选项垂直居中。
 
 默认紧凑模式使用 K/M 缩写（< 1,000 精确、< 1,000,000 一位小数 K、≥ 1,000,000 两位小数 M，四舍五入不会出现 `1000.0K`），隐藏零值行，并把 Context Breakdown 的两类工具合并为 `Tools` 行按占比降序；按 `d` 切换详细模式，恢复精确数字、零值行、`System Tools` / `MCP Tools` 拆分以及 Session 逐类明细（含 Calls）。Session 单行汇总为 `steps · calls · tokens · cached% · cost`，其中 calls 与 By Model 各行同源，可与逐模型行核对。条形图宽度、Last Request 双列与内容宽度随宿主 `large` 档（88 列）收敛，窄终端自动改为单列并收窄条长。
 
@@ -81,11 +96,11 @@ SDK 从 2.0.9 升级到 2.0.11 后，四个顶层 OpenCode 包及锁文件中的
 
 新增 Steps 计数覆盖：`summarize` 对带与不带 `tokens` 的 assistant 消息各计一个 step、compaction 与 user 消息不计、无 summary 时显示 `—`；`uniqueMessages` 链路上分叉继承副本不重复计数（快照 2 个 step、独立分叉树 1 个 step）、compaction 不产生 step、孙会话视图与根视图同为 6 个 step；行序断言锁定 Context → Steps → Input，无 Context 时 Steps 位于面板第一行。基准行数由 6 行调整为 7 行。
 
-v0.3.0 成本测试覆盖：assistant 与 compaction 按消息实际 `model` 和五类 token 分别计算，混合模型树各自采用对应价格，消息自带 `cost` 不参与主 Cost。当前 OpenCode 模型目录中的完整适用价格优先；适用档位或实际使用类别缺价时，整条消息回退到内置官方快照，不拼接两套费率。官方目录测试锁定 72 个 2026-03-22 至 2026-09-22 发布的模型、来源 URL、唯一 ID、OpenAI/xAI/通义千问/MiniMax/Sakana 长上下文与上下文档位边界，以及 OpenRouter、Bedrock、Vertex 等包装格式和明确别名；相似名称不得猜价。目录按 OpenCode 当前模型目录（`temp/models.json`，210 个模型）补齐主流厂商：OpenAI、Anthropic、Google、xAI、Mistral、Cohere 之外新增 Z.ai（GLM）、DeepSeek、Moonshot（Kimi）、阿里云百炼（Qwen）、小米（MiMo）、MiniMax、腾讯（混元）、StepFun、Meta、Inception、Upstage、Arcee AI、ByteDance Seed、Sakana、Aion Labs、美团（LongCat）；DeepSeek V4.1 Flash 与 V4 Pro 按厂商官方峰值最高价估算，旧 Flash、Vision Exp 和日期版本通过精确别名匹配。Step 5 Preview 的缓存写入按官方“cache-miss Input 包含首次缓存写入”规则使用 `$1 / M`。OpenRouter 圆点写法 `claude-opus-4.7`/`4.8`/`5.5`、官方 ChatGPT SKU `chat-latest`（别名 `gpt-chat-latest`）、Mercury 2.5、Solar Pro 4、Seed 2.1 Turbo、Fugu 版本、Aion 的 `aion-labs/` 前缀与 LongCat 网关链路同样通过精确别名匹配。窗口外的 `grok-4.20`、Fast/Priority 档、图片/音频/视频、免费与无官方标准价的模型均不收录；`kwaipilot/kat-coder-pro-v2.5`、`inclusionai/ling-3.0-*` 和 `bytedance-seed/seed-2.0-code` 只有网关或第三方报价，未据此猜价。缺价显示 `Cost —`，已知小计与缺价消息并存时显示 `· partial`，明确零价显示 `$0.00`。
+v0.3.0 成本测试覆盖：assistant 与 compaction 按消息实际 `model` 和五类 token 分别计算，混合模型树各自采用对应价格，消息自带 `cost` 不参与主 Est. Cost。当前 OpenCode 模型目录中的完整适用价格优先；适用档位或实际使用类别缺价时，整条消息回退到内置官方快照，不拼接两套费率。官方目录测试锁定 72 个 2026-03-22 至 2026-09-22 发布的模型、来源 URL、唯一 ID、OpenAI/xAI/通义千问/MiniMax/Sakana 长上下文与上下文档位边界，以及 OpenRouter、Bedrock、Vertex 等包装格式和明确别名；相似名称不得猜价。目录按 OpenCode 当前模型目录（`temp/models.json`，210 个模型）补齐主流厂商：OpenAI、Anthropic、Google、xAI、Mistral、Cohere 之外新增 Z.ai（GLM）、DeepSeek、Moonshot（Kimi）、阿里云百炼（Qwen）、小米（MiMo）、MiniMax、腾讯（混元）、StepFun、Meta、Inception、Upstage、Arcee AI、ByteDance Seed、Sakana、Aion Labs、美团（LongCat）；DeepSeek V4.1 Flash 与 V4 Pro 按厂商官方峰值最高价估算，旧 Flash、Vision Exp 和日期版本通过精确别名匹配。Step 5 Preview 的缓存写入按官方“cache-miss Input 包含首次缓存写入”规则使用 `$1 / M`。OpenRouter 圆点写法 `claude-opus-4.7`/`4.8`/`5.5`、官方 ChatGPT SKU `chat-latest`（别名 `gpt-chat-latest`）、Mercury 2.5、Solar Pro 4、Seed 2.1 Turbo、Fugu 版本、Aion 的 `aion-labs/` 前缀与 LongCat 网关链路同样通过精确别名匹配。窗口外的 `grok-4.20`、Fast/Priority 档、图片/音频/视频、免费与无官方标准价的模型均不收录；`kwaipilot/kat-coder-pro-v2.5`、`inclusionai/ling-3.0-*` 和 `bytedance-seed/seed-2.0-code` 只有网关或第三方报价，未据此猜价。缺价显示 `Est. Cost —`，已知小计与缺价消息并存时显示 `· partial`，明确零价显示 `$0.00`。
 
 ### 真实 OpenCode 集成
 
-隔离 smoke 测试确认打包插件可加载；空会话隐藏无数据行并显示 `Steps 0`；在独立会话已经开始慢速流后，同一 TUI 切换过去会立即显示 `TPS ~…` 与 TTFT，完成后变为无 `~` 的精确 TPS；既有 token、上下文刷新、真实子代理全树累计、会话局部上下文及模型切换验证均继续通过。Steps 在真实集成中断言为：首条 assistant 完成后 `Steps 1` 且行序位于 Context 与 Input 之间；真实子代理场景下根视图与子代理视图均为 `Steps 4`（父 3 条 + 子 1 条），而被查看会话自身仍为 1。按 OpenCode 夹具价格计算，首条调用为 `$0.00126`，四条父/子代理调用累计 `$0.00504`；根会话切换到另一价格模型后，历史消息仍按自身模型保持 `$0.00504`，Context 则从 128,000 上限同步切换到 32,000。另一个模型在 OpenCode 目录中明确为 `cost: []`，其 `gpt-5.6-luna` 调用由打包产物内置官方价格计算为 `$0.000149`，TUI 显示 `Cost <$0.01`；安装包同时断言包含 `dist/pricing.js`、类型声明与 `docs/pricing.md`。本次 smoke 使用官方 `@opencode/cli-darwin-arm64@2.0.11` 的隔离二进制（安装于 `/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/isolated-cli-2011`，机器默认宿主仍为 2.0.14，未放宽版本断言），测试产物保存在 `/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/token-usage-smoke-Zq62zn`。
+隔离 smoke 测试确认打包插件可加载；空会话隐藏无数据行并显示 `Steps 0`；在独立会话已经开始慢速流后，同一 TUI 切换过去会立即显示 `TPS ~…` 与 TTFT，完成后变为无 `~` 的精确 TPS；既有 token、上下文刷新、真实子代理全树累计、会话局部上下文及模型切换验证均继续通过。Steps 在真实集成中断言为：首条 assistant 完成后 `Steps 1` 且行序位于 Context 与 Input 之间；真实子代理场景下根视图与子代理视图均为 `Steps 4`（父 3 条 + 子 1 条），而被查看会话自身仍为 1。按 OpenCode 夹具价格计算，首条调用为 `$0.00126`，四条父/子代理调用累计 `$0.00504`；根会话切换到另一价格模型后，历史消息仍按自身模型保持 `$0.00504`，Context 则从 128,000 上限同步切换到 32,000。另一个模型在 OpenCode 目录中明确为 `cost: []`，其 `gpt-5.6-luna` 调用由打包产物内置官方价格计算为 `$0.000149`，TUI 显示 `Est. Cost <$0.01`；安装包同时断言包含 `dist/pricing.js`、类型声明与 `docs/pricing.md`。本次 smoke 使用官方 `@opencode/cli-darwin-arm64@2.0.11` 的隔离二进制（安装于 `/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/isolated-cli-2011`，机器默认宿主仍为 2.0.14，未放宽版本断言），测试产物保存在 `/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/token-usage-smoke-Zq62zn`。
 
 ### 验证边界
 
@@ -114,10 +129,10 @@ npm 发布前检查确认无作用域名称 `opencode-token-usage` 已由其他
 
 `scripts/smoke.mjs` 使用带固定延迟的本地 OpenAI 兼容流，在真实 OpenCode 服务和 160 × 54 TUI 中验证：
 
-- 空会话隐藏 TPS、TTFT、Context、Cache Write 与 Cost，不显示伪零性能值。
+- 空会话隐藏 TPS、TTFT、Context、Cache Write 与 Est. Cost，不显示伪零性能值。
 - 第一段文本到达时，面板显示 `TPS ~2.4 tok/s` 与 `TTFT 0.4s`；`~` 明确表示按 UTF-8 字节估算的活动流速度。
 - assistant 完成并刷新快照后，TPS 自动变为无 `~` 的 `62.9 tok/s`。打包产物的 `historicalPerformance` 返回 62.893… tok/s，且同屏 OpenCode 自带消息状态也显示 62.9 tok/s。
-- 行顺序为 Context、五类 token、Cache Rate、Total、Cost、空行、TPS、TTFT；Cost 隐藏时仍在最后一条用量行后空一行。原有上下文、真实子代理全树累计与模型切换测试继续通过。
+- 行顺序为 Context、五类 token、Cache Rate、Total、Est. Cost、空行、TPS、TTFT；Est. Cost 隐藏时仍在最后一条用量行后空一行。原有上下文、真实子代理全树累计与模型切换测试继续通过。
 - 安装包包含 `dist/performance.js` 及其类型声明；结果文件记录宿主版本 2.0.11、Total 5,080 和性能值。
 - scoped 包安装在 `node_modules/@chenlongapps/opencode-token-usage` 后，根入口、TUI 入口和所有运行时断言均通过。
 
@@ -147,7 +162,7 @@ npm 发布前检查确认无作用域名称 `opencode-token-usage` 已由其他
 
 `scripts/smoke.mjs` 沿用 v0.1.0 的隔离方式，并新增上下文断言：
 
-- 空会话：面板保持 Input、Output、Reasoning、Cache Read、Cache Rate、Total 六行零值，不出现 `/ 128,000`、Context 行、Cache Write 与 Cost。
+- 空会话：面板保持 Input、Output、Reasoning、Cache Read、Cache Rate、Total 六行零值，不出现 `/ 128,000`、Context 行、Cache Write 与 Est. Cost。
 - 首条 assistant 完成后：`Context  1,270 / 128,000 (1.0%)`，且该行出现在 `Input` 行之上（终端逐行比对行号）。同一时刻宿主自带侧边栏为 `Context 1,270 tokens 1% used`，用量与插件一致（宿主百分比取整，插件保留一位小数）。
 - 子代理视图：树的累计 `Total 5,080`，而上下文仍为 `1,270 / 128,000 (1.0%)`，确认上下文只反映被查看会话、不随子树累计。
 - 切换到 `usage-test/large`（夹具上限 32,000）后无需新消息即同步：`Context 1,270 / 32,000 (4.0%)`。
@@ -158,7 +173,7 @@ npm 发布前检查确认无作用域名称 `opencode-token-usage` 已由其他
 - 上下文口径参照 OpenCode 2.0.10 打包产物的侧边栏实现（`Ws`/`S6`）：最后一次 `completed` 压缩之后、最后一条带 `tokens` 的 assistant 消息的五类 token 之和。SDK 依赖仍为 2.0.9，2.0.9 宿主未单独核对这一显示算法。
 - 宿主 `Ws` 还使用 `session.revert` 作为搜索上界；本版本不读取 revert 状态，回退会话的取值可能与宿主不同。
 - 分母使用被查看会话的**活动模型**，而不是产生该用量的消息自身记录的模型；会话中途切换模型后两者可能不同。
-- Cost 与上下文上限使用同一活动模型解析规则，同样不使用消息自身记录的 `model` 字段：混合模型会话的 Cost 按查看时活动模型统一重算，不等于各模型实际账单之和。真实集成只验证了单夹具模型下的价格重算，混合模型的失真未单独断言。
+- Est. Cost 与上下文上限使用同一活动模型解析规则，同样不使用消息自身记录的 `model` 字段：混合模型会话的 Est. Cost 按查看时活动模型统一重算，不等于各模型实际账单之和。真实集成只验证了单夹具模型下的价格重算，混合模型的失真未单独断言。
 - 不显示进度条，上下文百分比与用量同行；行值加标签约 31 字符，窄侧边栏可能换行，响应式布局与进度条留待后续版本。
 - 夹具 `usage-test/large` 的上下文上限改为 32,000 以便观测模型切换，`usage-test/small` 保持 128,000。
 
@@ -188,7 +203,7 @@ Python 3 为真实 TUI 提供 160 × 54 的伪终端，终端输出经 xterm 解
 已验证：
 
 - 主插件激活、TUI 插件加载；安装包包含根目录 `index.js` / `tui.js`、编译产物及类型声明。
-- 空会话隐藏零值的 Cache Write 与 Cost；基础统计行、宿主标题、Context 与费用区继续保留。
+- 空会话隐藏零值的 Cache Write 与 Est. Cost；基础统计行、宿主标题、Context 与费用区继续保留。
 - 首条 assistant 完成后无需重新进入会话即可刷新：Input 100、Output 50、Reasoning 20、Cache Read 1,000、Cache Write 100，Total 1,270。
 - 父会话三条 assistant 消息和一个真实子代理的一条消息共同累计为 Total 5,080，显示为 `5,080`。
 - 父视图与子代理视图都显示 Input 400、Output 200、Reasoning 80、Cache Read 4,000、Cache Write 400、Cache Rate 83.3%。
@@ -203,3 +218,9 @@ Python 3 为真实 TUI 提供 160 × 54 的伪终端，终端输出经 xterm 解
 - 多层分页、压缩与分叉去重、故障恢复由自动化逻辑测试覆盖；真实 TUI 验证覆盖加载、正常消息、一级真实子代理和模型切换。
 
 重现时运行 README 中的检查命令。烟雾测试会输出临时产物目录，包含 `result.json`、`plugins.json`、各阶段终端捕获和已隐藏服务器密码的日志。
+
+## 2026-09-25 · 原厂价格半自动更新
+
+`npm run prices:update` 从 models.dev API 提取经审核的原厂 Provider 自家文本型号，生成离线 `src/prices.generated.ts`：本次为 283 条生成价格，叠加已核实例外后为 296 条。脚本重跑时确认生成内容不变（新增、删除、变化均为 0）。例外与原厂过滤在 `src/overrides.ts`，精确别名在 `src/aliases.ts`；网关/地域/订阅报价不作为数据源。
+
+已通过 `npm run typecheck`、55 项 `npm test` 和 `npm run build`。使用临时安装的 OpenCode v2.0.11 运行 `npm run test:smoke`，打包安装后的插件通过侧边栏、`/usage`、真实子代理、模型切换、无 OpenCode 价格时的内置回退等检查；打包产物包含生成快照、别名和例外模块。当前机器默认 OpenCode v2.0.16 未参与本次集成验证。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenlongapps/opencode-token-usage",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Session-tree token usage, live performance, context window and estimated cost for OpenCode 2",
   "keywords": [
     "opencode",
@@ -49,6 +49,7 @@
     "typecheck": "tsc --noEmit",
     "test": "tsx --test test/*.test.ts",
     "test:smoke": "node scripts/smoke.mjs",
+    "prices:update": "tsx scripts/update-prices.ts",
     "release:patch": "npm version patch",
     "prepublishOnly": "npm run typecheck && npm test",
     "prepack": "npm run build"