dsh-plugin-billing 0.0.0-stage → 0.1.1

package/lib/prices.js

@@ -0,0 +1,202 @@
+/**
+ * 官方定价页的抓取与解析 —— **Host 侧唯一实现**。
+ *
+ * 两个入口共用它：
+ *
+ * - 设置里那个「立即更新」按钮（`POST /plugins/billing/prices/refresh`）；
+ * - 命令行 `node scripts/update-prices.mjs`（想看差异、想改仓库表时用）。
+ *
+ * 设计取向：**宁可失败也不写错钱**。解析只依赖几条可校验的结构事实，任一不成立就抛错、
+ * 一个字节都不写 —— 因为把"空闲价当高峰价"这类错误静默写进去，界面上的金额会一直错下去。
+ *
+ * 四条自校验：
+ *  1. 时段标签必须严格交替「空闲/高峰」共 3 轮；
+ *  2. 价格数字个数必须 = 6 × 模型数；
+ *  3. 每档必须满足「空闲 = 高峰的一半」（官方口径）；
+ *  4. 币种必须解析成人民币（误抓英文 USD 页会被拦下）。
+ */
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+
+/** 官方中文页：直接给人民币，不需要汇率换算。 */
+export const DEFAULT_PRICING_URL = 'https://api-docs.deepseek.com/zh-cn/quick_start/pricing';
+
+/** 三个计费档，顺序即官方页的行序。 */
+export const PRICE_BUCKETS = ['cacheHit', 'cacheMiss', 'output'];
+
+/** 旧模型名：官方注(1) 说它们由 V4.1-Flash 提供服务并按 Flash 价计费。 */
+export const LEGACY_ALIASES = ['deepseek-v4-flash', 'deepseek-v4-flash-vision-exp'];
+
+/** `$DSH_HOME`（默认 `~/.dsh`）。 */
+export function dshHome(env = process.env) {
+  const configured = env.DSH_HOME;
+  return configured !== undefined && configured.trim() !== '' ? configured.trim() : join(homedir(), '.dsh');
+}
+
+/** 本机覆盖文件路径 —— 按钮写的就是它（不动仓库里的表）。 */
+export function overridePath(env = process.env) {
+  return join(dshHome(env), 'billing-prices.json');
+}
+
+/** 去掉脚本/样式与标签，得到可比对的纯文本。 */
+export function toPlainText(html) {
+  return html
+    .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+    .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+    .replace(/<[^>]+>/g, '\n')
+    .replace(/&nbsp;/g, ' ')
+    .replace(/&amp;/g, '&')
+    .replace(/&lt;/g, '<')
+    .replace(/&gt;/g, '>')
+    .split('\n')
+    .map((line) => line.trim())
+    .filter((line) => line !== '')
+    .join('\n');
+}
+
+/**
+ * 从官方页纯文本里解析高峰价表。
+ * @param text - `toPlainText()` 的结果。
+ * @returns `{ models, peakPrices, offPeak, currency }`。
+ * @throws 结构不符合预期时抛出带原因的错误（调用方应把它原样显示给用户）。
+ */
+export function parsePricingText(text) {
+  const lines = text.split('\n');
+
+  // 1. 模型名：取价格区之前的表头，按出现顺序去重。
+  const priceAt = lines.findIndex((line) => /^价格/.test(line));
+  if (priceAt < 0) throw new Error('页面里找不到「价格」行 —— 官方页结构可能变了');
+  const models = [];
+  for (const line of lines.slice(0, priceAt)) {
+    for (const match of line.matchAll(/deepseek-[a-z0-9][a-z0-9-]*/g)) {
+      if (!models.includes(match[0])) models.push(match[0]);
+    }
+  }
+  if (models.length === 0) throw new Error('表头里没解析出模型名');
+  const width = models.length;
+
+  // 2. 价格区：从「价格」到「并发限制」。
+  const endAt = lines.findIndex((line, index) => index > priceAt && /^并发限制/.test(line));
+  const segment = lines.slice(priceAt, endAt < 0 ? lines.length : endAt);
+
+  // 3. 时段标签必须严格交替：空闲、高峰 × 3。
+  const periods = segment
+    .filter((line) => /^(空闲时段|高峰时段)/.test(line))
+    .map((line) => (/^空闲时段/.test(line) ? 'off' : 'peak'));
+  const expected = ['off', 'peak', 'off', 'peak', 'off', 'peak'];
+  if (periods.length !== expected.length || periods.some((value, index) => value !== expected[index])) {
+    throw new Error(
+      `时段标签不符合「空闲/高峰 × 3」的预期（实际 ${JSON.stringify(periods)}）—— 官方页结构变了，或官方调整了空闲价政策`,
+    );
+  }
+
+  // 4. 价格数字：按出现顺序取「数字 + 币种」。
+  const numbers = [];
+  let currency = null;
+  for (const line of segment) {
+    for (const match of line.matchAll(/([0-9]+(?:\.[0-9]+)?)\s*(元|美元)/g)) {
+      currency = currency ?? match[2];
+      if (match[2] !== currency) throw new Error('同一页里出现了两种币种，无法判断该用哪个');
+      numbers.push(Number(match[1]));
+    }
+  }
+  if (currency !== '元') {
+    throw new Error(`期望人民币（元），实际拿到 ${currency ?? '（没解析到价格）'} —— 请确认抓的是官方中文页`);
+  }
+  // 归一化：页面上的「元」只是解析用的字面量，存下来的必须是币种代码，
+  // 否则界面会显示成 "元/百万 tokens"。
+  const currencyCode = 'CNY';
+  if (numbers.length !== expected.length * width) {
+    throw new Error(`价格数字个数 ${numbers.length} ≠ 6 × 模型数 ${width} —— 官方页结构变了`);
+  }
+
+  // 5. 行序是「一行之内先各模型的值」，即 [时段行][模型]。
+  const offPeak = {};
+  const peakPrices = {};
+  PRICE_BUCKETS.forEach((bucket, bucketIndex) => {
+    const off = numbers.slice(bucketIndex * 2 * width, (bucketIndex * 2 + 1) * width);
+    const peak = numbers.slice((bucketIndex * 2 + 1) * width, (bucketIndex * 2 + 2) * width);
+    models.forEach((model, modelIndex) => {
+      offPeak[model] = offPeak[model] ?? {};
+      peakPrices[model] = peakPrices[model] ?? {};
+      offPeak[model][bucket] = off[modelIndex];
+      peakPrices[model][bucket] = peak[modelIndex];
+    });
+  });
+
+  // 6. 交叉验证官方口径「空闲 = 高峰的一半」。对不上说明行序被改，宁可失败也不写错钱。
+  for (const model of models) {
+    for (const bucket of PRICE_BUCKETS) {
+      const peak = peakPrices[model][bucket];
+      const off = offPeak[model][bucket];
+      if (!(peak > 0) || !(off > 0)) throw new Error(`${model}.${bucket} 价格缺失或非正数`);
+      if (Math.abs(off * 2 - peak) > 1e-9) {
+        throw new Error(
+          `${model}.${bucket} 不满足「空闲 = 高峰的一半」（空闲 ${off}，高峰 ${peak}）—— 行序或政策变了`,
+        );
+      }
+    }
+  }
+
+  return { models, peakPrices, offPeak, currency: currencyCode };
+}
+
+/** 补上旧模型名（按官方注(1)：与 Flash 同价）。 */
+export function withLegacyAliases(peakPrices) {
+  const flash = peakPrices['deepseek-flash'];
+  if (flash === undefined) return peakPrices;
+  const next = { ...peakPrices };
+  for (const alias of LEGACY_ALIASES) if (next[alias] === undefined) next[alias] = { ...flash };
+  return next;
+}
+
+/**
+ * 抓取 + 解析官方价（不落盘）。
+ * @param options - `{ url, fetchImpl }`。
+ * @returns `{ models, peakPrices, currency, url }`。
+ */
+export async function fetchOfficialPrices(options = {}) {
+  const url = options.url ?? DEFAULT_PRICING_URL;
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const response = await fetchImpl(url, {
+    headers: { 'user-agent': 'dsh-plugin-billing/update-prices' },
+  });
+  if (!response || response.ok !== true) {
+    throw new Error(`抓取官方定价页失败：HTTP ${response?.status ?? '无响应'}`);
+  }
+  const parsed = parsePricingText(toPlainText(await response.text()));
+  return { ...parsed, peakPrices: withLegacyAliases(parsed.peakPrices), url };
+}
+
+/**
+ * 抓取并写入**本机覆盖文件**（按钮/CLI 的 `--override` 都走这里）。
+ * @param options - `{ url, fetchImpl, target, env }`。
+ * @returns `{ models, peakPrices, source, path, currency }`。
+ */
+export async function refreshPrices(options = {}) {
+  const fetched = await fetchOfficialPrices(options);
+  const today = new Date().toISOString().slice(0, 10);
+  const source = `DeepSeek 官方定价页 · ${today} 抓取`;
+  const target = options.target ?? overridePath(options.env);
+  mkdirSync(dirname(target), { recursive: true });
+  writeFileSync(
+    target,
+    `${JSON.stringify(
+      { source, sourceUrl: fetched.url, fetchedAt: today, currency: fetched.currency, peakPrices: fetched.peakPrices },
+      null,
+      2,
+    )}\n`,
+    'utf8',
+  );
+  return { models: fetched.models, peakPrices: fetched.peakPrices, source, path: target, currency: fetched.currency };
+}
+
+/** 读当前覆盖文件（给界面显示"上次更新于"）。 */
+export function readOverride(env = process.env) {
+  try {
+    return JSON.parse(readFileSync(overridePath(env), 'utf8'));
+  } catch {
+    return undefined;
+  }
+}

