npm - @chenlongapps/opencode-token-usage - Versions diffs - 0.2.5 → 0.3.0 - Mend

@chenlongapps/opencode-token-usage 0.2.5 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/README.md CHANGED Viewed

@@ -50,7 +50,7 @@ For remote sessions, add the package name to `plugins` in your local `~/.config/
 | `Total` | Sum of all five token categories |
 | `Context` | Latest context usage after the most recent completed compaction in the viewed session; not aggregated across the subtree |
 | `Steps` | Assistant message count across the session tree, including subagents; follows OpenCode's own stats definition, so compaction and user messages are not steps |
-| `Cost` | Estimated cost for the entire tree, recalculated using the viewed session's active model; not a provider bill |
+| `Cost` | Estimated cost across the tree, pricing each assistant and compaction call with its actual model |
 | `TPS` | Generation throughput for `Output + Reasoning` across the tree; live estimates are marked with `~` |
 | `TTFT` | Average time to first token across measurable assistant steps in the tree |
@@ -60,7 +60,9 @@ For remote sessions, add the package name to `plugins` in your local `~/.config/
 - A fork is a separate session tree. Inherited message copies are attributed only to their original source to prevent double counting.
 - `Context` only searches messages after the most recent compaction with `status === "completed"` and is hidden when reliable usage or a model context limit is unavailable.
 - `Steps` counts every assistant message in the tree, whether or not it reported usage, and reuses the fork-copy de-duplication so inherited history is never counted twice.
-- `Cost` applies the viewed session's active model to the whole tree. Missing applicable prices fall back to 0, matching OpenCode's behavior.
+- `Cost` prices every message with its recorded model. A complete applicable price resolved by OpenCode takes precedence; when OpenCode has no usable price, the plugin falls back to a packaged snapshot of manufacturer prices.
+- Gateway models can use manufacturer fallback prices through exact model IDs and documented aliases. The fallback does not include gateway markups, regional premiums, discounts, tool fees, or taxes, so Cost is an estimate rather than a provider bill.
+- Confirmed free usage displays `$0.00`; unavailable prices display `—`; known subtotals with unpriced messages are marked `partial`. See the [built-in price snapshot](docs/pricing.md) for coverage, sources, and limitations.
 - Initial read failures display `Unavailable`. Later failures retain the last complete snapshot, display `Not updated`, and retry automatically.
 ### Development
@@ -73,7 +75,7 @@ npm run build
 npm run test:smoke
 ```
-`test:smoke` packages the real artifact and validates loading, refreshes, subagent aggregation, model switching, TPS, and TTFT against an isolated OpenCode instance and a local mock provider. It requires Python 3, an available local port, and npm network access. It never modifies your existing OpenCode configuration or calls paid models.
+`test:smoke` packages the real artifact and validates loading, refreshes, subagent aggregation, per-message pricing, official-price fallback, model switching, TPS, and TTFT against an isolated OpenCode instance and a local mock provider. It requires Python 3, an available local port, and npm network access. It never modifies your existing OpenCode configuration or calls paid models.
 To load the plugin from source, build the project and add the repository's absolute path to `plugins` in the target project.

package/README.zh-CN.md CHANGED Viewed

@@ -50,7 +50,7 @@ opencode plugin add @chenlongapps/opencode-token-usage
 | `Total` | 五类 token 之和 |
 | `Context` | 当前会话最后一次已完成压缩后的最新上下文用量，不随子树累计 |
 | `Steps` | 全树（含子代理）的 assistant 消息数，口径与 OpenCode 自带统计一致，compaction 与用户消息不计为 step |
-| `Cost` | 按当前会话活动模型重新估算的全树费用，不代表提供商账单 |
+| `Cost` | 按每条 assistant 与 compaction 消息实际模型估算的全树费用 |
 | `TPS` | 全树 `Output + Reasoning` 的生成速度；生成中的估算值带 `~` 标记 |
 | `TTFT` | 全树中可测 assistant step 的平均首 token 时间 |
@@ -60,7 +60,9 @@ opencode plugin add @chenlongapps/opencode-token-usage
 - 分叉会话是独立会话树。继承消息副本只归原始来源，避免重复计费。
 - `Context` 仅搜索最后一次 `status === "completed"` 的 compaction 之后；没有可靠用量或模型上限时隐藏。
 - `Steps` 统计树中全部 assistant 消息，无论是否已上报用量；复用分叉副本去重，继承历史不会重复计数。
-- `Cost` 使用当前查看会话的活动模型重算整棵树；缺失适用价格时按 OpenCode 行为回退为 0。
+- `Cost` 按每条消息记录的实际模型分别计算。OpenCode 当前解析出的完整适用价格优先；OpenCode 没有可用价格时，回退到插件内置的厂商官方价格快照。
+- 网关模型可通过精确模型 ID 和已记录别名使用厂商价格，但不包含网关加价、区域溢价、折扣、工具费和税费，因此 Cost 是估算而非提供商账单。
+- 确认免费时显示 `$0.00`；价格不可用时显示 `—`；只有部分消息可计算时在已知小计后标注 `partial`。覆盖范围、来源和限制见[内置官方价格快照](docs/pricing.md)。
 - 首次读取失败显示 `Unavailable`；后续失败保留上次完整快照、标注 `Not updated` 并自动重试。
 ### 开发
@@ -73,7 +75,7 @@ npm run build
 npm run test:smoke
 ```
-`test:smoke` 会打包真实产物，并在隔离的 OpenCode 与本地模拟提供商中验证加载、刷新、子代理累计、模型切换、TPS 和 TTFT。它需要 Python 3、可用的本地端口和 npm 网络访问，不会修改现有 OpenCode 配置或调用付费模型。
+`test:smoke` 会打包真实产物，并在隔离的 OpenCode 与本地模拟提供商中验证加载、刷新、子代理累计、逐消息计价、官方价格补全、模型切换、TPS 和 TTFT。它需要 Python 3、可用的本地端口和 npm 网络访问，不会修改现有 OpenCode 配置或调用付费模型。
 从源码加载时，先构建项目，再将仓库绝对路径加入目标项目的 `plugins`。

package/ROADMAP.md CHANGED Viewed

