@chenlongapps/opencode-token-usage 0.4.3 → 0.4.5

package/README.md

@@ -34,7 +34,7 @@ Alternatively, add the package to your project's `opencode.json` or `opencode.js
 ```
 
 > [!NOTE]
-> Requires Node.js 22+. OpenCode 2.0.9, 2.0.10, and 2.0.11 have been verified across project releases. The current SDK 2.0.11 build has been reverified on OpenCode 2.0.11.
+> Requires Node.js 22+. OpenCode 2.0.9, 2.0.10, and 2.0.11 have been verified across project releases. The current SDK 2.0.11 build has been reverified on OpenCode 2.0.11 and 2.0.22.
 
 Restart OpenCode after installation. The panel appears in the native sidebar when `session.sidebar` is set to `auto` and the terminal is wide enough. OpenCode hides the sidebar in subagent views, so the plugin keeps one live summary line above the composer with Context, Total, Cost, and TPS. Click the line to open the full statistics in a centered dialog. Press Escape or click **esc** to close it; closing the dialog does not interrupt the subagent.
 
@@ -74,7 +74,7 @@ Costs follow the sidebar's pricing and `partial`/unavailable/free conventions. I
 | `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 |
 | `Est. 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 `~` |
+| `TPS` | Generation throughput for `Output + Reasoning` across the tree. While streaming, it estimates recent observable text, reasoning-summary and tool-input deltas (UTF-8 bytes / 4) over a short sliding window after the first delta, excluding pre-first-token waiting, and marks the value with `~`. APIs such as OpenAI Responses do not expose complete hidden reasoning tokens in real time, so live values cannot represent hidden reasoning throughput. After completion it uses provider-reported Output and Reasoning tokens and removes `~` |
 | `TTFT` | Average time to first token across measurable assistant steps in the tree |
 
 #### Behavior
@@ -86,6 +86,7 @@ Costs follow the sidebar's pricing and `partial`/unavailable/free conventions. I
 - `Est. Cost` prices every message with its recorded model. A complete non-zero price resolved by OpenCode takes precedence. If OpenCode reports a complete zero price, a complete first-party snapshot price overrides it; incomplete prices fall back for the whole message without mixing rates.
 - The checked-in fallback snapshot is generated from [models.dev](https://models.dev/api.json) using only reviewed first-party provider/model families; a small set of manufacturer-verified exceptions is kept separately. It covers priced text models, without downloading prices while the plugin runs. Gateway models match exact manufacturer IDs, documented aliases, and known wrappers; only a terminal `-free` or `:free` can be removed for a second exact lookup.
 - Confirmed free usage displays `$0.00`; unavailable prices display `—`; known subtotals with unpriced messages are marked `partial`. The snapshot excludes gateway markups, regional premiums, unlisted discounts, non-text billing, tool fees, and taxes, so Est. Cost is not a provider bill. See [price sources and limitations](docs/pricing.md).
+- Live `TPS` with `~` is an estimate from recent observable deltas after the first delta over a ~2s sliding window with light smoothing; it excludes TTFT and hidden-reasoning waits. Without `~` it is exact provider-reported `Output + Reasoning` throughput. No model-specific multipliers or hidden-reasoning guesses are applied.
 - Initial read failures display `Unavailable`. Later failures retain the last complete snapshot, display `Not updated`, and retry automatically.
 
 ### Development
@@ -98,12 +99,24 @@ npm run build
 npm run test:smoke
 ```
 
-The [price update workflow](.github/workflows/update-prices.yml) checks models.dev every day at 03:17 UTC (or on demand via **Run workflow**). No snapshot diff means no pull request; a diff that passes typecheck, tests, build, and pack validation opens or updates one review-only PR containing `src/prices.generated.ts`. Enable **Allow GitHub Actions to create and approve pull requests** under repository Actions settings. PRs created with `GITHUB_TOKEN` do not trigger a second CI run, so the update workflow runs the checks before opening the PR. Nothing is merged or published automatically.
+The [price update workflow](.github/workflows/update-prices.yml) checks models.dev every day at 22:00 UTC (or on demand via **Run workflow** on `main`). No snapshot diff means no release. Changes within the reviewed first-party source allowlist pass typecheck, tests, build, and pack validation, then automatically bump the patch version (for example, `0.4.4` → `0.4.5`), commit only `src/prices.generated.ts`, `package.json`, and `package-lock.json`, and atomically push `main` and its version tag. The workflow creates a GitHub Release and explicitly dispatches [`publish.yml`](.github/workflows/publish.yml) on that tag to publish via npm Trusted Publishing/OIDC; no long-lived npm token is needed. GitHub Actions must be allowed to push to `main` and create tags, and npm must trust `publish.yml` with permission to run `npm publish`.
+
+Failed validation never bumps the version. An unfinished tagged price release is retried with the same version before checking new prices; registry outages are not treated as missing versions. Publishing skips versions already on npm, prevents moving `latest` backwards, and verifies registry visibility after publication. Manufacturer/source allowlist additions, aliases, and manually verified price exceptions still require human review. See the [release guide](docs/releasing.md) for setup and retries.
 
 For a manual refresh, run `npm run prices:update` in a networked environment, review the generated diff and exceptions, then run the checks above. Builds and plugin refreshes do not contact models.dev.
 
 `test:smoke` packages the real artifact and validates loading, refreshes, `/usage`, subagent aggregation, per-message pricing, first-party 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.
 
+By default, smoke uses `opencode` from `PATH`. Stable OpenCode 2 versions from 2.0.9 onward can run; a host not yet verified with the current SDK prints a warning and continues through the actual compatibility checks. Passing the version check alone does not establish compatibility. The SDK dependencies remain pinned independently of your local CLI updates.
+
+To reproduce a baseline with a separately installed binary, without downgrading your normal installation:
+
+```bash
+OPENCODE_BIN=/absolute/path/to/opencode-2.0.11 npm run test:smoke
+```
+
+`OPENCODE_BIN` selects the same executable for the version check, isolated server, and TUI. Relative paths resolve from the directory where you run the command. The host version and selected binary are recorded in the smoke output and `result.json`; see the [verification record](docs/verification.md) for tested combinations.
+
 To load the plugin from source, build the project and add the repository's absolute path to `plugins` in the target project.
 
 ### Documentation

package/README.zh-CN.md