package/lib/pricing.js

@@ -0,0 +1,108 @@
+/**
+ * Host 侧价格读取：每次请求（带短缓存）读 `pricing.json`，并按需叠加本机覆盖文件。
+ *
+ * 为什么要放在 Host 侧读、再经路由下发：这样**改价不用重新构建客户端 bundle、也不用重启服务**。
+ * 客户端 bundle 里内联的那份表只是兜底（路由不可用时仍能计价）。
+ *
+ * 覆盖文件：`$DSH_HOME/billing-prices.json`（不存在即忽略），形状可以是
+ *   { "peakPrices": { "模型id": { "cacheHit": 0.04, "cacheMiss": 2, "output": 8 } }, "source": "..." }
+ * 或直接就是 `{ "模型id": { ... } }`。用于官方调价、或接入别的提供方时的临时修正。
+ */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+/** 内置表：与客户端 bundle 内联的是同一份文件（唯一事实来源）。 */
+const BUILTIN_URL = new URL('../pricing.json', import.meta.url);
+
+/** 默认缓存时长：足够热，又能让"编辑 JSON 后几秒内生效"。 */
+const DEFAULT_TTL_MS = 5_000;
+
+/**
+ * 校验一条单价记录。
+ * @param value - 候选值。
+ * @returns 是否是合法的高峰价记录。
+ */
+function isRate(value) {
+  if (value === null || typeof value !== 'object') return false;
+  return ['cacheHit', 'cacheMiss', 'output'].every((key) => {
+    const n = value[key];
+    return typeof n === 'number' && Number.isFinite(n) && n >= 0;
+  });
+}
+
+/** 读一个 JSON 文件；不存在或损坏时返回 undefined（不抛错）。 */
+function readJson(url) {
+  try {
+    const parsed = JSON.parse(readFileSync(url, 'utf8'));
+    return parsed !== null && typeof parsed === 'object' ? parsed : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * 创建价格读取器。
+ * @param options - `{ home, ttlMs }`；`home` 默认 `$DSH_HOME` 或 `~/.dsh`。
+ * @returns `{ read, files }`；`read()` 返回 `{ prices, source, currency, overrideUsed }`。
+ */
+export function createPricingReader(options = {}) {
+  const home = options.home ?? ((process.env.DSH_HOME ?? '').trim() || join(homedir(), '.dsh'));
+  const overrideUrl = options.overridePath ?? join(home, 'billing-prices.json');
+  const ttlMs = Number.isFinite(options.ttlMs) && options.ttlMs >= 0 ? options.ttlMs : DEFAULT_TTL_MS;
+  let cache;
+
+  const compute = () => {
+    const builtin = readJson(BUILTIN_URL) ?? {};
+    const prices = {};
+    for (const [model, rate] of Object.entries(builtin.peakPrices ?? {})) {
+      if (isRate(rate)) prices[model] = { cacheHit: rate.cacheHit, cacheMiss: rate.cacheMiss, output: rate.output };
+    }
+    let source = typeof builtin.source === 'string' ? builtin.source : 'built-in pricing.json';
+    let currency = typeof builtin.currency === 'string' ? builtin.currency : 'CNY';
+    let overrideUsed = false;
+
+    const override = readJson(overrideUrl);
+    if (override !== undefined) {
+      const extra = override.peakPrices ?? override.prices ?? override;
+      if (extra !== null && typeof extra === 'object') {
+        for (const [model, rate] of Object.entries(extra)) {
+          if (!isRate(rate)) continue;
+          prices[model] = { cacheHit: rate.cacheHit, cacheMiss: rate.cacheMiss, output: rate.output };
+          overrideUsed = true;
+        }
+      }
+      if (typeof override.source === 'string' && override.source !== '') source = override.source;
+      if (typeof override.currency === 'string' && override.currency !== '') currency = override.currency;
+    }
+    return { prices, source, currency, overrideUsed };
+  };
+
+  return {
+    /**
+     * 读当前价格表（带 TTL 缓存）。
+     * @returns `{ prices, source, currency, overrideUsed }`。
+     */
+    read() {
+      const now = Date.now();
+      if (cache !== undefined && now - cache.at < ttlMs) return cache.value;
+      const value = compute();
+      cache = { at: now, value };
+      return value;
+    },
+    /** 供启动日志/状态页展示用（不含敏感信息）。 */
+    files() {
+      return {
+        builtin: BUILTIN_URL.pathname,
+        override: overrideUrl,
+      };
+    },
+    /**
+     * 丢弃缓存，让下一次 `read()` 重新读盘。
+     * 按钮刚写完覆盖文件就调它，界面无需等 TTL 过期。
+     */
+    invalidate() {
+      cache = undefined;
+    },
+  };
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Balance & cost",
+    "description": "Balance, this-turn and this-session cost beside the composer stats; prices update in one click"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "余额与花费",
+    "description": "在统计行旁显示账户余额、本轮与本会话花费，单价可一键更新"
+  }
+}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "dsh-plugin-billing",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Balance, this-turn and this-session cost beside the composer stats, with one-click price updates",
+  "type": "module",
+  "main": "lib/index.js",
+  "icon": "./icon.svg",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "scripts",
+    "locale",
+    "icon.svg",
+    "cordis.patch.yml",
+    "pricing.json"
+  ],
+  "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "verify": "node scripts/verify.mjs"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "billing",
+    "usage",
+    "balance"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  }
+}