@@ -68,13 +68,19 @@ TTFT  2.7s
 Steps  1,234
 ```
-## v0.3.0 — 公开价格目录
+## v0.3.0 — 官方价格补全
-目标：提供可查询的价格目录，便于用户了解不同模型的计费档位。
+目标：按每条消息实际使用的模型统计费用，并在 OpenCode 缺少价格时使用厂商官方价格补全。
-* [ ] 构建公开价格目录，包含模型、价格档位及阈值
-* [ ] 只收录半年内发布的模型
-<!-- TODO -->
+* [x] 内置可追溯的厂商官方价格快照
+* [x] 首版收录最近半年发布且具有明确标准 token 定价的模型
+* [x] OpenCode 完整适用价格优先，缺失时整条消息回退到官方价格
+* [x] 按 assistant 与 compaction 消息实际模型分别计算
+* [x] 支持价格阶梯、缓存读写和 Reasoning 费用
+* [x] 支持网关模型到厂商模型的精确 ID 与明确别名映射
+* [x] 区分免费、部分可计算和价格不可用
+* [x] 已收录模型永久保留，后续持续核验价格和来源
+* [x] 通过单元测试与 OpenCode 2.0.11 打包集成验证
 ## v0.4.0 — 用量命令
@@ -88,5 +94,4 @@ Steps  1,234
 ## 后续评估
-* [ ] 公开价格目录与更新策略
 * [x] 首次 npm 发布：`@chenlongapps/opencode-token-usage@0.2.1`

package/dist/controller.js CHANGED Viewed

@@ -137,7 +137,7 @@ export class UsageController {
             this.performanceTimer = undefined;
             this.update({
                 status: "ready",
-                summary: summarize(messages, snapshot.model.prices),
+                summary: summarize(messages, snapshot.model.catalog),
                 context: contextUsage(viewedMessages(snapshot), snapshot.model.context),
                 performance: this.performance.summary(messages, this.sessions),
                 model: snapshot.model.label,

package/dist/pricing.d.ts ADDED Viewed

@@ -0,0 +1,142 @@
+import type { ModelRef, Price } from "./usage.js";
+export interface OfficialPriceEntry {
+    /** Canonical model ID used by the model manufacturer. */
+    id: string;
+    /** First public release date, used to enforce the snapshot's inclusion window. */
+    released: string;
+    /** Exact alternate IDs used by supported gateways or manufacturer aliases. */
+    aliases?: readonly string[];
+    /** Standard, synchronous API token rates in USD per million tokens. */
+    prices: readonly Price[];
+    /** Manufacturer pricing page used to verify the rates. */
+    source: string;
+}
+export declare const OFFICIAL_PRICE_SNAPSHOT: {
+    readonly verified: "2026-09-23";
+    readonly newModelCutoff: "2026-03-22";
+    readonly entries: ({
+        id: string;
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+        })[];
+        aliases?: never;
+    } | {
+        id: string;
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+        })[];
+        aliases?: never;
+    } | {
+        id: string;
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+                write: number;
+            };
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+                write: number;
+            };
+        })[];
+        aliases?: never;
+    } | {
+        id: string;
+        aliases: string[];
+        released: string;
+        source: string;
+        prices: {
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+                write: number;
+            };
+        }[];
+    } | {
+        id: string;
+        aliases: string[];
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+        })[];
+    } | {
+        id: string;
+        aliases: string[];
+        released: string;
+        source: string;
+        prices: ({
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+            tier?: never;
+        } | {
+            tier: {
+                type: "context";
+                size: number;
+            };
+            input: number;
+            output: number;
+            cache: {
+                read: number;
+            };
+        })[];
+    })[];
+};
+/**
+ * Resolves exact manufacturer IDs through common gateway wrappers. It never
+ * performs substring or model-name matching, so similarly named variants do
+ * not silently inherit a different model's price.
+ */
+export declare function officialPrice(model: ModelRef): OfficialPriceEntry | undefined;

package/dist/pricing.js ADDED Viewed

@@ -0,0 +1,484 @@
+export const OFFICIAL_PRICE_SNAPSHOT = {
+    verified: "2026-09-23",
+    newModelCutoff: "2026-03-22",
+    entries: [
+        // OpenAI standard processing. The tier sizes are exclusive thresholds, so
+        // 271,999 implements the official "long context at 272K" boundary.
+        {
+            id: "gpt-5.5", released: "2026-04-23", source: "https://developers.openai.com/api/docs/pricing",
+            prices: [
+                { input: 5, output: 30, cache: { read: 0.5 } },
+                { tier: { type: "context", size: 271_999 }, input: 10, output: 45, cache: { read: 1 } },
+            ],
+        },
+        {
+            id: "gpt-5.5-pro", released: "2026-04-23", source: "https://developers.openai.com/api/docs/pricing",
+            prices: [
+                { input: 30, output: 180 },
+                { tier: { type: "context", size: 271_999 }, input: 60, output: 270 },
+            ],
+        },
+        {
+            id: "gpt-5.6-sol", released: "2026-07-09", source: "https://developers.openai.com/api/docs/pricing",
+            prices: [
+                { input: 4, output: 20, cache: { read: 0.4, write: 5 } },
+                { tier: { type: "context", size: 271_999 }, input: 8, output: 30, cache: { read: 0.8, write: 10 } },
+            ],
+        },
+        {
+            id: "gpt-5.6-terra", released: "2026-07-09", source: "https://developers.openai.com/api/docs/pricing",
+            prices: [
+                { input: 2, output: 12, cache: { read: 0.2, write: 2.5 } },
+                { tier: { type: "context", size: 271_999 }, input: 4, output: 18, cache: { read: 0.4, write: 5 } },
+            ],
+        },
+        {
+            id: "gpt-5.6-luna", released: "2026-07-09", source: "https://developers.openai.com/api/docs/pricing",
+            prices: [
+                { input: 0.2, output: 1.2, cache: { read: 0.02, write: 0.25 } },
+                { tier: { type: "context", size: 271_999 }, input: 0.4, output: 1.8, cache: { read: 0.04, write: 0.5 } },
+            ],
+        },
+        {
+            id: "gpt-6-astra", released: "2026-09-04", source: "https://developers.openai.com/api/docs/pricing",
+            prices: [
+                { input: 10, output: 50, cache: { read: 1, write: 12.5 } },
+                { tier: { type: "context", size: 271_999 }, input: 20, output: 75, cache: { read: 2, write: 25 } },
+            ],
+        },
+        // The official ChatGPT SKU `chat-latest`. OpenRouter serves it under the
+        // slug `openai/gpt-chat-latest`, which is registered as an exact alias.
+        {
+            id: "chat-latest", aliases: ["gpt-chat-latest"], released: "2026-05-05",
+            source: "https://developers.openai.com/api/docs/pricing",
+            prices: [{ input: 5, output: 30, cache: { read: 0.5 } }],
+        },
+        // Anthropic standard processing and 5-minute cache writes. OpenCode's
+        // aggregate cache-write counter cannot distinguish 5-minute from 1-hour TTL.
+        {
+            id: "claude-opus-4-7", aliases: ["claude-opus-4.7"], released: "2026-04-14", source: "https://platform.claude.com/docs/en/about-claude/pricing",
+            prices: [{ input: 5, output: 25, cache: { read: 0.5, write: 6.25 } }],
+        },
+        {
+            id: "claude-opus-4-8", aliases: ["claude-opus-4.8"], released: "2026-05-28", source: "https://platform.claude.com/docs/en/about-claude/pricing",
+            prices: [{ input: 5, output: 25, cache: { read: 0.5, write: 6.25 } }],
+        },
+        {
+            id: "claude-fable-5", released: "2026-06-07", source: "https://platform.claude.com/docs/en/about-claude/pricing",
+            prices: [{ input: 10, output: 50, cache: { read: 1, write: 12.5 } }],
+        },
+        {
+            id: "claude-sonnet-5", released: "2026-06-29", source: "https://platform.claude.com/docs/en/about-claude/pricing",
+            prices: [{ input: 2, output: 10, cache: { read: 0.2, write: 2.5 } }],
+        },
+        {
+            id: "claude-opus-5", released: "2026-07-24", source: "https://platform.claude.com/docs/en/about-claude/pricing",
+            prices: [{ input: 5, output: 25, cache: { read: 0.5, write: 6.25 } }],
+        },
+        {
+            id: "claude-fable-5-1", aliases: ["claude-fable-5.1"], released: "2026-09-01",
+            source: "https://platform.claude.com/docs/en/about-claude/pricing",
+            prices: [{ input: 10, output: 50, cache: { read: 0.25, write: 12.5 } }],
+        },
+        // Google paid Standard API rates. Cache storage is billed separately by
+        // time and is intentionally not represented as a cache-write token rate.
+        {
+            id: "gemini-3.1-flash-lite", released: "2026-05-07", source: "https://ai.google.dev/gemini-api/docs/pricing",
+            prices: [{ input: 0.25, output: 1.5, cache: { read: 0.025 } }],
+        },
+        {
+            id: "gemini-3.5-flash", released: "2026-05-19", source: "https://ai.google.dev/gemini-api/docs/pricing",
+            prices: [{ input: 1.5, output: 9, cache: { read: 0.15 } }],
+        },
+        {
+            id: "gemini-3.5-flash-lite", released: "2026-07-21", source: "https://ai.google.dev/gemini-api/docs/pricing",
+            prices: [{ input: 0.3, output: 2.5, cache: { read: 0.03 } }],
+        },
+        {
+            id: "gemini-3.6-flash", released: "2026-07-21", source: "https://ai.google.dev/gemini-api/docs/pricing",
+            prices: [{ input: 0.75, output: 3.75, cache: { read: 0.075 } }],
+        },
+        {
+            id: "gemini-3.7-flash", released: "2026-08-13", source: "https://ai.google.dev/gemini-api/docs/pricing",
+            prices: [{ input: 0.75, output: 3.75, cache: { read: 0.075 } }],
+        },
+        {
+            id: "gemini-3.8-flash", released: "2026-09-02", source: "https://ai.google.dev/gemini-api/docs/pricing",
+            prices: [{ input: 0.75, output: 3.75, cache: { read: 0.075 } }],
+        },
+        // xAI standard text API rates. 199,999 implements the official higher
+        // price at 200K prompt tokens with OpenCode's exclusive-tier formula.
+        {
+            id: "grok-build-0.1", released: "2026-04-16", source: "https://docs.x.ai/developers/models",
+            prices: [
+                { input: 1, output: 2, cache: { read: 0.2 } },
+                { tier: { type: "context", size: 199_999 }, input: 2, output: 4, cache: { read: 0.4 } },
+            ],
+        },
+        {
+            id: "grok-4.3", released: "2026-04-17", source: "https://docs.x.ai/developers/models",
+            prices: [
+                { input: 1.25, output: 2.5, cache: { read: 0.2 } },
+                { tier: { type: "context", size: 199_999 }, input: 2.5, output: 5, cache: { read: 0.4 } },
+            ],
+        },
+        {
+            id: "grok-4.5", released: "2026-07-08", source: "https://docs.x.ai/developers/models",
+            prices: [
+                { input: 2, output: 6, cache: { read: 0.3 } },
+                { tier: { type: "context", size: 199_999 }, input: 4, output: 12, cache: { read: 0.6 } },
+            ],
+        },
+        {
+            id: "grok-4.6", released: "2026-08-12", source: "https://docs.x.ai/developers/models",
+            prices: [
+                { input: 2, output: 6, cache: { read: 0.5 } },
+                { tier: { type: "context", size: 199_999 }, input: 4, output: 12, cache: { read: 1 } },
+            ],
+        },
+        {
+            id: "grok-4.7", released: "2026-09-21",
+            source: "https://docs.x.ai/developers/models",
+            prices: [
+                { input: 2, output: 6, cache: { read: 0.5 } },
+                { tier: { type: "context", size: 199_999 }, input: 4, output: 12, cache: { read: 1 } },
+            ],
+        },
+        {
+            id: "mistral-medium-3-5-26-04",
+            aliases: ["mistral-medium-2604", "mistral-medium-3-5"],
+            released: "2026-04-29",
+            source: "https://docs.mistral.ai/inference/pricing",
+            prices: [{ input: 1.5, output: 7.5, cache: { read: 0.15 } }],
+        },
+        {
+            id: "command-a-plus-05-2026",
+            released: "2026-05-20",
+            source: "https://cohere.com/pricing",
+            prices: [{ input: 2.5, output: 10 }],
+        },
+        // Meta Model API standard-tier rates. The contributor tier is a separate
+        // discounted program that permits training on prompts and completions, so
+        // it is intentionally not part of the standard snapshot.
+        {
+            id: "muse-spark-1.1", released: "2026-07-09", source: "https://ai.developer.meta.com/docs/pricing-rate-limits",
+            prices: [{ input: 1.25, output: 4.25, cache: { read: 0.15 } }],
+        },
+        {
+            id: "muse-spark-1.2", released: "2026-08-05", source: "https://ai.developer.meta.com/docs/pricing-rate-limits",
+            prices: [{ input: 1.25, output: 4.25, cache: { read: 0.15 } }],
+        },
+        {
+            id: "muse-spark-1.3", released: "2026-09-02", source: "https://ai.developer.meta.com/docs/pricing-rate-limits",
+            prices: [{ input: 1.25, output: 4.25, cache: { read: 0.15 } }],
+        },
+        // Inception's current Mercury 2.5 API page shows an 80% launch discount;
+        // the snapshot records the billed standard-platform rates on verification
+        // day rather than the crossed-out list prices. No cache-write token rate is
+        // published.
+        {
+            id: "mercury-2.5", aliases: ["mercury-2.5-preview"], released: "2026-09-08",
+            source: "https://www.inceptionlabs.ai/models",
+            prices: [{ input: 0.04, output: 0.15, cache: { read: 0.004 } }],
+        },
+        // Upstage Solar Pro 4 standard Console API rates. The dated version ID is
+        // an exact manufacturer alias; no cache-write token rate is published.
+        {
+            id: "solar-pro4", aliases: ["solar-pro4-260806"], released: "2026-08-06",
+            source: "https://console.upstage.ai/docs/models/solar-pro-4",
+            prices: [{ input: 0.3, output: 1.2, cache: { read: 0.06 } }],
+        },
+        // Arcee AI's hosted API rates for the official Trinity reasoning release.
+        // The model is also available as open weights, but only the hosted API
+        // price is relevant to this token-cost snapshot.
+        {
+            id: "trinity-large-thinking", released: "2026-04-01", source: "https://docs.arcee.ai/get-started/pricing",
+            prices: [{ input: 0.25, output: 0.8, cache: { read: 0.06 } }],
+        },
+        // Aion Labs' own model catalog publishes these per-token API rates. The
+        // OpenRouter slugs retain the manufacturer's `aion-labs/` prefix, so it is
+        // registered as an exact alias rather than inferred from the name.
+        {
+            id: "aion-3.0", aliases: ["aion-labs/aion-3.0"], released: "2026-05-05",
+            source: "https://www.aionlabs.ai/docs/models",
+            prices: [{ input: 3, output: 6, cache: { read: 0.75 } }],
+        },
+        {
+            id: "aion-3.0-mini", aliases: ["aion-labs/aion-3.0-mini"], released: "2026-05-14",
+            source: "https://www.aionlabs.ai/docs/models",
+            prices: [{ input: 0.7, output: 1.4, cache: { read: 0.18 } }],
+        },
+        // Z.ai (Zhipu GLM) standard API rates. The page publishes a cache-hit input
+        // rate and prices cache storage by time instead of a cache-write token rate,
+        // so no cache-write rate is stored for these models.
+        {
+            id: "glm-5.1", released: "2026-04-06", source: "https://docs.z.ai/guides/overview/pricing",
+            prices: [{ input: 1.4, output: 4.4, cache: { read: 0.26 } }],
+        },
+        {
+            id: "glm-5.2", released: "2026-06-16", source: "https://docs.z.ai/guides/overview/pricing",
+            prices: [{ input: 1.4, output: 4.4, cache: { read: 0.26 } }],
+        },
+        {
+            id: "glm-5.3", released: "2026-08-16", source: "https://docs.z.ai/guides/overview/pricing",
+            prices: [{ input: 1.4, output: 4.4, cache: { read: 0.26 } }],
+        },
+        {
+            id: "glm-5.3-flash", released: "2026-08-26", source: "https://docs.z.ai/guides/overview/pricing",
+            prices: [{ input: 0.15, output: 0.5, cache: { read: 0.03 } }],
+        },
+        {
+            id: "glm-5.3-flashx", released: "2026-09-18", source: "https://docs.z.ai/guides/overview/pricing",
+            prices: [{ input: 0.37, output: 1.25, cache: { read: 0.075 } }],
+        },
+        // DeepSeek standard API peak rates. The vendor charges half these rates
+        // off-peak; using the peak tier provides a conservative upper-bound
+        // estimate because historical messages do not retain the billing hour.
+        // Retired V4 Flash and Vision Exp names currently route to V4.1 Flash at
+        // the Flash price. The dated 0731 and 0813 IDs are exact gateway aliases.
+        {
+            id: "deepseek-v4.1-flash",
+            aliases: ["deepseek-flash", "deepseek-v4-flash", "deepseek-v4-flash-0731", "deepseek-v4-flash-vision-exp"],
+            released: "2026-09-10",
+            source: "https://api-docs.deepseek.com/quick_start/pricing",
+            prices: [{ input: 0.3, output: 1.2, cache: { read: 0.006 } }],
+        },
+        {
+            id: "deepseek-v4-pro-0813", aliases: ["deepseek-v4-pro"], released: "2026-08-13",
+            source: "https://api-docs.deepseek.com/quick_start/pricing",
+            prices: [{ input: 1.32, output: 3.96, cache: { read: 0.044 } }],
+        },
+        // Moonshot Kimi standard API rates. K3 publishes 5-minute and 1-hour cache
+        // writes; following the Anthropic convention, the aggregate counter cannot
+        // tell them apart, so the snapshot stores the 5-minute write. The K2 table
+        // publishes only a cache-hit input rate and no cache-write price.
+        {
+            id: "kimi-k3", released: "2026-07-15", source: "https://platform.moonshot.ai/docs/pricing",
+            prices: [{ input: 3, output: 15, cache: { read: 0.3, write: 3 } }],
+        },
+        {
+            id: "kimi-k2.7-code", released: "2026-06-12", source: "https://platform.moonshot.ai/docs/pricing",
+            prices: [{ input: 0.95, output: 4, cache: { read: 0.19 } }],
+        },
+        {
+            id: "kimi-k2.6", released: "2026-04-20", source: "https://platform.moonshot.ai/docs/pricing",
+            prices: [{ input: 0.95, output: 4, cache: { read: 0.16 } }],
+        },
+        // Alibaba Cloud Model Studio standard (Singapore "International") list
+        // prices. Tier sizes implement the official inclusive boundaries
+        // ("0<Token≤256K" then "256K<Token≤1M") with the exclusive-threshold formula.
+        // Cache Read stores the official implicit-cache hit rate, 20% of the tier
+        // input, where the page publishes it. The qwen3.8 max/flash family reports
+        // cache rates only in the console, so no cache rate is stored for them, and
+        // no cache-write rate is stored anywhere because implicit cache writes bill
+        // at 100% of the input price while explicit cache writes bill at 125% and
+        // the aggregate counter cannot distinguish the two.
+        {
+            id: "qwen3.8-max", aliases: ["qwen3.8-max-0902"], released: "2026-08-03",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [{ input: 2, output: 6 }],
+        },
+        {
+            id: "qwen3.8-2.4t-a95b", released: "2026-08-12",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [{ input: 2, output: 6 }],
+        },
+        {
+            id: "qwen3.8-27b", released: "2026-08-14",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [{ input: 0.5, output: 3, cache: { read: 0.1 } }],
+        },
+        {
+            id: "qwen3.8-flash", released: "2026-08-26",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [{ input: 0.15, output: 0.47 }],
+        },
+        {
+            id: "qwen3.7-max", released: "2026-05-20",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [{ input: 2.5, output: 7.5, cache: { read: 0.5 } }],
+        },
+        {
+            id: "qwen3.7-plus", released: "2026-05-26",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [
+                { input: 0.4, output: 1.6, cache: { read: 0.08 } },
+                { tier: { type: "context", size: 256_000 }, input: 1.2, output: 4.8, cache: { read: 0.24 } },
+            ],
+        },
+        {
+            id: "qwen3.7-flash", released: "2026-07-15",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [
+                { input: 0.03, output: 0.13, cache: { read: 0.006 } },
+                { tier: { type: "context", size: 32_000 }, input: 0.1, output: 0.4, cache: { read: 0.02 } },
+                { tier: { type: "context", size: 256_000 }, input: 0.2, output: 0.8, cache: { read: 0.04 } },
+            ],
+        },
+        {
+            id: "qwen3.6-max-preview", released: "2026-04-20",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [
+                { input: 1.3, output: 7.8 },
+                { tier: { type: "context", size: 128_000 }, input: 2, output: 12 },
+            ],
+        },
+        {
+            id: "qwen3.6-plus", released: "2026-04-02",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [
+                { input: 0.5, output: 3 },
+                { tier: { type: "context", size: 256_000 }, input: 2, output: 6 },
+            ],
+        },
+        {
+            id: "qwen3.6-flash", released: "2026-04-16",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [
+                { input: 0.25, output: 1.5 },
+                { tier: { type: "context", size: 256_000 }, input: 1, output: 4 },
+            ],
+        },
+        {
+            id: "qwen3.6-27b", released: "2026-04-22",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [{ input: 0.6, output: 3.6 }],
+        },
+        {
+            id: "qwen3.6-35b-a3b", released: "2026-04-15",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [{ input: 0.375, output: 2.25 }],
+        },
+        {
+            id: "qwen3.5-plus-2026-04-20", aliases: ["qwen3.5-plus-20260420"], released: "2026-04-20",
+            source: "https://www.alibabacloud.com/help/en/model-studio/model-pricing",
+            prices: [
+                { input: 0.4, output: 2.4 },
+                { tier: { type: "context", size: 256_000 }, input: 0.5, output: 3 },
+            ],
+        },
+        // Xiaomi MiMo overseas USD rates. The MiMo-V2.6 series keeps the V2.5 API
+        // pricing. Cache writes are free for a limited time, so no cache-write rate
+        // is stored.
+        {
+            id: "mimo-v2.5", released: "2026-04-22", source: "https://mimo.mi.com/docs/price/pay-as-you-go",
+            prices: [{ input: 0.14, output: 0.28, cache: { read: 0.0028 } }],
+        },
+        {
+            id: "mimo-v2.5-pro", released: "2026-04-22", source: "https://mimo.mi.com/docs/price/pay-as-you-go",
+            prices: [{ input: 0.435, output: 0.87, cache: { read: 0.0036 } }],
+        },
+        {
+            id: "mimo-v2.6-flash", released: "2026-09-21", source: "https://mimo.mi.com/docs/price/pay-as-you-go",
+            prices: [{ input: 0.14, output: 0.28, cache: { read: 0.0028 } }],
+        },
+        {
+            id: "mimo-v2.6-pro", released: "2026-09-21", source: "https://mimo.mi.com/docs/price/pay-as-you-go",
+            prices: [{ input: 0.435, output: 0.87, cache: { read: 0.0036 } }],
+        },
+        {
+            id: "mimo-v2.6-pro-ultraspeed", released: "2026-09-21", source: "https://mimo.mi.com/docs/price/pay-as-you-go",
+            prices: [{ input: 4.35, output: 8.7, cache: { read: 0.036 } }],
+        },
+        // MiniMax pay-as-you-go billed rates. The page labels the M3 rates as a
+        // permanent 50% off and shows the struck-through list price beside them;
+        // like the GPT-5.6 Sol promotion, the snapshot stores the billed rates shown
+        // on the verification date. Only a prompt-caching read rate is published.
+        {
+            id: "minimax-m3", released: "2026-05-31", source: "https://platform.minimax.io/docs/guides/pricing-paygo",
+            prices: [
+                { input: 0.3, output: 1.2, cache: { read: 0.06 } },
+                { tier: { type: "context", size: 512_000 }, input: 0.6, output: 2.4, cache: { read: 0.12 } },
+            ],
+        },
+        // Tencent Cloud TokenHub international (Singapore) USD list prices for the
+        // vendor's own Hunyuan models. Cache is the published cache-hit rate; the
+        // page publishes no cache-write rate.
+        {
+            id: "hy3", released: "2026-07-06", source: "https://intl.cloud.tencent.com/document/product/1300/78937",
+            prices: [{ input: 0.132, output: 0.528, cache: { read: 0.033 } }],
+        },
+        {
+            id: "hy4-preview", released: "2026-08-27", source: "https://intl.cloud.tencent.com/document/product/1300/78937",
+            prices: [{ input: 0.834, output: 2.501, cache: { read: 0.042 } }],
+        },
+        // StepFun overseas platform rates. The page publishes a cache-hit input
+        // rate. For Step 5 Preview it explicitly states that cache-miss input
+        // includes writing new content to the cache, so split cache-write tokens
+        // retain the same rate as ordinary cache-miss input.
+        {
+            id: "step-5-preview", released: "2026-09-21", source: "https://platform.stepfun.ai/docs/en/guides/pricing/details",
+            prices: [{ input: 1, output: 2.7, cache: { read: 0.05, write: 1 } }],
+        },
+        {
+            id: "step-3.7-flash", released: "2026-05-28", source: "https://platform.stepfun.ai/docs/en/guides/pricing/details",
+            prices: [{ input: 0.2, output: 1.15, cache: { read: 0.04 } }],
+        },
+        // ByteDance Seed 2.1 Turbo standard online inference rates on BytePlus
+        // ModelArk. The cache-storage fee is time-based rather than a token write
+        // rate, so only the published cache-hit input price is represented.
+        {
+            id: "dola-seed-2-1-turbo",
+            aliases: ["seed-2-1-turbo", "dola-seed-2-1-turbo-260628"],
+            released: "2026-06-23",
+            source: "https://docs.byteplus.com/en/docs/ModelArk/1099320",
+            prices: [{ input: 0.5, output: 2.5, cache: { read: 0.1 } }],
+        },
+        // Sakana Fugu's fixed standard API rates. Fugu Ultra's orchestration
+        // tokens are included in the API's input/output usage fields and therefore
+        // use the same token rates. Web search/fetch tool fees are not token fees
+        // and cannot be represented by the plugin's five usage counters.
+        {
+            id: "fugu-ultra-v2.0", aliases: ["fugu-ultra-v2"], released: "2026-09-11",
+            source: "https://console.sakana.ai/pricing",
+            prices: [
+                { input: 5, output: 30, cache: { read: 0.5 } },
+                { tier: { type: "context", size: 271_999 }, input: 10, output: 45, cache: { read: 1 } },
+            ],
+        },
+        {
+            id: "fugu-max-v1.0", aliases: ["fugu-max"], released: "2026-09-11",
+            source: "https://console.sakana.ai/pricing",
+            prices: [{ input: 2, output: 6, cache: { read: 0.25 } }],
+        },
+        // LongCat's official API page shows both list and limited-time discounted
+        // rates. As with the other documented promotions in this snapshot, record
+        // the billed discounted rate visible on verification day. Cache storage or
+        // cache writes have no separate token rate on the page.
+        {
+            id: "longcat-2.0", released: "2026-06-30",
+            source: "https://longcat.chat/platform/docs/Pricing/LongCat-2.0.html",
+            prices: [{ input: 0.3, output: 1.2, cache: { read: 0.006 } }],
+        },
+    ],
+};
+const index = new Map();
+for (const entry of OFFICIAL_PRICE_SNAPSHOT.entries) {
+    for (const id of [entry.id, ...(entry.aliases ?? [])]) {
+        const key = id.toLowerCase();
+        if (index.has(key))
+            throw new Error(`Duplicate official price ID: ${id}`);
+        index.set(key, entry);
+    }
+}
+/**
+ * Resolves exact manufacturer IDs through common gateway wrappers. It never
+ * performs substring or model-name matching, so similarly named variants do
+ * not silently inherit a different model's price.
+ */
+export function officialPrice(model) {
+    const id = model.id.toLowerCase().replace(/@default$/, "");
+    const candidates = [id];
+    const slash = id.lastIndexOf("/");
+    if (slash >= 0)
+        candidates.push(id.slice(slash + 1));
+    const dot = id.lastIndexOf(".");
+    if (dot >= 0)
+        candidates.push(id.slice(dot + 1));
+    for (const candidate of candidates) {
+        const entry = index.get(candidate);
+        if (entry)
+            return entry;
+    }
+    return undefined;
+}

package/dist/source.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import type { OpenCodeClient, SessionInfo } from "@opencode/client";
-import type { Price, UsageMessage } from "./usage.js";
+import type { PriceCatalog, UsageMessage } from "./usage.js";
 export type Session = Pick<SessionInfo, "id" | "parentID" | "fork" | "model" | "location">;
 export interface Page<T> {
     data: T[];
@@ -8,10 +8,10 @@ export interface Page<T> {
         previous?: string | null;
     };
 }
-/** Active model of the viewed session: price tiers, display label and context window. */
+/** Active model of the viewed session plus the location's current resolved price catalog. */
 export interface ActiveModel {
     label: string;
-    prices: readonly Price[];
+    catalog: PriceCatalog;
     context?: number | undefined;
 }
 export interface UsageSource {

package/dist/source.js CHANGED Viewed

@@ -1,3 +1,4 @@
+import { modelKey } from "./usage.js";
 export function createSource(client) {
     return {
         session: (sessionID, signal) => client.session.get({ sessionID }, { signal }),
@@ -7,12 +8,16 @@ export function createSource(client) {
         async model(session, signal) {
             const input = { location: session.location };
             const selected = session.model;
+            const models = (await client.model.list(input, { signal })).data;
             const model = selected
-                ? (await client.model.list(input, { signal })).data.find(m => m.providerID === selected.providerID && m.id === selected.id)
-                : (await client.model.default(input, { signal })).data;
+                ? models.find(m => m.providerID === selected.providerID && m.id === selected.id)
+                : (await client.model.default(input, { signal })).data ?? undefined;
+            const catalog = new Map(models.map(value => [modelKey(value), value.cost]));
+            if (model && !catalog.has(modelKey(model)))
+                catalog.set(modelKey(model), model.cost);
             return {
                 label: model ? `${model.providerID}/${model.id}` : selected ? `${selected.providerID}/${selected.id}` : "Default model",
-                prices: model?.cost ?? [],
+                catalog,
                 context: model?.limit?.context,
             };
         },

package/dist/usage.d.ts CHANGED Viewed

@@ -29,10 +29,19 @@ export interface Price {
         write?: number;
     };
 }
+export interface ModelRef {
+    providerID: string;
+    id: string;
+    variant?: string;
+}
+export type PriceCatalog = ReadonlyMap<string, readonly Price[]>;
+export declare const modelKey: (model: Pick<ModelRef, "providerID" | "id">) => string;
 export interface UsageMessage {
     id: string;
     type: string;
     status?: string;
+    model?: ModelRef;
+    cost?: number;
     tokens?: TokenInput;
     time?: {
         created: number;
@@ -73,13 +82,16 @@ export declare function estimate(tokens: Tokens, prices?: readonly Price[]): {
     cost: number;
     defaultPrice: boolean;
 };
-export declare function summarize(messages: Iterable<UsageMessage>, prices?: readonly Price[]): {
+export type CostStatus = "empty" | "complete" | "partial" | "unavailable";
+/** Prices every call with its recorded model. OpenCode's resolved price wins;
+ * the built-in manufacturer snapshot is used only when that price is incomplete. */
+export declare function summarize(messages: Iterable<UsageMessage>, catalog?: PriceCatalog): {
     tokens: Tokens;
     total: number;
     cacheRate: number;
     steps: number;
     cost: number;
-    defaultPrice: boolean;
+    costStatus: CostStatus;
 };
 export type Summary = ReturnType<typeof summarize>;
 export interface ContextUsage {

package/dist/usage.js CHANGED Viewed

@@ -1,3 +1,5 @@
+import { officialPrice } from "./pricing.js";
+export const modelKey = (model) => `${model.providerID}/${model.id}`;
 const safe = (n) => n !== undefined && Number.isFinite(n) ? Math.max(0, n) : 0;
 export function normalize(tokens) {
     return {
@@ -7,29 +9,33 @@ export function normalize(tokens) {
 }
 export const incoming = (t) => t.input + t.cache.read + t.cache.write;
 export const total = (t) => incoming(t) + t.output + t.reasoning;
-// Matches OpenCode 2.0.9 SessionUsage.calculateCost: thresholds are exclusive.
+// Matches OpenCode 2.0.11 SessionUsage.calculateCost: thresholds are exclusive.
 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];
     return {
-        cost: (tokens.input * safe(rates[0]) + (tokens.output + tokens.reasoning) * safe(rates[1])
-            + tokens.cache.read * safe(rates[2]) + tokens.cache.write * safe(rates[3])) / 1_000_000,
-        defaultPrice: rates.some(rate => rate === undefined || !Number.isFinite(rate) || rate < 0),
+        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
+            && (rate === undefined || !Number.isFinite(rate) || rate < 0))),
     };
 }
-export function summarize(messages, prices = []) {
+/** Prices every call with its recorded model. OpenCode's resolved price wins;
+ * the built-in manufacturer snapshot is used only when that price is incomplete. */
+export function summarize(messages, catalog = new Map()) {
     const tokens = normalize();
     let cost = 0;
     let steps = 0;
-    let defaultPrice = prices.length === 0;
+    let knownCosts = 0;
+    let missingCosts = 0;
     for (const message of messages) {
         // Matches OpenCode SessionStats: every assistant message is one step,
         // with or without reported usage; compaction and user messages are not.
         if (message.type === "assistant")
             steps++;
-        if ((message.type !== "assistant" && message.type !== "compaction") || !message.tokens)
+        if (message.type !== "assistant" && message.type !== "compaction")
             continue;
         const t = normalize(message.tokens);
         tokens.input += t.input;
@@ -37,13 +43,28 @@ export function summarize(messages, prices = []) {
         tokens.reasoning += t.reasoning;
         tokens.cache.read += t.cache.read;
         tokens.cache.write += t.cache.write;
-        const value = estimate(t, prices);
-        cost += value.cost;
-        defaultPrice ||= value.defaultPrice;
+        if (total(t) === 0)
+            continue;
+        if (!message.model) {
+            missingCosts++;
+            continue;
+        }
+        let value = estimate(t, catalog.get(modelKey(message.model)));
+        if (value.defaultPrice)
+            value = estimate(t, officialPrice(message.model)?.prices);
+        if (value.defaultPrice)
+            missingCosts++;
+        else {
+            cost += value.cost;
+            knownCosts++;
+        }
     }
+    const costStatus = missingCosts > 0
+        ? knownCosts > 0 ? "partial" : "unavailable"
+        : knownCosts > 0 ? "complete" : "empty";
     return {
         tokens, total: total(tokens), cacheRate: incoming(tokens) ? tokens.cache.read / incoming(tokens) : 0,
-        steps, cost, defaultPrice,
+        steps, cost, costStatus,
     };
 }
 const usableLimit = (value) => value !== undefined && Number.isFinite(value) && value > 0;
@@ -85,8 +106,12 @@ export function usageRows(summary, context, performance) {
     if (t && t.cache.write > 0)
         rows.push(["Cache Write", number(t.cache.write)]);
     rows.push(["Cache Rate", summary ? `${(summary.cacheRate * 100).toFixed(1)}%` : "—"], ["Total", number(summary?.total)]);
-    if (summary && summary.cost > 0)
+    if (summary?.costStatus === "complete")
         rows.push(["Cost", formatCost(summary.cost)]);
+    if (summary?.costStatus === "partial")
+        rows.push(["Cost", `${formatCost(summary.cost)} · partial`]);
+    if (summary?.costStatus === "unavailable")
+        rows.push(["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 ADDED Viewed

@@ -0,0 +1,279 @@
+# 内置官方价格快照
+v0.3.0 在 OpenCode 当前模型目录没有可用于某条消息的完整价格时，使用本页所列的厂商官方标准价补全。快照核验于 **2026-09-23**，共收录 71 个模型，金额均为美元 / 100 万 token。
+## 规则
+- 每条 assistant 与 compaction 消息按自身记录的 `providerID`、模型 ID 和 token 用量分别计算。
+- OpenCode 当前解析出的完整适用价格优先；仅当适用档位或本次实际使用的 token 类别缺价时，整条消息回退到内置价格，不混用两套费率。
+- 网关模型只通过精确厂商 ID、精确别名及已知包装格式匹配，例如 `openai/gpt-5.6-luna`、`us.anthropic.claude-opus-5` 和 `claude-opus-5@default`。不按相似名称猜测。
+- 目录首版只新增 2026-03-22 至 2026-09-22 发布、具有明确标准 token 价格的模型。后续版本只限制新增窗口，已经收录的模型不会因超过半年而自动删除。
+- 采用标准同步 API 的公开价，不含 Batch、Flex、Fast/Priority、区域溢价、网关加价、免费额度、企业折扣、工具费和税费，因此 Cost 仍是估算，不代表账单。
+- 任一有用量消息仍无法定价时，已知小计标记 `partial`；全部无法定价时显示 `—`。明确零价才显示 `$0.00`。
+- 促销价按核验日官网显示的费率收录（如 `gpt-5.6-sol`、MiniMax-M3 的"长期 5 折"标价），不用划线原价。
+## OpenAI
+来源：[OpenAI API Pricing](https://developers.openai.com/api/docs/pricing)
+| 模型 | 发布日期 | Input | Output | Cache Read | Cache Write | 长上下文档位 |
+| --- | --- | ---: | ---: | ---: | ---: | --- |
+| `gpt-5.5` | 2026-04-23 | 5 | 30 | 0.5 | — | ≥272K：10 / 45 / 1 / — |
+| `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-terra` | 2026-07-09 | 2 | 12 | 0.2 | 2.5 | ≥272K：4 / 18 / 0.4 / 5 |
+| `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-6-astra` | 2026-09-04 | 10 | 50 | 1 | 12.5 | ≥272K：20 / 75 / 2 / 25 |
+| `chat-latest`（别名 `gpt-chat-latest`） | 2026-05-05 | 5 | 30 | 0.5 | — | — |
+`gpt-5.6-sol` 的当前标准价是限期促销价；快照采用核验日官网显示的费率。`chat-latest` 是官方 ChatGPT SKU，OpenRouter 上的 `gpt-chat-latest` 作为精确别名指向同一条目。
+## Anthropic
+来源：[Claude Platform Pricing](https://platform.claude.com/docs/en/about-claude/pricing)
+| 模型 | 发布日期 | 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-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-fable-5-1` | 2026-09-01 | 10 | 50 | 0.25 | 12.5 |
+Cache Write 采用官方 5 分钟写入价。OpenCode 的聚合字段不区分 5 分钟与 1 小时 TTL，无法从历史消息可靠应用 1 小时写入价。OpenRouter 的 `claude-opus-4.7`、`claude-opus-4.8` 圆点写法注册为对应条目的精确别名。
+## 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 |
+这里只收录 Standard tier。Contributor tier 虽然也是官方 API，但以允许 Meta 使用提示词和回答训练为条件的折扣方案，不属于标准价；官方没有 cache write token 价。
+## 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-*-fast`、`gpt-5.6-*-pro`、`gpt-6-astra-pro`、MiniMax priority 档）不是标准同步价。
+- 免费模型（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 版本、`inclusionai/ling-3.0-*`、`bytedance-seed/seed-2.0-code` 等。这些模型目前只能查到 OpenRouter、AtlasCloud、DeepInfra 等网关或第三方报价，不能据此推断厂商标准价。
+- 浮动别名（`-latest` 指针与 OpenRouter `~` 前缀条目）随底层模型漂移，不收录固定价。
+- 只有询价、托管部署价或无法从厂商官方页面确认标准 token 价格的模型不猜价。