@@ -34,7 +34,7 @@ opencode plugin add @chenlongapps/opencode-token-usage
 ```
 
 > [!NOTE]
-> 需要 Node.js 22+。项目历次发布已验证 OpenCode 2.0.9、2.0.10 和 2.0.11；当前 SDK 2.0.11 构建已在 OpenCode 2.0.11 上重新验证。
+> 需要 Node.js 22+。项目历次发布已验证 OpenCode 2.0.9、2.0.10 和 2.0.11；当前 SDK 2.0.11 构建已在 OpenCode 2.0.11 和 2.0.22 上重新验证。
 
 安装后重启 OpenCode。终端足够宽且 `session.sidebar` 设为 `auto` 时，面板会显示在原生侧边栏中。OpenCode 在子代理视图中隐藏侧边栏，因此插件会在输入区上方保留一行实时摘要，显示 Context、Total、Cost 和 TPS。点击摘要可在居中弹窗中查看完整统计；按 Escape 或点击 **esc** 即可关闭，关闭弹窗不会中断子代理。
 
@@ -74,7 +74,7 @@ opencode plugin add @chenlongapps/opencode-token-usage
 | `Context` | 当前会话最后一次已完成压缩后的最新上下文用量，不随子树累计 |
 | `Steps` | 全树（含子代理）的 assistant 消息数，口径与 OpenCode 自带统计一致，compaction 与用户消息不计为 step |
 | `Est. Cost` | 按每条 assistant 与 compaction 消息实际模型估算的全树费用 |
-| `TPS` | 全树 `Output + Reasoning` 的生成速度；生成中的估算值带 `~` 标记 |
+| `TPS` | 全树 `Output + Reasoning` 的生成吞吐。请求进行中时，插件根据首个流式增量之后最近的可观察文本、reasoning summary 和工具输入流（UTF-8 字节数 / 4）按短时间滑动窗口估算输出速度，不包含首 token 前等待时间，并以 `~` 标记。OpenAI Responses 等 API 不会实时暴露完整的隐藏 reasoning token，因此实时值不能表示隐藏推理吞吐。请求完成后，插件使用服务端上报的 Output 与 Reasoning token 及时间信息计算精确 TPS，并移除 `~` 标记 |
 | `TTFT` | 全树中可测 assistant step 的平均首 token 时间 |
 
 #### 行为
@@ -86,6 +86,7 @@ opencode plugin add @chenlongapps/opencode-token-usage
 - `Est. Cost` 按每条消息记录的实际模型分别计算。OpenCode 当前解析出的完整非零价格优先；若 OpenCode 给出完整零价，且内置价格快照可以完整计价，则采用快照价格。价格不完整时整条消息回退，不混用两套费率。
 - 内置回退快照从 [models.dev](https://models.dev/api.json) 生成，只采用审核过的原厂 Provider 与自家模型系列；少量经原厂核实的例外单独维护。快照覆盖有价格的文本模型，插件运行时不下载价格。网关模型通过精确原厂 ID、明确别名和已知包装格式匹配；只有终尾 `-free` 或 `:free` 会在再次精确查找前移除。
 - 确认免费时显示 `$0.00`；价格不可用时显示 `—`；只有部分消息可计算时在已知小计后标注 `partial`。快照不含网关加价、区域溢价、未列明的折扣、非文本计费、工具费和税费；Est. Cost 是估算而非账单。覆盖范围、来源和限制见[价格来源与限制](docs/pricing.md)。
+- 带 `~` 的实时 `TPS` 是首个流式增量之后约 2 秒滑动窗口内可观察增量的估算值（带轻度平滑），不包含 TTFT 与隐藏推理等待；不带 `~` 时为服务端上报的 `Output + Reasoning` 精确吞吐。不做模型专属倍率，也不猜测隐藏 reasoning token。
 - 首次读取失败显示 `Unavailable`；后续失败保留上次完整快照、标注 `Not updated` 并自动重试。
 
 ### 开发
@@ -98,12 +99,24 @@ npm run build
 npm run test:smoke
 ```
 
-[价格更新工作流](.github/workflows/update-prices.yml) 每天 UTC 03:17 检查 models.dev，也可通过 **Run workflow** 手动触发。快照无变化就不创建 PR；有变化且通过类型检查、测试、构建和打包检查时，只对 `src/prices.generated.ts` 创建或更新同一个待审 PR。需在仓库 Actions 设置中启用 **Allow GitHub Actions to create and approve pull requests**。使用 `GITHUB_TOKEN` 创建的 PR 不会再次触发 CI，因此更新工作流会先完成检查；不会自动合并或发布。
+[价格更新工作流](.github/workflows/update-prices.yml) 每天 UTC 22:00 检查 models.dev，也可在 `main` 上通过 **Run workflow** 手动触发。快照无变化就不发布。经审核的原厂来源白名单内有变化时，先通过类型检查、测试、构建和打包检查，再自动升级 patch 版本（例如 `0.4.4` → `0.4.5`），只提交 `src/prices.generated.ts`、`package.json` 和 `package-lock.json`，并原子推送 `main` 与版本标签。工作流创建 GitHub Release，显式触发该标签上的 [`publish.yml`](.github/workflows/publish.yml)，通过 npm Trusted Publishing/OIDC 发布，无需长期 npm token。仓库必须允许 GitHub Actions 推送 `main` 和创建标签；npm 必须信任 `publish.yml` 并允许执行 `npm publish`。
+
+验证失败不会升版本。已打标签但未完成的自动价格发布会优先重试同一版本，再检查新价格；registry 故障不会被当作版本不存在。发布时跳过 npm 已有版本、防止 `latest` 倒退，并在发布后核验 registry 中的版本。新增原厂／来源白名单、别名及人工核实的价格例外仍需人工审核。配置和重试方法见[发布说明](docs/releasing.md)。
 
 手动更新时，在联网的维护环境运行 `npm run prices:update`，审阅生成文件及例外差异，再执行上述检查。构建和插件刷新不会请求 models.dev。
 
 `test:smoke` 会打包真实产物，并在隔离的 OpenCode 与本地模拟提供商中验证加载、刷新、`/usage`、子代理累计、逐消息计价、原厂价格补全、模型切换、TPS 和 TTFT。它需要 Python 3、可用的本地端口和 npm 网络访问，不会修改现有 OpenCode 配置或调用付费模型。
 