package/pricing.json

@@ -0,0 +1,23 @@
+{
+  "_comment": [
+    "计费单价表 —— 唯一事实来源。客户端 bundle 会把它内联为兜底，Host 侧每次请求读取它并以路由字段下发，",
+    "因此改价只需编辑本文件（或 $DSH_HOME/billing-prices.json 覆盖），无需重新构建、也无需重启。",
+    "单位：元 / 百万 tokens，且只登记**高峰时段**价；空闲时段价由代码按倍率 0.5 折算（官方口径：空闲为高峰一半）。",
+    "高峰时段（北京时间）：周一至周五 09:00-12:00、14:00-18:00。",
+    "字段：cacheHit=缓存命中输入，cacheMiss=缓存未命中输入（缓存写入并入此档），output=输出。"
+  ],
+  "source": "DeepSeek 官方定价页 · 2026-09-18 抓取",
+  "sourceUrl": "https://api-docs.deepseek.com/zh-cn/quick_start/pricing",
+  "fetchedAt": "2026-09-18",
+  "currency": "CNY",
+  "peakPrices": {
+    "deepseek-flash": { "cacheHit": 0.04, "cacheMiss": 2, "output": 8 },
+    "deepseek-v4-flash": { "cacheHit": 0.04, "cacheMiss": 2, "output": 8 },
+    "deepseek-v4-flash-vision-exp": { "cacheHit": 0.04, "cacheMiss": 2, "output": 8 },
+    "deepseek-v4-pro": { "cacheHit": 0.3, "cacheMiss": 9, "output": 27 }
+  },
+  "_aliases": {
+    "deepseek-v4-flash": "官方说明：该旧模型名对应模型已下线，请求由 DeepSeek-V4.1-Flash 提供服务，并按 Flash 价格计费，故与 deepseek-flash 同价。",
+    "deepseek-v4-flash-vision-exp": "同上（旧名，模型已下线，按 Flash 价格计费）。"
+  }
+}