package/docs/verification.md CHANGED Viewed

@@ -2,14 +2,14 @@
 ## 未发布（SDK 2.0.11）
-验证日期：2026-09-22。环境：macOS、Node.js v22.23.2、npm 10.9.8、OpenCode v2.0.11；`@opencode/plugin`、`@opencode/client`、`@opencode/schema` 和 `@opencode/theme` 均精确锁定为 2.0.11。
+验证日期：2026-09-23。环境：macOS、Node.js v22.23.2、npm 10.9.8、OpenCode v2.0.11；`@opencode/plugin`、`@opencode/client`、`@opencode/schema` 和 `@opencode/theme` 均精确锁定为 2.0.11。
 ### 自动化检查
 | 检查 | 结果 |
 | --- | --- |
 | `npm run typecheck` | 通过 |
-| `npm test` | 32 项通过 |
+| `npm test` | 43 项通过 |
 | `npm run build` | 通过，输出 ESM 与类型声明 |
 | `npm run test:smoke` | 通过，使用实际 `.tgz` 安装产物和真实 OpenCode 2.0.11 |
@@ -19,13 +19,15 @@ 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 模型目录中的完整适用价格优先；适用档位或实际使用类别缺价时，整条消息回退到内置官方快照，不拼接两套费率。官方目录测试锁定 71 个 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`、官方 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`。
 ### 真实 OpenCode 集成