+默认使用 `PATH` 中的 `opencode`。OpenCode 2.0.9 及之后的稳定版 2.x 可以运行；尚未与当前 SDK 验证的宿主会输出警告，然后继续实际兼容性检查。仅通过版本检查不代表兼容性已验证。SDK 依赖仍独立锁定，不随本机 CLI 更新而自动升级。
+
+如需用独立安装的二进制复现基准，而不降级日常使用的安装：
+
+```bash
+OPENCODE_BIN=/absolute/path/to/opencode-2.0.11 npm run test:smoke
+```
+
+`OPENCODE_BIN` 为版本检查、隔离服务端和 TUI 统一选择同一个可执行文件。相对路径以执行命令时的目录为基准解析。smoke 输出和 `result.json` 会记录宿主版本与所选二进制；已测试组合见[验证记录](docs/verification.md)。
+
 从源码加载时，先构建项目，再将仓库绝对路径加入目标项目的 `plugins`。
 
 ### 文档

package/ROADMAP.md

@@ -111,9 +111,3 @@ Steps  1,234
 
 ## 待解决问题
 
-### 后续评估与维护
-
-* [ ] GPT-6 Luna 实际约为 30 tok/s，但在 实时统计中仅显示 ~1.5 tok/s，而且这个数字长期不变化。初步怀疑是 Responses API 的原因。
-* [ ] TPS 的实时计算：当前为近似值，后续考虑通过更精确的算法计算。
-* [ ] 在定时或发布前验证中运行打包产物的真实宿主 smoke 测试；升级 OpenCode／SDK 时重新核对消息排序、分叉副本、compaction、事件与价格语义。
-* [ ] 同步仓库指南中的当前包版本与测试数量，避免 `AGENTS.md` 的状态说明落后于实际工程。

package/dist/performance.d.ts

@@ -17,6 +17,16 @@ export interface PerformanceEvent {
     id?: string;
     created?: number;
 }
+export interface StreamSample {
+    time: number;
+    bytes: number;
+}
+export declare const LIVE_WINDOW_MS = 2000;
+export declare const LIVE_EWMA_ALPHA = 0.35;
+export declare const LIVE_BYTES_PER_TOKEN = 4;
+/** Raw live throughput from one step's recent observable deltas. */
+export declare function estimatedLiveTps(samples: readonly StreamSample[]): number | undefined;
+export declare function smoothLiveTps(previous: number | undefined, raw: number): number;
 export interface PreparedPerformance {
     tps?: number;
     ttftSum: number;

package/dist/performance.js

@@ -1,4 +1,31 @@
 import { normalize } from "./usage.js";
+export const LIVE_WINDOW_MS = 2_000;
+export const LIVE_EWMA_ALPHA = 0.35;
+export const LIVE_BYTES_PER_TOKEN = 4;
+/** Raw live throughput from one step's recent observable deltas. */
+export function estimatedLiveTps(samples) {
+    if (samples.length < 2)
+        return undefined;
+    const first = samples[0];
+    const last = samples[samples.length - 1];
+    const duration = last.time - first.time;
+    if (!Number.isFinite(duration) || duration <= 0)
+        return undefined;
+    let bytes = 0;
+    for (const sample of samples) {
+        if (!Number.isFinite(sample.time) || !Number.isFinite(sample.bytes) || sample.bytes < 0)
+            return undefined;
+        bytes += sample.bytes;
+    }
+    if (bytes <= 0)
+        return undefined;
+    return (bytes / LIVE_BYTES_PER_TOKEN) / (duration / 1_000);
+}
+export function smoothLiveTps(previous, raw) {
+    if (previous === undefined || !Number.isFinite(previous))
+        return raw;
+    return previous * (1 - LIVE_EWMA_ALPHA) + raw * LIVE_EWMA_ALPHA;
+}
 const finite = (value) => typeof value === "number" && Number.isFinite(value);
 function historicalFirst(message) {
     const started = message.time?.created;
@@ -187,7 +214,7 @@ export class PerformanceMonitor {
             if (this.active.has(key))
                 return false;
             this.active.set(key, {
-                messageID, sessionID, started: data.started, bytes: 0, events: new Set(),
+                messageID, sessionID, started: data.started, bytes: 0, samples: [], events: new Set(),
             });
             return false;
         }
@@ -229,7 +256,12 @@ export class PerformanceMonitor {
                 delete sample.expiresAt;
             this.scheduleCleanup();
         }
-        step.bytes += new TextEncoder().encode(data.delta).byteLength;
+        const sampleBytes = new TextEncoder().encode(data.delta).byteLength;
+        step.bytes += sampleBytes;
+        step.samples.push({ time: event.created, bytes: sampleBytes });
+        const cutoff = event.created - LIVE_WINDOW_MS;
+        while (step.samples.length > 0 && step.samples[0].time < cutoff)
+            step.samples.shift();
         step.last = Math.max(step.last ?? event.created, event.created);
         if (step.first === undefined) {
             step.first = event.created;
@@ -269,19 +301,28 @@ export class PerformanceMonitor {
         const sessions = new Set(sessionIDs);
         const samples = [...this.observed.values()].filter(sample => sessions.has(sample.sessionID));
         const result = performanceWithObservations(prepared, samples);
-        let bytes = 0;
-        let duration = 0;
+        // Live throughput covers only observable deltas after the first one, over a
+        // short sliding window. TTFT keeps the started -> first wait separately, and
+        // completed provider usage still replaces this estimate via reconcile().
+        let weighted = 0;
+        let durationTotal = 0;
         for (const step of this.active.values()) {
-            if (!sessions.has(step.sessionID) || step.reconciledAt !== undefined || step.bytes <= 0)
+            if (!sessions.has(step.sessionID) || step.reconciledAt !== undefined)
+                continue;
+            const raw = estimatedLiveTps(step.samples);
+            if (raw === undefined)
                 continue;
-            const last = step.streamed ?? step.last;
-            if (!finite(last) || last <= step.started)
+            const first = step.samples[0];
+            const last = step.samples[step.samples.length - 1];
+            const duration = last.time - first.time;
+            if (!finite(duration) || duration <= 0)
                 continue;
-            bytes += step.bytes;
-            duration += last - step.started;
+            step.liveTps = smoothLiveTps(step.liveTps, raw);
+            weighted += step.liveTps * duration;
+            durationTotal += duration;
         }
-        if (bytes > 0 && duration > 0) {
-            result.tps = (bytes / 4) / (duration / 1_000);
+        if (durationTotal > 0) {
+            result.tps = weighted / durationTotal;
             result.tpsEstimated = true;
         }
         return result;

package/dist/prices.generated.d.ts

@@ -1,5 +1,5 @@
 export declare const GENERATED_PRICE_SNAPSHOT: {
-    readonly verified: "2026-09-29";
+    readonly verified: "2026-10-07";
     readonly source: "https://models.dev/api.json";
     readonly entries: readonly [{
         readonly providerID: "ai21";
@@ -824,6 +824,14 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             readonly output: 0;
         }];
         readonly released: "2026-06-09";
+    }, {
+        readonly providerID: "cohere";
+        readonly id: "north-small-translate-09-2026";
+        readonly prices: readonly [{
+            readonly input: 0;
+            readonly output: 0;
+        }];
+        readonly released: "2026-09-09";
     }, {
         readonly providerID: "deepseek";
         readonly id: "deepseek-flash";
@@ -861,10 +869,10 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
         readonly providerID: "deepseek";
         readonly id: "deepseek-v4-pro";
         readonly prices: readonly [{
-            readonly input: 0.435;
-            readonly output: 0.87;
+            readonly input: 0.66;
+            readonly output: 1.98;
             readonly cache: {
-                readonly read: 0.003625;
+                readonly read: 0.022;
             };
         }];
         readonly released: "2026-08-12";
@@ -1418,6 +1426,17 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2024-11-01";
+    }, {
+        readonly providerID: "mistral";
+        readonly id: "mistral-large-4";
+        readonly prices: readonly [{
+            readonly input: 0.68;
+            readonly output: 2.09;
+            readonly cache: {
+                readonly read: 0.07;
+            };
+        }];
+        readonly released: "2026-10-06";
     }, {
         readonly providerID: "mistral";
         readonly id: "mistral-large-latest";
@@ -1703,6 +1722,14 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2026-06-04";
+    }, {
+        readonly providerID: "nvidia";
+        readonly id: "nvidia/nemotron-3.5-content-safety";
+        readonly prices: readonly [{
+            readonly input: 0;
+            readonly output: 0;
+        }];
+        readonly released: "2026-06-04";
     }, {
         readonly providerID: "nvidia";
         readonly id: "nvidia/nemotron-3.5-lightning-30b-a3b";
@@ -1781,6 +1808,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-04-14";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-4.1-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 3.5;
+            readonly output: 14;
+            readonly cache: {
+                readonly read: 0.875;
+            };
+        }];
+        readonly released: "2025-04-14";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-4.1-mini";
@@ -1792,6 +1831,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-04-14";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-4.1-mini-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 0.7;
+            readonly output: 2.8;
+            readonly cache: {
+                readonly read: 0.175;
+            };
+        }];
+        readonly released: "2025-04-14";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-4.1-nano";
@@ -1803,6 +1854,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-04-14";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-4.1-nano-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 0.2;
+            readonly output: 0.8;
+            readonly cache: {
+                readonly read: 0.05;
+            };
+        }];
+        readonly released: "2025-04-14";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-4o";
@@ -1822,6 +1885,15 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             readonly output: 15;
         }];
         readonly released: "2024-05-13";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-4o-2024-05-13-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 8.75;