package/scripts/build-client.mjs

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * 组装浏览器侧 bundle `lib/client.js`。
+ *
+ * 为什么不直接手写 bundle：外壳执行的 classic script 只能 `require` 统一基座里的
+ * 共享模块，无法 `import` 本地文件。于是把两个纯声明源文件拼进 factory 闭包，
+ * 并把 React / jsx-runtime / UI 原语接成闭包变量：
+ *
+ *   src/pricing-body.js   单价表、高峰/空闲判定、计价
+ *   src/client-body.js    文案字典、金额行组件、apply/inject
+ *
+ * 用法：node scripts/build-client.mjs
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const root = join(here, '..');
+const PACKAGE_ID = 'dsh-plugin-billing';
+
+const read = (relative) => readFileSync(join(root, relative), 'utf8').trimEnd();
+
+/**
+ * 把 `pricing.json` 的高峰价表内联进客户端 bundle 的兜底位置。
+ *
+ * 这只是**兜底**：Host 侧每次请求都会读同一份文件并通过路由 `prices` 字段下发，客户端优先用它。
+ * 所以正常改价只需编辑 `pricing.json`（或 $DSH_HOME/billing-prices.json），
+ * 既不用重新跑本脚本，也不用重启服务。
+ */
+const pricing = JSON.parse(readFileSync(join(root, 'pricing.json'), 'utf8'));
+const pricingBody = read('src/pricing-body.js').replace(
+  '{/*__PRICES__*/}',
+  JSON.stringify(pricing.peakPrices, null, 2).split('\n').join('\n'),
+);
+
+/** 统一基座提供的共享模块（不属于 `dsh.client.external` 的额外请求）。 */
+const CLOSURE = [
+  ['react', 'react'],
+  ['jsxRuntime', 'react/jsx-runtime'],
+  ['primitives', '@deepseek-ai/dsh-client-ui-primitives'],
+];
+
+const bundle = `window.__ModuleLoader__.load({
+	id: ${JSON.stringify(PACKAGE_ID)},
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+${CLOSURE.map(([name, specifier]) => `\t\tlet ${name} = require(${JSON.stringify(specifier)});`).join('\n')}
+		//#region src/pricing-body.js —— 由 scripts/build-client.mjs 拼入（含 pricing.json 内联）
+${pricingBody}
+		//#endregion
+		//#region src/client-body.js —— 由 scripts/build-client.mjs 拼入
+${read('src/client-body.js')}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		/** 测试接缝：仅供 scripts/verify.mjs 驱动纯函数，不是公开 API。 */
+		exports.__testing = {
+			foldTurns,
+			composeView,
+			priceTable,
+			selectNodes,
+			fallbackTranslate,
+			isPeak,
+			ratesFor,
+			bucketsOf,
+			addBuckets,
+			costOf,
+			formatMoney,
+			formatTokens,
+			CSS,
+			ROOT_CLASS,
+			PILL_CLASS,
+			SEP_CLASS,
+			ROW_CLASS,
+			ROW_TITLE_CLASS,
+			ROW_DESC_CLASS,
+			ROW_ERROR_CLASS,
+			PricesRow,
+			usePricesEpoch,
+			bumpPricesEpoch,
+			pricesEpochOf: () => pricesEpoch,
+			PRICES_URL,
+			PRICES_REFRESH_URL,
+			NS
+		};
+		return module.exports;
+	}
+});
+`;
+
+writeFileSync(join(root, 'lib', 'client.js'), bundle, 'utf8');
+console.log(`✔ 已生成 lib/client.js（${Buffer.byteLength(bundle)} 字节）`);
+console.log(`  共享模块：${CLOSURE.map(([, s]) => s).join(', ')}`);
+console.log(`  内联价格表：${Object.keys(pricing.peakPrices).length} 个模型（${pricing.source}）`);

