@chenlongapps/opencode-token-usage 0.4.1 → 0.4.3

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;
@@ -83,6 +85,20 @@ export declare function estimate(tokens: Tokens, prices?: readonly Price[]): {
     defaultPrice: boolean;
 };
 export type CostStatus = "empty" | "complete" | "partial" | "unavailable";
+export type PriceSource = "OpenCode" | "Built-in snapshot";
+export interface AppliedRates {
+    source: PriceSource;
+    lowerExclusive: number | undefined;
+    upperInclusive: number | undefined;
+    calls: number;
+    rates: {
+        input: number | undefined;
+        output: number | undefined;
+        reasoning: number | undefined;
+        cacheRead: number | undefined;
+        cacheWrite: number | undefined;
+    };
+}
 /** Prices every call with its recorded model. A complete non-zero OpenCode
  * price wins; a complete snapshot price can replace a complete OpenCode zero.
  * Incomplete OpenCode prices fall back to the snapshot as a whole. */
@@ -102,6 +118,8 @@ export interface ModelCost {
     tokens: number;
     cost: number;
     costStatus: CostStatus;
+    appliedRates: readonly AppliedRates[];
+    unpricedCalls: number;
 }
 /** Groups the same per-message estimates used by the tree total; unlabelled calls stay visible. */
 export declare function summarizeModels(messages: Iterable<UsageMessage>, catalog?: PriceCatalog): ModelCost[];
@@ -114,11 +132,15 @@ export interface ContextDetails {
     usage: ContextUsage;
     tokens: Tokens;
 }
-export declare function contextDetails(messages: readonly UsageMessage[], limit?: number): ContextDetails | undefined;
-export declare function contextUsage(messages: readonly UsageMessage[], limit?: number): ContextUsage | undefined;
+export declare function contextDetails(messages: readonly UsageMessage[], limit?: number, revertMessageID?: string): ContextDetails | undefined;
+export declare function contextUsage(messages: readonly UsageMessage[], limit?: number, revertMessageID?: string): ContextUsage | undefined;
 export declare function formatTokens(value: number): string;
 export declare const formatCost: (value: number) => string;
 export declare function formatEstimatedCost(cost: number, status: CostStatus): string | undefined;
+/** Per-million rates need more precision than a rounded total cost. */
+export declare function formatRate(value: number | undefined): string;
+export declare function formatRateTier(value: Pick<AppliedRates, "lowerExclusive" | "upperInclusive">): string;
+export declare function rateRows(value: AppliedRates): readonly (readonly [string, string])[];
 /** Compact display for scan-first views: 812, 139.4K, 3.70M. Detailed views keep formatTokens. */
 export declare function formatCompact(value: number): string;
 /** Splits a percentage into filled and empty cell counts for a plain-text bar. */

package/dist/usage.js