+            readonly output: 26.25;
+        }];
+        readonly released: "2024-05-13";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-4o-2024-08-06";
@@ -1844,6 +1916,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2024-11-20";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-4o-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 4.25;
+            readonly output: 17;
+            readonly cache: {
+                readonly read: 2.125;
+            };
+        }];
+        readonly released: "2024-05-13";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-4o-mini";
@@ -1855,6 +1939,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2024-07-18";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-4o-mini-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 0.25;
+            readonly output: 1;
+            readonly cache: {
+                readonly read: 0.125;
+            };
+        }];
+        readonly released: "2024-07-18";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-5";
@@ -1866,6 +1962,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-08-07";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-5-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 2.5;
+            readonly output: 20;
+            readonly cache: {
+                readonly read: 0.25;
+            };
+        }];
+        readonly released: "2025-08-07";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-5-mini";
@@ -1877,6 +1985,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-08-07";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-5-mini-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 0.45;
+            readonly output: 3.6;
+            readonly cache: {
+                readonly read: 0.045;
+            };
+        }];
+        readonly released: "2025-08-07";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-5-nano";
@@ -1907,6 +2027,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-11-13";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-5.1-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 2.5;
+            readonly output: 20;
+            readonly cache: {
+                readonly read: 0.25;
+            };
+        }];
+        readonly released: "2025-11-13";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-5.2";
@@ -1929,6 +2061,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-12-11";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-5.2-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 3.5;
+            readonly output: 28;
+            readonly cache: {
+                readonly read: 0.35;
+            };
+        }];
+        readonly released: "2025-12-11";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-5.2-pro";
@@ -1959,6 +2103,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2026-02-05";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-5.3-codex-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 3.5;
+            readonly output: 28;
+            readonly cache: {
+                readonly read: 0.35;
+            };
+        }];
+        readonly released: "2026-02-05";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-5.3-codex-spark";
@@ -2397,6 +2553,47 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2026-09-22";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-6.1-sol";
+        readonly prices: readonly [{
+            readonly input: 2;
+            readonly output: 10;
+            readonly cache: {
+                readonly read: 0.1;
+                readonly write: 2.5;
+            };
+        }, {
+            readonly input: 4;
+            readonly output: 15;
+            readonly cache: {
+                readonly read: 0.2;
+                readonly write: 5;
+            };
+            readonly tier: {
+                readonly type: "context";
+                readonly size: 272000;
+            };
+        }];
+        readonly released: "2026-09-29";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "gpt-6.1-sol-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 4;
+            readonly output: 20;
+            readonly cache: {
+                readonly read: 0.2;
+                readonly write: 5;
+            };
+        }, {
+            readonly tier: {
+                readonly type: "context";
+                readonly size: 272000;
+            };
+        }];
+        readonly released: "2026-09-29";
     }, {
         readonly providerID: "openai";
         readonly id: "gpt-daybreak-blue-latest";
@@ -2462,6 +2659,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-04-16";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "o3-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 3.5;
+            readonly output: 14;
+            readonly cache: {
+                readonly read: 0.875;
+            };
+        }];
+        readonly released: "2025-04-16";
     }, {
         readonly providerID: "openai";
         readonly id: "o3-mini";
@@ -2492,6 +2701,18 @@ export declare const GENERATED_PRICE_SNAPSHOT: {
             };
         }];
         readonly released: "2025-04-16";