package/scripts/update-prices.mjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * 命令行入口：对比/更新官方定价。
+ *
+ * 核心逻辑（抓取、四条结构自校验、写覆盖文件）都在 `lib/prices.js` —— **和界面上的
+ * 「立即更新」按钮共用同一份实现**，不存在两套解析代码各错各的。
+ *
+ * 这个脚本存在的意义是"想看清楚再改"：默认只打印差异，改哪儿由你决定。
+ * 日常更新直接点设置里的按钮就行。
+ *
+ * 用法：
+ *   node scripts/update-prices.mjs                  # 只对比，不改文件（默认）
+ *   node scripts/update-prices.mjs --write          # 更新仓库里的 pricing.json（旧表备份为 .bak）
+ *   node scripts/update-prices.mjs --override       # 只写 $DSH_HOME/billing-prices.json（本机生效）
+ *   node scripts/update-prices.mjs --url <页面地址>  # 换数据源（调试用）
+ *   node scripts/update-prices.mjs --help
+ */
+import { copyFileSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_PRICING_URL, fetchOfficialPrices, overridePath, refreshPrices } from '../lib/prices.js';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const root = join(here, '..');
+const PRICING_PATH = join(root, 'pricing.json');
+
+/** 命令行里认识的开关；写错了宁可报错也不要"静默按默认跑"。 */
+const KNOWN_FLAGS = new Set(['--help', '-h', '--write', '--override', '--url']);
+
+/** 打印用法。 */
+function printUsage() {
+  console.log(`用法：node scripts/update-prices.mjs [选项]
+
+  （不带选项）        只抓取 + 自校验 + 打印与本地表的差异，**不改任何文件**
+  --write            更新仓库里的 pricing.json（旧表备份为 pricing.json.bak）
+  --override         只写 $DSH_HOME/billing-prices.json（本机生效，不动仓库）
+  --url <地址>       换数据源，默认官方中文页 ${DEFAULT_PRICING_URL}
+  -h, --help         显示这段说明
+
+自校验（任一不满足就拒绝写入，不会写错钱）：
+  · 时段标签必须严格交替「空闲/高峰」共 3 轮
+  · 价格数字个数必须 = 6 × 模型数
+  · 每个档位必须满足「空闲 = 高峰的一半」（官方口径）
+  · 币种必须解析成人民币（误抓英文 USD 页会被拦下）
+
+生效方式：Host 每 5 秒热读 pricing.json 与 $DSH_HOME/billing-prices.json，
+写入后 ≤5 秒生效 —— 不用重建 bundle，也不用重启客户端。
+界面上也可以直接点：设置 → 通用设置 → 用量价格表 → 立即更新。`);
+}
+
+/** 打印两个价格表的差异。 */
+function diffTable(before, after) {
+  const models = [...new Set([...Object.keys(before), ...Object.keys(after)])].sort();
+  return models
+    .map((model) => {
+      const old = before[model];
+      const now = after[model];
+      const cell = (rate) => (rate === undefined ? '—' : `${rate.cacheHit}/${rate.cacheMiss}/${rate.output}`);
+      const changed = JSON.stringify(old) !== JSON.stringify(now);
+      return `  ${changed ? '≠' : '='} ${model.padEnd(32)} ${cell(old).padEnd(18)} → ${cell(now)}`;
+    })
+    .join('\n');
+}
+
+const argv = process.argv.slice(2);
+const flag = (name) => argv.includes(name);
+const value = (name) => {
+  const index = argv.indexOf(name);
+  return index >= 0 ? argv[index + 1] : undefined;
+};
+
+const unknown = argv.filter((token) => token.startsWith('-') && !KNOWN_FLAGS.has(token));
+if (unknown.length > 0) {
+  console.error(`✘ 不认识的选项：${unknown.join(' ')}`);
+  printUsage();
+  process.exit(2);
+}
+if (flag('--help') || flag('-h')) {
+  printUsage();
+  process.exit(0);
+}
+
+const url = value('--url') ?? DEFAULT_PRICING_URL;
+console.log(`数据源: ${url}`);
+
+let fetched;
+try {
+  fetched = await fetchOfficialPrices({ url });
+} catch (error) {
+  console.error(`✘ ${error.message}`);
+  console.error('  （官方页改版或官方调整了空闲价政策时，宁可失败也不会写错钱）');
+  process.exit(1);
+}
+console.log(`解析到 ${fetched.models.length} 个模型：${fetched.models.join(', ')}`);
+console.log('结构自校验通过：时段标签交替、数字个数匹配、空闲 = 高峰的一半 ✅');
+
+const current = JSON.parse(readFileSync(PRICING_PATH, 'utf8'));
+console.log('\n高峰价（元 / 百万 tokens）差异： 缓存命中/未命中/输出');
+console.log(diffTable(current.peakPrices ?? {}, fetched.peakPrices));
+
+if (JSON.stringify(current.peakPrices) === JSON.stringify(fetched.peakPrices)) {
+  console.log('\n本地表已是最新 ✅（界面上点「立即更新」可以随时重新核对）');
+  process.exit(0);
+}
+
+const write = flag('--write');
+const override = flag('--override');
+if (!write && !override) {
+  console.log('\n（默认只对比不改文件；确认无误后加 --write 更新仓库表，或加 --override 只在本机生效）');
+  process.exit(0);
+}
+
+if (override) {
+  const result = await refreshPrices({ url });
+  console.log(`\n✔ 已写入本机覆盖文件 ${result.path}（Host 立刻生效，无需重启）`);
+  console.log(`  数据源标注：${result.source}`);
+  process.exit(0);
+}
+
+const today = new Date().toISOString().slice(0, 10);
+const payload = {
+  ...current,
+  source: `DeepSeek 官方定价页 · ${today} 抓取`,
+  sourceUrl: url,
+  fetchedAt: today,
+  currency: 'CNY',
+  peakPrices: fetched.peakPrices,
+};
+copyFileSync(PRICING_PATH, `${PRICING_PATH}.bak`);
+writeFileSync(PRICING_PATH, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+console.log(`\n✔ 已更新 ${PRICING_PATH}（旧表备份为 pricing.json.bak；Host 5 秒内自动生效）`);
+console.log('  建议接着跑一次：node scripts/verify.mjs');