@@ -10,12 +10,15 @@ 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.11 SessionUsage.calculateCost: thresholds are exclusive.
-export function estimate(tokens, prices = []) {
+function selectedPrice(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 tier ?? prices.find(p => !p.tier);
+}
+export function estimate(tokens, prices = []) {
+    const price = selectedPrice(tokens, prices);
+    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
@@ -25,13 +28,41 @@ export function estimate(tokens, prices = []) {
 function priceMessage(tokens, model, catalog) {
     if (!model)
         return undefined;
-    let value = estimate(tokens, catalog.get(modelKey(model)));
+    let prices = catalog.get(modelKey(model)) ?? [];
+    let source = "OpenCode";
+    let value = estimate(tokens, prices);
     if (value.defaultPrice || value.cost === 0) {
-        const snapshot = estimate(tokens, officialPrice(model)?.prices);
-        if (!snapshot.defaultPrice)
+        const fallback = officialPrice(model)?.prices ?? [];
+        const snapshot = estimate(tokens, fallback);
+        if (!snapshot.defaultPrice) {
             value = snapshot;
+            prices = fallback;
+            source = "Built-in snapshot";
+        }
     }
-    return value.defaultPrice ? undefined : value.cost;
+    const price = selectedPrice(tokens, prices);
+    return value.defaultPrice || !price ? undefined : { cost: value.cost, source, price, prices };
+}
+const validRate = (value) => value !== undefined && Number.isFinite(value) && value >= 0 ? value : undefined;
+function appliedRates(value) {
+    const lowerExclusive = value.price.tier?.size;
+    const next = value.prices.reduce((size, price) => {
+        const threshold = price.tier?.size;
+        return threshold !== undefined && threshold > (lowerExclusive ?? -Infinity) && threshold < size ? threshold : size;
+    }, Infinity);
+    return {
+        source: value.source,
+        lowerExclusive,
+        upperInclusive: Number.isFinite(next) ? next : undefined,
+        calls: 1,
+        rates: {
+            input: validRate(value.price.input),
+            output: validRate(value.price.output),
+            reasoning: validRate(value.price.reasoning ?? value.price.output),
+            cacheRead: validRate(value.price.cache?.read),
+            cacheWrite: validRate(value.price.cache?.write),
+        },
+    };
 }
 function costStatus(known, missing) {
     if (missing > 0)
@@ -69,7 +100,7 @@ export function summarize(messages, catalog = new Map()) {
         if (value === undefined)
             missingCosts++;
         else {
-            cost += value;
+            cost += value.cost;
             knownCosts++;
         }
     }
@@ -89,21 +120,33 @@ export function summarizeModels(messages, catalog = new Map()) {
         if (count === 0)
             continue;
         const key = message.model && modelKey(message.model);
-        const group = groups.get(key) ?? { calls: 0, tokens: 0, cost: 0, known: 0, missing: 0 };
+        const group = groups.get(key) ?? { calls: 0, tokens: 0, cost: 0, known: 0, missing: 0, rates: new Map() };
         group.calls++;
         group.tokens += count;
         const value = priceMessage(tokens, message.model, catalog);
         if (value === undefined)
             group.missing++;
         else {
-            group.cost += value;
+            group.cost += value.cost;
             group.known++;
+            const applied = appliedRates(value);
+            const rateKey = JSON.stringify([applied.source, applied.lowerExclusive, applied.upperInclusive, ...Object.values(applied.rates)]);
+            const existing = group.rates.get(rateKey);
+            if (existing)
+                existing.calls++;
+            else
+                group.rates.set(rateKey, applied);
         }
         groups.set(key, group);
     }
     return [...groups].map(([model, group]) => ({
         model: model ?? "Unknown model", calls: group.calls, tokens: group.tokens,
         cost: group.cost, costStatus: costStatus(group.known, group.missing),
+        appliedRates: [...group.rates.values()].sort((a, b) => {
+            const lowerA = a.lowerExclusive ?? -Infinity, lowerB = b.lowerExclusive ?? -Infinity;
+            return lowerA === lowerB ? a.source.localeCompare(b.source) : lowerA - lowerB;
+        }),
+        unpricedCalls: group.missing,
     })).sort((a, b) => b.cost - a.cost || a.model.localeCompare(b.model));
 }
 const usableLimit = (value) => value !== undefined && Number.isFinite(value) && value > 0;
@@ -111,18 +154,25 @@ const usableLimit = (value) => value !== undefined && Number.isFinite(value) &&
 // the last completed compaction carries the current context size. Running or failed
 // compactions do not reset it, and a last message without usage hides the row entirely
 // instead of falling back to pre-compaction history.
-export function contextDetails(messages, limit) {
+export function contextDetails(messages, limit, revertMessageID) {
     if (!usableLimit(limit))
         return undefined;
+    // The staged revert excludes its boundary message and every later message.
+    // Session.message.list is ascending; an absent marker can occur during a
+    // concurrent commit, in which case the ordered ID still gives the cutoff.
+    const found = revertMessageID ? messages.findIndex(message => message.id === revertMessageID) : -1;
+    const next = revertMessageID && found < 0 ? messages.findIndex(message => message.id > revertMessageID) : -1;
+    const end = !revertMessageID ? messages.length : found >= 0 ? found
+        : next >= 0 ? next : messages.length;
     let boundary = -1;
-    for (let index = messages.length - 1; index >= 0; index--) {
+    for (let index = end - 1; index >= 0; index--) {
         const message = messages[index];
         if (message.type === "compaction" && message.status === "completed") {
             boundary = index;
             break;
         }
     }
-    for (let index = messages.length - 1; index > boundary; index--) {
+    for (let index = end - 1; index > boundary; index--) {
         const message = messages[index];
         if (message.type !== "assistant" || !message.tokens)
             continue;
@@ -132,8 +182,8 @@ export function contextDetails(messages, limit) {
     }
     return undefined;
 }
-export function contextUsage(messages, limit) {
-    return contextDetails(messages, limit)?.usage;
+export function contextUsage(messages, limit, revertMessageID) {
+    return contextDetails(messages, limit, revertMessageID)?.usage;
 }
 export function formatTokens(value) {
     return Math.round(safe(value)).toLocaleString("en-US");
@@ -146,6 +196,33 @@ export function formatEstimatedCost(cost, status) {
         return "—";
     return `${formatCost(cost)}${status === "partial" ? " · partial" : ""}`;
 }
+/** Per-million rates need more precision than a rounded total cost. */
+export function formatRate(value) {
+    if (value === undefined || !Number.isFinite(value) || value < 0)
+        return "—";
+    if (value === 0)
+        return "$0.00";
+    const decimal = value.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 12 });
+    return `$${decimal === "0.00" ? value.toExponential(2) : decimal}`;
+}
+export function formatRateTier(value) {
+    const lower = value.lowerExclusive, upper = value.upperInclusive;
+    if (lower === undefined && upper === undefined)
+        return "all incoming sizes";
+    if (lower === undefined)
+        return `≤${formatTokens(upper)} incoming`;
+    if (upper === undefined)
+        return `>${formatTokens(lower)} incoming`;
+    return `>${formatTokens(lower)} to ≤${formatTokens(upper)} incoming`;
+}
+export function rateRows(value) {
+    const rates = value.rates;
+    return [
+        ["Input", formatRate(rates.input)], ["Output", formatRate(rates.output)],
+        ["Reasoning", formatRate(rates.reasoning)], ["Cache Read", formatRate(rates.cacheRead)],
+        ["Cache Write", formatRate(rates.cacheWrite)],
+    ];
+}
 /** Compact display for scan-first views: 812, 139.4K, 3.70M. Detailed views keep formatTokens. */
 export function formatCompact(value) {
     const n = safe(value);

package/docs/pricing.md

@@ -1,303 +1,37 @@
-# 内置官方价格快照
+# 内置原厂价格快照
 
-插件自 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、区域溢价、网关加价、企业折扣、工具费和税费，因此 Est. 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`。
+- `/usage` 的 By Model 详细模式仅列出有用量模型在**当前估算**中实际采用的费率，按来源与上下文档位归组，并显示每组调用数；无法定价的调用单独计数。五类费率均为美元／百万文本 token，缺少某类价格显示 `—`，Reasoning 未单列价格时沿用 Output。这里使用当前解析出的模型目录或打包快照重新估算历史消息，不代表消息生成时的实际价格或提供商账单。
+- 网关仅通过精确原厂 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 条目；Est. 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，故不计入 Est. 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,35 @@
 # 验证记录
 
+## v0.4.3 开发验证（`/usage` 模型费率展示）
+
+验证日期：2026-09-29。Node.js v22.23.2；SDK 2.0.11；真实宿主使用隔离的 `@opencode/cli-darwin-arm64@2.0.11`，包版本仍为 0.4.2。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 69 项通过 |
+| `npm run build` | 通过 |
+| `npm run test:smoke` | 通过，打包产物 + 真实 OpenCode 2.0.11 + 本地模拟提供商 |
+
+`/usage` 的 By Model 详细模式按逐消息估算实际采用的 OpenCode／内置快照价格及上下文档位列出五类 token 费率和调用数；紧凑模式不显示费率。自动化测试覆盖同模型跨来源／档位、Reasoning 沿用 Output、零价、缺价和 `partial`，并核对逐模型与全树费用。真实宿主测试验证 160 × 54 与 100 × 28 终端的展开／收起、48 × 28 终端的单列费率，以及内置快照回退来源；未向付费模型发送请求。测试产物保存在 `/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/token-usage-smoke-4RnnLf`。
+
+## v0.4.2（正确性与刷新性能）
+
+验证日期：2026-09-26。Node.js v22.23.2；SDK 2.0.11；真实宿主使用校验 npm SHA-512 完整性的 `@opencode/cli-darwin-arm64@2.0.11` 隔离二进制。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 67 项通过 |
+| `npm run build` | 通过 |
+| `npm run test:smoke` | 通过，打包产物 + 真实 OpenCode 2.0.11 + 本地模拟提供商；新增删除会话后的 context 清理断言 |
+
+TTFT 的快照先到、step 结束先到，以及缺少结束事件三种情况都有保留期清理测试；快照后继续收到 delta 时恢复实时估算，不提前丢失 TTFT。无关会话的创建与分叉不触发当前树刷新；新子代理仍立即纳入，切换会话仍隔离旧请求。流式性能更新使用每次完整快照预计算的历史基线，不再为每个 delta 遍历全部历史。
+
+大会话树测试包含根会话和 80 个子会话：首次完整读取 161 个消息页；单个子会话变化后的完整快照只重读该会话的 1 页，跨会话读取同时最多 4 个。每次仍重新枚举子会话，以发现新增与删除；分页失败或请求超时不会替换上一次完整快照，重试后恢复。被查看会话的 Context 按 `SessionInfo.revert.messageID` 截断有效消息，再应用最后一次已完成 compaction 边界；测试覆盖回退、重新生成和压缩，阶段性回退不会扣除已产生的全树费用。
+
+`context` 钩子累计记录 MCP 等待与存储写入耗时；MCP 名称缓存 30 秒，并在连接状态变化时失效。存储写入按会话顺序异步执行，模型请求不等待持久化完成；删除事件会等待该会话未完成的写入后清理 `context/<sessionID>`。自动化测试验证缓存、写入顺序、延迟与删除竞争；打包集成测试确认真实宿主删除会话后 RPC 返回空估算。
+
 ## v0.4.0（子代理用量浮窗）
 
 验证日期：2026-09-24。Node.js v22.23.2；SDK 2.0.11，隔离的真实 OpenCode 2.0.11 宿主。
@@ -218,3 +248,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.1",
+  "version": "0.4.3",
   "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"