+    }, {
+        readonly providerID: "openai";
+        readonly id: "o4-mini-fast";
+        readonly providers: readonly ["openai"];
+        readonly prices: readonly [{
+            readonly input: 2;
+            readonly output: 8;
+            readonly cache: {
+                readonly read: 0.5;
+            };
+        }];
+        readonly released: "2025-04-16";
     }, {
         readonly providerID: "perplexity";
         readonly id: "sonar";

package/dist/prices.generated.js

@@ -1,5 +1,5 @@
 export const GENERATED_PRICE_SNAPSHOT = {
-    verified: "2026-09-29",
+    verified: "2026-10-07",
     source: "https://models.dev/api.json",
     entries: [
         { "providerID": "ai21", "id": "jamba-large", "prices": [{ "input": 2, "output": 8 }], "released": "2025-07-01" },
@@ -84,10 +84,11 @@ export const GENERATED_PRICE_SNAPSHOT = {
         { "providerID": "cohere", "id": "command-r7b-12-2024", "prices": [{ "input": 0.0375, "output": 0.15 }], "released": "2024-12-02" },
         { "providerID": "cohere", "id": "command-r7b-arabic-02-2025", "prices": [{ "input": 0.0375, "output": 0.15 }], "released": "2025-02-27" },
         { "providerID": "cohere", "id": "north-mini-code-1-0", "prices": [{ "input": 0, "output": 0 }], "released": "2026-06-09" },
+        { "providerID": "cohere", "id": "north-small-translate-09-2026", "prices": [{ "input": 0, "output": 0 }], "released": "2026-09-09" },
         { "providerID": "deepseek", "id": "deepseek-flash", "prices": [{ "input": 0.15, "output": 0.6, "cache": { "read": 0.003 } }], "released": "2026-09-10" },
         { "providerID": "deepseek", "id": "deepseek-v4-flash", "prices": [{ "input": 0.15, "output": 0.6, "cache": { "read": 0.003 } }], "released": "2026-09-10" },
         { "providerID": "deepseek", "id": "deepseek-v4-flash-vision-exp", "prices": [{ "input": 0.15, "output": 0.6, "cache": { "read": 0.003 } }], "released": "2026-09-10" },
-        { "providerID": "deepseek", "id": "deepseek-v4-pro", "prices": [{ "input": 0.435, "output": 0.87, "cache": { "read": 0.003625 } }], "released": "2026-08-12" },
+        { "providerID": "deepseek", "id": "deepseek-v4-pro", "prices": [{ "input": 0.66, "output": 1.98, "cache": { "read": 0.022 } }], "released": "2026-08-12" },
         { "providerID": "google", "id": "deep-research-max-preview-04-2026", "prices": [{ "input": 2, "output": 12, "cache": { "read": 0.2 } }, { "input": 4, "output": 18, "cache": { "read": 0.4 }, "tier": { "type": "context", "size": 200000 } }], "released": "2026-04-21" },
         { "providerID": "google", "id": "deep-research-preview-04-2026", "prices": [{ "input": 2, "output": 12, "cache": { "read": 0.2 } }, { "input": 4, "output": 18, "cache": { "read": 0.4 }, "tier": { "type": "context", "size": 200000 } }], "released": "2026-04-21" },
         { "providerID": "google", "id": "gemini-2.5-computer-use-preview-10-2025", "prices": [{ "input": 1.25, "output": 10 }, { "input": 2.5, "output": 15, "tier": { "type": "context", "size": 200000 } }], "released": "2025-10-07" },
@@ -135,6 +136,7 @@ export const GENERATED_PRICE_SNAPSHOT = {
         { "providerID": "mistral", "id": "ministral-8b-latest", "prices": [{ "input": 0.1, "output": 0.1 }], "released": "2024-10-01" },
         { "providerID": "mistral", "id": "mistral-large-2411", "prices": [{ "input": 2, "output": 6 }], "released": "2024-11-18" },
         { "providerID": "mistral", "id": "mistral-large-2512", "prices": [{ "input": 0.5, "output": 1.5, "cache": { "read": 0.05 } }], "released": "2024-11-01" },
+        { "providerID": "mistral", "id": "mistral-large-4", "prices": [{ "input": 0.68, "output": 2.09, "cache": { "read": 0.07 } }], "released": "2026-10-06" },
         { "providerID": "mistral", "id": "mistral-large-latest", "prices": [{ "input": 0.5, "output": 1.5, "cache": { "read": 0.05 } }], "released": "2024-11-01" },
         { "providerID": "mistral", "id": "mistral-medium-2505", "prices": [{ "input": 0.4, "output": 2 }], "released": "2025-05-07" },
         { "providerID": "mistral", "id": "mistral-medium-2508", "prices": [{ "input": 0.4, "output": 2 }], "released": "2025-08-12" },
@@ -167,6 +169,7 @@ export const GENERATED_PRICE_SNAPSHOT = {
         { "providerID": "nvidia", "id": "nvidia/nemotron-3-nano-omni-30b-a3b-reasoning", "prices": [{ "input": 0, "output": 0 }], "released": "2026-04-28" },
         { "providerID": "nvidia", "id": "nvidia/nemotron-3-super-120b-a12b", "prices": [{ "input": 0.2, "output": 0.8 }], "released": "2026-03-11" },
         { "providerID": "nvidia", "id": "nvidia/nemotron-3-ultra-550b-a55b", "prices": [{ "input": 0.5, "output": 2.5, "cache": { "read": 0.15 } }], "released": "2026-06-04" },
+        { "providerID": "nvidia", "id": "nvidia/nemotron-3.5-content-safety", "prices": [{ "input": 0, "output": 0 }], "released": "2026-06-04" },
         { "providerID": "nvidia", "id": "nvidia/nemotron-3.5-lightning-30b-a3b", "prices": [{ "input": 0, "output": 0 }], "released": "2026-08-11" },
         { "providerID": "nvidia", "id": "nvidia/nemotron-content-safety-reasoning-4b", "prices": [{ "input": 0, "output": 0 }], "released": "2026-01-22" },
         { "providerID": "nvidia", "id": "nvidia/nemotron-mini-4b-instruct", "prices": [{ "input": 0, "output": 0 }], "released": "2024-08-21" },
@@ -176,23 +179,34 @@ export const GENERATED_PRICE_SNAPSHOT = {
         { "providerID": "openai", "id": "gpt-4", "prices": [{ "input": 30, "output": 60 }], "released": "2023-11-06" },
         { "providerID": "openai", "id": "gpt-4-turbo", "prices": [{ "input": 10, "output": 30 }], "released": "2023-11-06" },
         { "providerID": "openai", "id": "gpt-4.1", "prices": [{ "input": 2, "output": 8, "cache": { "read": 0.5 } }], "released": "2025-04-14" },
+        { "providerID": "openai", "id": "gpt-4.1-fast", "providers": ["openai"], "prices": [{ "input": 3.5, "output": 14, "cache": { "read": 0.875 } }], "released": "2025-04-14" },
         { "providerID": "openai", "id": "gpt-4.1-mini", "prices": [{ "input": 0.4, "output": 1.6, "cache": { "read": 0.1 } }], "released": "2025-04-14" },
+        { "providerID": "openai", "id": "gpt-4.1-mini-fast", "providers": ["openai"], "prices": [{ "input": 0.7, "output": 2.8, "cache": { "read": 0.175 } }], "released": "2025-04-14" },
         { "providerID": "openai", "id": "gpt-4.1-nano", "prices": [{ "input": 0.1, "output": 0.4, "cache": { "read": 0.025 } }], "released": "2025-04-14" },
+        { "providerID": "openai", "id": "gpt-4.1-nano-fast", "providers": ["openai"], "prices": [{ "input": 0.2, "output": 0.8, "cache": { "read": 0.05 } }], "released": "2025-04-14" },
         { "providerID": "openai", "id": "gpt-4o", "prices": [{ "input": 2.5, "output": 10, "cache": { "read": 1.25 } }], "released": "2024-05-13" },
         { "providerID": "openai", "id": "gpt-4o-2024-05-13", "prices": [{ "input": 5, "output": 15 }], "released": "2024-05-13" },
+        { "providerID": "openai", "id": "gpt-4o-2024-05-13-fast", "providers": ["openai"], "prices": [{ "input": 8.75, "output": 26.25 }], "released": "2024-05-13" },
         { "providerID": "openai", "id": "gpt-4o-2024-08-06", "prices": [{ "input": 2.5, "output": 10, "cache": { "read": 1.25 } }], "released": "2024-08-06" },
         { "providerID": "openai", "id": "gpt-4o-2024-11-20", "prices": [{ "input": 2.5, "output": 10, "cache": { "read": 1.25 } }], "released": "2024-11-20" },
+        { "providerID": "openai", "id": "gpt-4o-fast", "providers": ["openai"], "prices": [{ "input": 4.25, "output": 17, "cache": { "read": 2.125 } }], "released": "2024-05-13" },
         { "providerID": "openai", "id": "gpt-4o-mini", "prices": [{ "input": 0.15, "output": 0.6, "cache": { "read": 0.075 } }], "released": "2024-07-18" },
+        { "providerID": "openai", "id": "gpt-4o-mini-fast", "providers": ["openai"], "prices": [{ "input": 0.25, "output": 1, "cache": { "read": 0.125 } }], "released": "2024-07-18" },
         { "providerID": "openai", "id": "gpt-5", "prices": [{ "input": 1.25, "output": 10, "cache": { "read": 0.125 } }], "released": "2025-08-07" },
+        { "providerID": "openai", "id": "gpt-5-fast", "providers": ["openai"], "prices": [{ "input": 2.5, "output": 20, "cache": { "read": 0.25 } }], "released": "2025-08-07" },
         { "providerID": "openai", "id": "gpt-5-mini", "prices": [{ "input": 0.25, "output": 2, "cache": { "read": 0.025 } }], "released": "2025-08-07" },
+        { "providerID": "openai", "id": "gpt-5-mini-fast", "providers": ["openai"], "prices": [{ "input": 0.45, "output": 3.6, "cache": { "read": 0.045 } }], "released": "2025-08-07" },
         { "providerID": "openai", "id": "gpt-5-nano", "prices": [{ "input": 0.05, "output": 0.4, "cache": { "read": 0.005 } }], "released": "2025-08-07" },
         { "providerID": "openai", "id": "gpt-5-pro", "prices": [{ "input": 15, "output": 120 }], "released": "2025-10-06" },
         { "providerID": "openai", "id": "gpt-5.1", "prices": [{ "input": 1.25, "output": 10, "cache": { "read": 0.125 } }], "released": "2025-11-13" },
+        { "providerID": "openai", "id": "gpt-5.1-fast", "providers": ["openai"], "prices": [{ "input": 2.5, "output": 20, "cache": { "read": 0.25 } }], "released": "2025-11-13" },
         { "providerID": "openai", "id": "gpt-5.2", "prices": [{ "input": 1.75, "output": 14, "cache": { "read": 0.175 } }], "released": "2025-12-11" },
         { "providerID": "openai", "id": "gpt-5.2-chat-latest", "prices": [{ "input": 1.75, "output": 14, "cache": { "read": 0.175 } }], "released": "2025-12-11" },
+        { "providerID": "openai", "id": "gpt-5.2-fast", "providers": ["openai"], "prices": [{ "input": 3.5, "output": 28, "cache": { "read": 0.35 } }], "released": "2025-12-11" },
         { "providerID": "openai", "id": "gpt-5.2-pro", "prices": [{ "input": 21, "output": 168 }], "released": "2025-12-11" },
         { "providerID": "openai", "id": "gpt-5.3-chat-latest", "prices": [{ "input": 1.75, "output": 14, "cache": { "read": 0.175 } }], "released": "2026-03-03" },
         { "providerID": "openai", "id": "gpt-5.3-codex", "prices": [{ "input": 1.75, "output": 14, "cache": { "read": 0.175 } }], "released": "2026-02-05" },
+        { "providerID": "openai", "id": "gpt-5.3-codex-fast", "providers": ["openai"], "prices": [{ "input": 3.5, "output": 28, "cache": { "read": 0.35 } }], "released": "2026-02-05" },
         { "providerID": "openai", "id": "gpt-5.3-codex-spark", "prices": [{ "input": 1.75, "output": 14, "cache": { "read": 0.175 } }], "released": "2026-02-05" },
         { "providerID": "openai", "id": "gpt-5.4", "prices": [{ "input": 2.5, "output": 15, "cache": { "read": 0.25 } }, { "input": 5, "output": 22.5, "cache": { "read": 0.5 }, "tier": { "type": "context", "size": 272000 } }], "released": "2026-03-05" },
         { "providerID": "openai", "id": "gpt-5.4-fast", "providers": ["openai"], "prices": [{ "input": 5, "output": 30, "cache": { "read": 0.5 } }, { "tier": { "type": "context", "size": 272000 } }], "released": "2026-03-05" },
@@ -217,14 +231,18 @@ export const GENERATED_PRICE_SNAPSHOT = {
         { "providerID": "openai", "id": "gpt-6-luna-fast", "providers": ["openai"], "prices": [{ "input": 0.2, "output": 1, "cache": { "read": 0.02, "write": 0.25 } }, { "tier": { "type": "context", "size": 272000 } }], "released": "2026-09-22" },
         { "providerID": "openai", "id": "gpt-6-sol", "prices": [{ "input": 2, "output": 10, "cache": { "read": 0.2, "write": 2.5 } }, { "input": 4, "output": 15, "cache": { "read": 0.4, "write": 5 }, "tier": { "type": "context", "size": 272000 } }], "released": "2026-09-22" },
         { "providerID": "openai", "id": "gpt-6-sol-fast", "providers": ["openai"], "prices": [{ "input": 4, "output": 20, "cache": { "read": 0.4, "write": 5 } }, { "tier": { "type": "context", "size": 272000 } }], "released": "2026-09-22" },
+        { "providerID": "openai", "id": "gpt-6.1-sol", "prices": [{ "input": 2, "output": 10, "cache": { "read": 0.1, "write": 2.5 } }, { "input": 4, "output": 15, "cache": { "read": 0.2, "write": 5 }, "tier": { "type": "context", "size": 272000 } }], "released": "2026-09-29" },
+        { "providerID": "openai", "id": "gpt-6.1-sol-fast", "providers": ["openai"], "prices": [{ "input": 4, "output": 20, "cache": { "read": 0.2, "write": 5 } }, { "tier": { "type": "context", "size": 272000 } }], "released": "2026-09-29" },
         { "providerID": "openai", "id": "gpt-daybreak-blue-latest", "prices": [{ "input": 4, "output": 20, "cache": { "read": 0.4, "write": 5 } }, { "input": 8, "output": 30, "cache": { "read": 0.8, "write": 10 }, "tier": { "type": "context", "size": 272000 } }], "released": "2026-08-07" },
         { "providerID": "openai", "id": "gpt-daybreak-red-latest", "prices": [{ "input": 12.5, "output": 75, "cache": { "read": 1.25, "write": 15.625 } }], "released": "2026-08-07" },
         { "providerID": "openai", "id": "o1", "prices": [{ "input": 15, "output": 60, "cache": { "read": 7.5 } }], "released": "2024-12-05" },
         { "providerID": "openai", "id": "o1-pro", "prices": [{ "input": 150, "output": 600 }], "released": "2025-03-19" },
         { "providerID": "openai", "id": "o3", "prices": [{ "input": 2, "output": 8, "cache": { "read": 0.5 } }], "released": "2025-04-16" },
+        { "providerID": "openai", "id": "o3-fast", "providers": ["openai"], "prices": [{ "input": 3.5, "output": 14, "cache": { "read": 0.875 } }], "released": "2025-04-16" },
         { "providerID": "openai", "id": "o3-mini", "prices": [{ "input": 1.1, "output": 4.4, "cache": { "read": 0.55 } }], "released": "2024-12-20" },
         { "providerID": "openai", "id": "o3-pro", "prices": [{ "input": 20, "output": 80 }], "released": "2025-06-10" },
         { "providerID": "openai", "id": "o4-mini", "prices": [{ "input": 1.1, "output": 4.4, "cache": { "read": 0.275 } }], "released": "2025-04-16" },
+        { "providerID": "openai", "id": "o4-mini-fast", "providers": ["openai"], "prices": [{ "input": 2, "output": 8, "cache": { "read": 0.5 } }], "released": "2025-04-16" },
         { "providerID": "perplexity", "id": "sonar", "prices": [{ "input": 1, "output": 1 }], "released": "2024-01-01" },
         { "providerID": "perplexity", "id": "sonar-deep-research", "prices": [{ "input": 2, "output": 8, "reasoning": 3 }], "released": "2025-02-01" },
         { "providerID": "perplexity", "id": "sonar-pro", "prices": [{ "input": 3, "output": 15 }], "released": "2024-01-01" },

package/dist/pricing.d.ts

@@ -14,7 +14,7 @@ export interface OfficialPriceEntry {
 /** Checked-in data: updating prices is explicit, not a network request at
  * startup, during a refresh, or during an npm build. */
 export declare const OFFICIAL_PRICE_SNAPSHOT: {
-    verified: "2026-09-29";
+    verified: "2026-10-07";
     source: "https://models.dev/api.json";
     entries: OfficialPriceEntry[];
 };

package/docs/pricing.md

@@ -4,7 +4,9 @@
 
 ## 更新方式
 
-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，故上述检查在更新工作流内完成。
+GitHub Actions [价格更新工作流](../.github/workflows/update-prices.yml) 每天 UTC 22:00 从 models.dev 检查一次，也可从 Actions 页面在 `main` 上手动触发。生成快照没有差异就结束，不会因检查日期或 API 中未导入的元数据变化发布新版本。白名单内的快照有变化（包含新增、移除和重新定价）时，先运行类型检查、测试、构建和 `npm pack --dry-run`，全部通过后自动升级 patch 版本，只提交 `src/prices.generated.ts`、`package.json`、`package-lock.json`，原子推送 `main` 与版本标签，再创建 GitHub Release 并显式触发 `publish.yml` 自动发布 npm。
+
+验证失败不升版本；并发修改 `main` 会令原子推送失败，不覆盖他人提交或留下孤立的远端标签。已推送但 npm 未完成的自动价格版本会先重试原标签，不再递增版本。npm 查询只有明确的 404 才视为版本不存在，网络错误会停止流程。工作流摘要记录快照条数与新增／移除／变化数量；最终 npm 结果见发布工作流。仓库推送权限与 npm Trusted Publishing 配置见[发布说明](releasing.md)。
 
 本地手动更新可在联网的维护环境中运行：
 
@@ -15,7 +17,7 @@ npm test
 npm run build
 ```
 
-审阅生成文件与 `overrides.ts` 的差异后提交。更新脚本只请求 `https://models.dev/api.json`，从人工确认的**原厂 Provider + 自家模型系列**提取公开的文本模型价格；原厂平台上托管的其他厂商模型、OpenRouter 等网关报价、地域性/订阅制费率不作为回退价格来源。API 不标注模型的真实厂商，因此新增原厂或新系列需要维护者先审核并扩充 `ORIGINAL_PROVIDERS`，不能按相似名称自动猜测。
+本地更新时，审阅生成文件与 `overrides.ts` 的差异后提交。更新脚本只请求 `https://models.dev/api.json`，从人工确认的**原厂 Provider + 自家模型系列**提取公开的文本模型价格；原厂平台上托管的其他厂商模型、OpenRouter 等网关报价、地域性/订阅制费率不作为回退价格来源。自动化不修改来源白名单、别名或人工例外。API 不标注模型的真实厂商，因此新增原厂或新系列需要维护者先审核并扩充 `ORIGINAL_PROVIDERS`，不能按相似名称自动猜测。
 
 `src/prices.generated.ts` 是随 npm 包发布的离线快照：插件启动、刷新、构建、打包和测试均不请求 models.dev。`src/aliases.ts` 只记录无法按已知包装形式解决的厂商 slug 与精确模型 ID 差异；`src/overrides.ts` 只记录有原厂来源的缺失 SKU、已核实的例外费率及无法直接使用的 API 字段。普通价格变动通过重新生成快照维护，不往别名或例外表中增加常规型号。
 

package/docs/verification.md

@@ -1,5 +1,49 @@
 # 验证记录
 
+## 2026-10-05 · 自动价格 patch 与 npm 发布链路（本地验证）
+
+环境：macOS、Node.js v22.23.2、插件包仍为 0.4.4，SDK 仍锁定 2.0.11。本轮只修改价格更新与发布自动化、测试和文档，未更新真实价格快照、未推送提交或标签、未创建 GitHub Release，也未实际发布 npm。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 101 项通过，新增 16 项价格刷新／发布回归验证 |
+| `npm run build` | 通过 |
+| `npm pack --dry-run` | 通过，执行真实 `prepack` 构建 |
+| `npm publish --dry-run` | 通过，完整执行类型检查、101 项测试与构建；未写入 registry |
+| GitHub 工作流 | 通过 actionlint 1.7.12、YAML 解析和 bash 语法检查；检查工具来自官方发行且校验 SHA-256 |
+| npm 只读查询 | 当前 `0.4.4` 已存在；发布状态为 `published=true`，价格恢复状态为 `retry=false` |
+
+发布测试在临时仓库和本地 bare remote 中实际运行 `npm version patch`、受限提交、带注释标签及 `git push --atomic`，验证 `0.4.4 → 0.4.5` 的两个 package 文件同步、仅提交三个允许文件、版本钩子不执行，以及并发更新 `main` 时不覆盖远端提交或留下孤立标签。另覆盖未完成价格版本按原标签重试、禁止每日任务发布未完成的手动版本、已占用版本／标签、registry 故障与错误响应、锁文件不一致、`latest` 倒退和发布可见性延迟。
+
+价格刷新覆盖无变化时跨日期保持字节不变、忽略未导入的上游元数据，以及新增、移除、零价、缓存、Reasoning 和档位差异。独立临时副本将全部生成模型的已有费率改为另一组数字，重新运行价格与用量测试，确认正常调价不再被写死的旧费率断言拦住；算法固定夹具和人工价格例外的精确断言仍保留。
+
+真实 GitHub 定时任务、机器人推送／Release／dispatch 和 npm OIDC 写入尚未执行；需将这些变更提交到默认分支，并满足发布说明中的权限及 Trusted Publisher 配置后，在实际工作流中验证。此次未重新运行 OpenCode TUI smoke，之前已验证的宿主结果保留在下方。
+
+## 2026-10-02 · smoke 宿主版本策略与兼容性
+
+环境：macOS、Node.js v22.23.2、插件包 0.4.3。OpenCode SDK 仍精确锁定 2.0.11，未随本机 CLI 升级；本机默认宿主为 Homebrew 安装的 OpenCode 2.0.22。旧版基准使用校验 npm SHA-512 完整性的官方 `@opencode/cli-darwin-arm64@2.0.11` 独立二进制，没有降级或修改日常安装。
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run typecheck` | 通过 |
+| `npm test` | 85 项通过，含 6 项 smoke 版本与二进制选择回归测试 |
+| `npm run build` | 通过，两版 smoke 的 `npm pack` 均执行真实构建 |
+| `npm run test:smoke`，默认宿主 2.0.22 | 完整通过 |
+| `OPENCODE_BIN=… npm run test:smoke`，独立宿主 2.0.11 | 完整通过 |
+
+版本检查不再把补丁版本列为白名单：允许稳定版 `>=2.0.9 <3.0.0` 运行实际集成检查。尚未与当前 SDK 验证的宿主会输出警告，但不被提前拒绝；当前已验证列表为 2.0.11、2.0.22。低于最低版本、其他主版本以及无法解析的稳定版输出仍会失败。版本检查通过本身不代表兼容性已验证。`OPENCODE_BIN` 统一用于版本探测、隔离服务端与 TUI；相对路径在切换到临时项目之前解析，结果文件记录实际宿主版本与所选二进制。
+
+本轮保留全部原有 token、费用、上下文、布局、子代理、TPS 与 TTFT 断言，并修正测试夹具的时序：实时场景提供多段、300ms 间隔的模拟文本，避免短片段被宿主批处理合并或跨出 2s TPS 窗口；模拟流在 TUI 观察到实时指标后才结束。隔离 CLI 配置关闭持久标签页，避免不同 TUI 进程复用其他会话的焦点；详细模式滚动持续等待真实目标行可见，避免旧宿主在重新排版前处理 End。压缩模拟响应使用宿主要求的结构化摘要格式。现有 OpenCode 配置未修改，也未调用付费模型。
+
+两版真实宿主新增验证：分叉为独立根，继承 assistant ID 保留 `_序号` 后缀；继承消息仍占被查看会话的 Context，但不重复累计用量或 Steps；分叉自己的调用单独计价。真实压缩投影为 `status === "completed"`，`order: "asc"` 的完整历史仍保留压缩前消息，压缩后没有新 assistant 时隐藏旧 Context，新消息恢复 Context，compaction 不计为 assistant step。原有全树 Total 5,080、成本 `$0.00504`、上下文上限 128,000 → 32,000 与原厂回退价 `$0.000149` 均保持通过。
+
+验证产物：
+- OpenCode 2.0.22：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-93KAN2`。
+- OpenCode 2.0.11：`/private/var/folders/rw/bmx6c8hd737brl55m0_ff_b80000gn/T/opencode/token-usage-smoke-p0SsRF`。
+
+产物包含 `result.json`、终端捕获、已隐藏服务器密码的日志，以及流式事件、生成中的消息和压缩消息诊断文件。2.0.9、2.0.10 的历史记录保留在下方，本轮未重新执行这两个宿主；后续版本仍需实际运行 smoke，不能据版本范围宣称兼容。
+
 ## 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。

package/package.json

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