-隔离 smoke 测试确认打包插件可加载；空会话隐藏无数据行并显示 `Steps 0`；在独立会话已经开始慢速流后，同一 TUI 切换过去会立即显示 `TPS ~…` 与 TTFT，完成后变为无 `~` 的精确 TPS；既有 token、上下文与费用刷新、真实子代理全树累计、会话局部上下文及模型切换验证均继续通过。Steps 在真实集成中断言为：首条 assistant 完成后 `Steps 1` 且行序位于 Context 与 Input 之间；真实子代理场景下根视图与子代理视图均为 `Steps 4`（父 3 条 + 子 1 条），而被查看会话自身仍为 1，确认 Steps 随整棵树累计、上下文保持会话局部。测试产物保存在 `/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/token-usage-smoke-423PQP`。
+隔离 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`。
 ### 验证边界
-当前 SDK 2.0.11 与宿主 2.0.11 的组合已完整验证。验证时机器默认宿主已是 2.0.12，因此 smoke 使用校验完整性的官方 `@opencode/cli-darwin-arm64@2.0.11` 隔离二进制，没有放宽宿主版本断言。2.0.9 和 2.0.10 宿主的历史验证记录保留在下方，但升级 SDK 后未重新执行这两个旧宿主的打包矩阵。后续升级 SDK 或宿主时，仍需重新核对分叉副本、compaction 排序及 step/delta 事件语义。
+当前 SDK 2.0.11 与宿主 2.0.11 的组合已完整验证。验证时机器默认宿主已是 2.0.14，因此 smoke 使用校验完整性的官方 `@opencode/cli-darwin-arm64@2.0.11` 隔离二进制，没有放宽宿主版本断言。2.0.9 和 2.0.10 宿主的历史验证记录保留在下方，但升级 SDK 后未重新执行这两个旧宿主的打包矩阵。后续升级 SDK 或宿主时，仍需重新核对消息模型字段、模型价格结构、分叉副本、compaction 排序及 step/delta 事件语义。官方价格是 2026-09-23 的版本内快照，采用标准同步 API 公开价；DeepSeek 峰谷计费采用峰值最高价作为保守上界。网关溢价、区域价、免费额度、折扣、工具费及无法由五类 token 表示的计费不在估算内，详细范围见 `docs/pricing.md`。
 ## v0.2.1（TPS 与 TTFT）
@@ -95,7 +97,7 @@ npm 发布前检查确认无作用域名称 `opencode-token-usage` 已由其他
 - 宿主 `Ws` 还使用 `session.revert` 作为搜索上界；本版本不读取 revert 状态，回退会话的取值可能与宿主不同。
 - 分母使用被查看会话的**活动模型**，而不是产生该用量的消息自身记录的模型；会话中途切换模型后两者可能不同。
 - Cost 与上下文上限使用同一活动模型解析规则，同样不使用消息自身记录的 `model` 字段：混合模型会话的 Cost 按查看时活动模型统一重算，不等于各模型实际账单之和。真实集成只验证了单夹具模型下的价格重算，混合模型的失真未单独断言。
-- 不显示进度条，上下文百分比与用量同行；行值加标签约 31 字符，窄侧边栏可能换行，响应式布局留待 v0.3.0。
+- 不显示进度条，上下文百分比与用量同行；行值加标签约 31 字符，窄侧边栏可能换行，响应式布局与进度条留待后续版本。
 - 夹具 `usage-test/large` 的上下文上限改为 32,000 以便观测模型切换，`usage-test/small` 保持 128,000。
 ## v0.1.0

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@chenlongapps/opencode-token-usage",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Session-tree token usage, live performance, context window and estimated cost for OpenCode 2",
   "keywords": [
     "opencode",
@@ -30,6 +30,7 @@
     "dist",
     "README.md",
     "ROADMAP.md",
+    "docs/pricing.md",
     "docs/verification.md",
     "LICENSE"
   ],