@askdkc/dsh-cli 0.11.3

package/lib/types/customTheme.js

@@ -0,0 +1,281 @@
+/**
+ * User-defined color themes for dsh-tui.
+ *
+ * A theme is a JSON file in `~/.dsh-tui/themes/<name>.json`:
+ *
+ * ```json
+ * { "name": "sakura", "displayName": "Sakura Pink", "base": "dark",
+ *   "colors": { "accent": "#FF9EC7", "text": "#E8E6E0" } }
+ * ```
+ *
+ * `base` is required (`light`/`dark`/`dark-ansi`) and selects the built-in
+ * palette the file overlays; `colors` holds a subset of Theme keys. `name`
+ * defaults to the file name; `displayName` defaults to `name`.
+ *
+ * Validation is best-effort per key: unknown keys and invalid color values
+ * are skipped with a warning on stderr, never fatal; a file whose JSON is
+ * malformed or whose `base` is invalid is skipped entirely (also warned).
+ * Accepted color value forms (the same forms the built-in palettes and the
+ * Ink color engine use): `#rgb`, `#rrggbb`, `#rrggbbaa`, `rgb(r,g,b)`,
+ * `ansi256(n)` and the 16 `ansi:` names.
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getTheme, AUTO_THEME_NAME, isThemeColorKey, normalizeThemeKey, isRetiredThemeKey, } from './theme.js';
+import { DATA_DIR } from './utils/paths.js';
+/** The base palettes a user theme may overlay. */
+export const THEME_BASE_NAMES = ['light', 'dark', 'dark-ansi'];
+/** The directory user theme files live in (~/.dsh-tui/themes). */
+export const CUSTOM_THEME_DIR = join(DATA_DIR, 'themes');
+// #rgb / #rrggbb / #rrggbbaa
+const HEX_RE = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+// rgb(r,g,b) — the storage form of the built-in truecolor palettes
+const RGB_RE = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/;
+// ansi256(n) — supported by the Ink color engine
+const ANSI256_RE = /^ansi256\(\s*(\d{1,3})\s*\)$/;
+// The 16 standard ANSI names (the dark-ansi palette's storage form)
+const ANSI_NAMES = new Set([
+    'ansi:black',
+    'ansi:red',
+    'ansi:green',
+    'ansi:yellow',
+    'ansi:blue',
+    'ansi:magenta',
+    'ansi:cyan',
+    'ansi:white',
+    'ansi:blackBright',
+    'ansi:redBright',
+    'ansi:greenBright',
+    'ansi:yellowBright',
+    'ansi:blueBright',
+    'ansi:magentaBright',
+    'ansi:cyanBright',
+    'ansi:whiteBright',
+]);
+/** Resolved custom palettes, keyed by theme name (never caches failures). */
+const cache = new Map();
+/**
+ * `spec.name` → load key (file name), so a theme whose `name` field differs
+ * from its file name still resolves (DSH_TUI_THEME, /theme, persistence all
+ * speak the display name). Filled lazily on the first name miss.
+ */
+const nameIndex = new Map();
+let nameIndexed = false;
+/** Whether a value names one of the three built-in overlay palettes. */
+export function isThemeBase(value) {
+    return typeof value === 'string' && THEME_BASE_NAMES.includes(value);
+}
+/** Whether a value is a canonical or deprecated Theme input key. */
+export function isThemeKey(value) {
+    return isThemeColorKey(value);
+}
+/**
+ * Whether a name is safe to use as a file name (no path separators or dot
+ * traversal). Theme names are user input from DSH_TUI_THEME and /theme, so
+ * they must never escape the themes directory.
+ */
+export function isSafeThemeName(name) {
+    return (name.length > 0 &&
+        name !== '.' &&
+        name !== '..' &&
+        !name.includes('/') &&
+        !name.includes('\\'));
+}
+/**
+ * Whether a value is an accepted color string: #rgb/#rrggbb/#rrggbbaa,
+ * rgb(r,g,b), ansi256(n) or one of the 16 ansi: names — the same forms the
+ * built-in palettes and the Ink color engine accept.
+ * @param value - Candidate color value.
+ * @returns True when the value is a well-formed color string.
+ */
+export function isValidThemeColor(value) {
+    if (typeof value !== 'string')
+        return false;
+    if (HEX_RE.test(value))
+        return true;
+    const rgb = RGB_RE.exec(value);
+    if (rgb !== null) {
+        return rgb.slice(1).every(channel => Number(channel) <= 255);
+    }
+    const ansi = ANSI256_RE.exec(value);
+    if (ansi !== null)
+        return Number(ansi[1]) <= 255;
+    return ANSI_NAMES.has(value);
+}
+function warn(message) {
+    console.warn(`[dsh-tui] ${message}`);
+}
+/**
+ * Parse and validate a theme file's contents. Unknown keys and invalid
+ * color values are skipped (each warned); a file that is not an object,
+ * has an invalid `base`, or has a non-object `colors` is rejected entirely.
+ * @param text - Raw file contents.
+ * @param fileName - File name (with or without the .json extension); the
+ *   load key and the default theme name when the file omits `name`.
+ * @returns The validated spec, or undefined when the file is unusable.
+ */
+export function parseCustomTheme(text, fileName) {
+    const fileKey = fileName.toLowerCase().endsWith('.json')
+        ? fileName.slice(0, -'.json'.length)
+        : fileName;
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        warn(`theme file "${fileName}" is not valid JSON; skipped`);
+        return undefined;
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        warn(`theme file "${fileName}" is not a JSON object; skipped`);
+        return undefined;
+    }
+    const raw = parsed;
+    const base = raw.base;
+    if (typeof base !== 'string' || !isThemeBase(base)) {
+        warn(`theme "${fileName}": invalid or missing "base" (expected light|dark|dark-ansi); file skipped`);
+        return undefined;
+    }
+    const name = typeof raw.name === 'string' && raw.name.trim() !== '' ? raw.name.trim() : fileKey;
+    if (!isSafeThemeName(name)) {
+        warn(`theme "${fileName}": unsafe "name" ("${name}"); file skipped`);
+        return undefined;
+    }
+    // displayName 是用户数据入口：内部换行在此压平——它会进入 ThemePicker
+    // 的列表行（窗口化按固定行高切片，多行会破坏行高契约），也可能出现在
+    // 其他单行 UI（状态栏等）。ListItem 侧的递归压平是第二道防线。
+    const displayName = typeof raw.displayName === 'string' && raw.displayName.trim() !== ''
+        ? raw.displayName.trim().replace(/[\r\n]+/g, ' ')
+        : name;
+    const colorsRaw = raw.colors;
+    if (colorsRaw === undefined) {
+        return { name, displayName, base, colors: {}, file: fileKey };
+    }
+    if (colorsRaw === null ||
+        typeof colorsRaw !== 'object' ||
+        Array.isArray(colorsRaw)) {
+        warn(`theme "${fileName}": "colors" must be an object; file skipped`);
+        return undefined;
+    }
+    // Key/color validation against the Theme contract, so unknown keys and bad
+    // values are skipped per key (warned) instead of killing the theme.
+    const colors = {};
+    for (const [key, value] of Object.entries(colorsRaw)) {
+        if (isRetiredThemeKey(key))
+            continue;
+        const normalizedKey = isThemeKey(key) ? normalizeThemeKey(key) : undefined;
+        if (normalizedKey === undefined) {
+            warn(`theme "${fileName}": unknown color key "${key}" skipped`);
+            continue;
+        }
+        if (!isValidThemeColor(value)) {
+            warn(`theme "${fileName}": invalid color value for "${key}" (want #rgb/#rrggbb/#rrggbbaa, rgb(r,g,b), ansi256(n) or ansi:name); skipped`);
+            continue;
+        }
+        // Canonical names win over aliases regardless of JSON property order.
+        if (normalizedKey !== key && Object.prototype.hasOwnProperty.call(colors, normalizedKey))
+            continue;
+        colors[normalizedKey] = value;
+    }
+    return { name, displayName, base, colors, file: fileKey };
+}
+/**
+ * Load and validate one user theme by name.
+ * @param name - Theme name (file name without .json).
+ * @param dir - Themes directory (injectable for tests).
+ * @returns The validated spec, or undefined when missing/invalid.
+ */
+export function loadCustomTheme(name, dir = CUSTOM_THEME_DIR) {
+    if (!isSafeThemeName(name))
+        return undefined;
+    try {
+        return parseCustomTheme(readFileSync(join(dir, `${name}.json`), 'utf8'), name);
+    }
+    catch {
+        // Missing or unreadable file: a normal condition during discovery, no warning.
+        return undefined;
+    }
+}
+/**
+ * Discover every usable user theme in the themes directory, sorted by name.
+ * Invalid files are skipped (each warned by parseCustomTheme).
+ * @param dir - Themes directory (injectable for tests).
+ * @returns The validated specs found.
+ */
+export function listCustomThemes(dir = CUSTOM_THEME_DIR) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter(entry => entry.toLowerCase().endsWith('.json'))
+        .map(entry => entry.slice(0, -'.json'.length))
+        .filter(isSafeThemeName)
+        .map(name => loadCustomTheme(name, dir))
+        .filter((spec) => spec !== undefined)
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Overlay a spec's overrides onto its base palette.
+ * @param spec - Validated theme spec.
+ * @returns The full concrete palette.
+ */
+export function buildTheme(spec) {
+    return { ...getTheme(spec.base), ...spec.colors };
+}
+/**
+ * Resolve a user theme name to its full palette, cached after first load.
+ * A `name` field that differs from the file name is indexed on the first
+ * miss, so display names resolve everywhere. Failures are not cached, so a
+ * file fixed while the TUI runs can be picked up on the next attempt.
+ * @param name - User theme name.
+ * @returns The built palette, or undefined when unknown/invalid.
+ */
+export function resolveCustomTheme(name) {
+    if (!isSafeThemeName(name))
+        return undefined;
+    const cached = cache.get(name);
+    if (cached !== undefined)
+        return cached;
+    indexCustomThemeNames();
+    const file = nameIndex.get(name) ?? name;
+    const spec = loadCustomTheme(file);
+    if (spec === undefined)
+        return undefined;
+    const theme = buildTheme(spec);
+    cache.set(name, theme);
+    return theme;
+}
+/**
+ * Index every discovered theme's `name` → file name once, lazily. Kept
+ * separate from the palette cache so a miss is cheap after the first scan.
+ */
+function indexCustomThemeNames() {
+    if (nameIndexed)
+        return;
+    for (const spec of listCustomThemes()) {
+        nameIndex.set(spec.name, spec.file);
+    }
+    nameIndexed = true;
+}
+/**
+ * Whether a name selects a usable theme: a built-in palette, the `auto`
+ * pseudo-theme, or a valid user theme file. Used for DSH_TUI_THEME /
+ * persisted-preference validation and the runtime /theme switch.
+ * @param name - Candidate theme name.
+ * @returns True when the theme resolves.
+ */
+export function isThemeAvailable(name) {
+    if (name === AUTO_THEME_NAME || isThemeBase(name))
+        return true;
+    return resolveCustomTheme(name) !== undefined;
+}
+/** Drop the resolved-theme cache and name index (tests, or after themes change on disk). */
+export function clearCustomThemeCache() {
+    cache.clear();
+    nameIndex.clear();
+    nameIndexed = false;
+}

package/lib/types/deepseekBalance.d.ts

@@ -0,0 +1,19 @@
+import type { BalanceResult } from './adapter/ports/channel-catalog.js';
+export type { BalanceResult, BalanceInfo } from './adapter/ports/channel-catalog.js';
+/** 查询选项；fetchImpl 供无头回归注入。 */
+export interface BalanceQueryOptions {
+    /** 覆盖全局 fetch（测试注入）。 */
+    fetchImpl?: typeof fetch;
+    /** 覆盖 API 根地址（测试或镜像）。 */
+    baseUrl?: string;
+    /** 超时毫秒数，默认 8000。 */
+    timeoutMs?: number;
+}
+export declare const DEEPSEEK_BALANCE_ENDPOINT = "https://api.deepseek.com/user/balance";
+/**
+ * 查询 DeepSeek 官方账户余额。
+ * @param apiKey - `DEEPSEEK_API_KEY` 值；空字符串返回 no-key。
+ * @param options - 查询选项。
+ */
+export declare function fetchBalance(apiKey: string, options?: BalanceQueryOptions): Promise<BalanceResult>;
+//# sourceMappingURL=deepseekBalance.d.ts.map

package/lib/types/deepseekBalance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseekBalance.d.ts","sourceRoot":"","sources":["../../src/deepseekBalance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,oCAAoC,CAAA;AACpF,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAGpF,8BAA8B;AAC9B,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;IACxB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,yBAAyB,0CAA0C,CAAA;AAIhF;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/lib/types/deepseekBalance.js

@@ -0,0 +1,72 @@
+export const DEEPSEEK_BALANCE_ENDPOINT = 'https://api.deepseek.com/user/balance';
+const DEFAULT_TIMEOUT_MS = 8000;
+/**
+ * 查询 DeepSeek 官方账户余额。
+ * @param apiKey - `DEEPSEEK_API_KEY` 值；空字符串返回 no-key。
+ * @param options - 查询选项。
+ */
+export async function fetchBalance(apiKey, options = {}) {
+    if (apiKey === '')
+        return { ok: false, reason: 'no-key' };
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const endpoint = options.baseUrl === undefined
+        ? DEEPSEEK_BALANCE_ENDPOINT
+        : `${options.baseUrl.replace(/\/+$/, '')}/user/balance`;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchImpl(endpoint, {
+            headers: { authorization: `Bearer ${apiKey}` },
+            signal: controller.signal,
+        });
+        if (response.status === 401 || response.status === 403) {
+            return { ok: false, reason: 'unauthorized', status: response.status };
+        }
+        if (!response.ok) {
+            return { ok: false, reason: 'http', status: response.status };
+        }
+        const payload = await response.json().catch(() => undefined);
+        const parsed = parseBalancePayload(payload);
+        return parsed ?? { ok: false, reason: 'invalid' };
+    }
+    catch {
+        return { ok: false, reason: 'network' };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function parseBalancePayload(payload) {
+    if (payload === null || typeof payload !== 'object' || Array.isArray(payload))
+        return undefined;
+    const record = payload;
+    const infos = record.balance_infos;
+    if (!Array.isArray(infos))
+        return undefined;
+    const balances = [];
+    for (const raw of infos) {
+        if (raw === null || typeof raw !== 'object' || Array.isArray(raw))
+            return undefined;
+        const info = raw;
+        const currency = info.currency;
+        const total = parseCny(info.total_balance);
+        const granted = parseCny(info.granted_balance);
+        const toppedUp = parseCny(info.topped_up_balance);
+        if (typeof currency !== 'string' || currency === '' || total === undefined || granted === undefined || toppedUp === undefined) {
+            return undefined;
+        }
+        balances.push({ currency, total, granted, toppedUp });
+    }
+    return {
+        ok: true,
+        isAvailable: record.is_available === true,
+        balances,
+    };
+}
+function parseCny(value) {
+    if (typeof value !== 'string' && typeof value !== 'number')
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}

package/lib/types/deepseekPricing.d.ts

@@ -0,0 +1,83 @@
+/**
+ * DeepSeek 官方定价与"本会话花费"估算（人民币口径）。
+ *
+ * 数据来源：DeepSeek 官方文档「模型 & 价格」页（2026-09 快照，含
+ * V4.1-Flash 发布调价），单位为人民
+ * 币/百万 tokens。DeepSeek 官方 API 只返回 token 用量、不返回金额，本模块按
+ * 官方公开单价把会话累计 token 换算成金额 —— 这是**估算**，不是账单：
+ * 定价可能变动，且余额扣费发生在 DeepSeek 侧（以平台账单为准）。
+ *
+ * 计价规则（来自官方页面）：
+ *  - 扣减费用 = token 消耗量 × 模型单价；
+ *  - 缓存命中的输入按命中价计费，其余输入（含写入缓存）按未命中价计费；
+ *  - 高峰时段为北京时间周一至周五 9:00-12:00、14:00-18:00，其余为空闲时段
+ *    （空闲价为高峰价的一半）。
+ */
+/** 单价对：`[空闲价, 高峰价]`，单位 元/百万 tokens。 */
+export type CnyPerMillion = readonly [number, number];
+/** 一个官方模型的完整价目（人民币/百万 tokens）。 */
+export interface DeepSeekModelPrice {
+    /** 输入（缓存未命中，含写入缓存部分）。 */
+    inputMiss: CnyPerMillion;
+    /** 输入（缓存命中）。 */
+    inputHit: CnyPerMillion;
+    /** 输出。 */
+    output: CnyPerMillion;
+}
+/**
+ * 在售模型价目表，按 API model id 前缀匹配（最长前缀优先）。
+ * 新模型上线而本表未收录时，估算返回 undefined，界面不显示金额（只显示
+ * token 用量），不会给出错误数字。
+ */
+export declare const DEEPSEEK_MODEL_PRICES: Readonly<Record<string, DeepSeekModelPrice>>;
+/**
+ * DeepSeek 官方 API key 路由（余额/花费估算只对它们有意义）。参考社区
+ * dsh-balance 的 provider 判定：DSH 自带官方路由 `deepseek-official`
+ * （modelRoute.ts 默认路由），另兼容裸 `deepseek` 与 dsh-vision-router
+ * 的 `deepseek-vision` 包装路由。
+ */
+export declare const DEEPSEEK_OFFICIAL_PROVIDERS: readonly string[];
+/** 是否 DeepSeek 官方 provider（余额与定价只适用于官方计费口径）。 */
+export declare function isDeepSeekOfficialProvider(provider: string): boolean;
+/**
+ * 是否处于高峰计费时段：北京时间周一至周五 9:00-12:00、14:00-18:00。
+ * 北京时间为 UTC+8 固定偏移（无夏令时），用 UTC 时刻加偏移换算。
+ */
+export declare function isPeakHour(date?: Date): boolean;
+/** 按前缀匹配模型价目，最长前缀优先；未收录返回 undefined。 */
+export declare function priceForModel(model: string): DeepSeekModelPrice | undefined;
+/** 会话累计 token（与 Channel.tokens 同构，含缓存分项）。 */
+export interface CostTokenTotals {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+/**
+ * 按计价时段分桶的会话 token：每笔 usage 按其发生时刻（event.time）落入
+ * 高峰或空闲桶，估算时各按对应单价——跨时段会话不会整段按当前时段计价。
+ */
+export interface CostTokenBuckets {
+    peak: CostTokenTotals;
+    idle: CostTokenTotals;
+}
+/**
+ * 估算本会话花费拆分（人民币，元）：高峰桶按高峰价、空闲桶按空闲价。
+ * 公式（每桶）：(input − cacheRead) × 输入未命中价 + cacheRead × 输入命中价
+ * + output × 输出价；cacheWrite 不单独计价（写入缓存的 token 已计入 input
+ * 的未命中部分）。模型未收录或所有 token 均为零时返回 undefined（调用方
+ * 不显示金额）。这是**估算**，不是账单——定价可能变动，以 DeepSeek 平台
+ * 账单为准。
+ * @param tokens - 按计价时段分桶的会话累计 token。
+ * @param model - 当前模型 id（前缀匹配价目）。
+ */
+export declare function estimateSessionCostSplitCny(tokens: CostTokenBuckets, model: string): {
+    total: number;
+    peak: number;
+    idle: number;
+} | undefined;
+/**
+ * 估算本会话花费（人民币，元）——estimateSessionCostSplitCny 的总价捷径。
+ */
+export declare function estimateSessionCostCny(tokens: CostTokenBuckets, model: string): number | undefined;
+//# sourceMappingURL=deepseekPricing.d.ts.map

package/lib/types/deepseekPricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepseekPricing.d.ts","sourceRoot":"","sources":["../../src/deepseekPricing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAErD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,SAAS,EAAE,aAAa,CAAA;IACxB,gBAAgB;IAChB,QAAQ,EAAE,aAAa,CAAA;IACvB,UAAU;IACV,MAAM,EAAE,aAAa,CAAA;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAsB9E,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAIxD,CAAA;AAED,gDAAgD;AAChD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,IAAiB,GAAG,OAAO,CAM3D;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAU3E;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,eAAe,CAAA;CACtB;AAiCD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAc3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAEpB"}

package/lib/types/deepseekPricing.js

@@ -0,0 +1,140 @@
+/**
+ * DeepSeek 官方定价与"本会话花费"估算（人民币口径）。
+ *
+ * 数据来源：DeepSeek 官方文档「模型 & 价格」页（2026-09 快照，含
+ * V4.1-Flash 发布调价），单位为人民
+ * 币/百万 tokens。DeepSeek 官方 API 只返回 token 用量、不返回金额，本模块按
+ * 官方公开单价把会话累计 token 换算成金额 —— 这是**估算**，不是账单：
+ * 定价可能变动，且余额扣费发生在 DeepSeek 侧（以平台账单为准）。
+ *
+ * 计价规则（来自官方页面）：
+ *  - 扣减费用 = token 消耗量 × 模型单价；
+ *  - 缓存命中的输入按命中价计费，其余输入（含写入缓存）按未命中价计费；
+ *  - 高峰时段为北京时间周一至周五 9:00-12:00、14:00-18:00，其余为空闲时段
+ *    （空闲价为高峰价的一半）。
+ */
+/**
+ * 在售模型价目表，按 API model id 前缀匹配（最长前缀优先）。
+ * 新模型上线而本表未收录时，估算返回 undefined，界面不显示金额（只显示
+ * token 用量），不会给出错误数字。
+ */
+export const DEEPSEEK_MODEL_PRICES = {
+    // DeepSeek-V41-Flash（2026-09-10 发布并取代 V4-Pro 后的下调价目）。
+    'deepseek-flash': {
+        inputMiss: [1.0, 2.0],
+        inputHit: [0.02, 0.04],
+        output: [4.0, 8.0],
+    },
+    'deepseek-v4-flash': {
+        inputMiss: [1.5, 3.0],
+        inputHit: [0.05, 0.10],
+        output: [4.5, 9.0],
+    },
+    'deepseek-v4-pro': {
+        inputMiss: [4.5, 9.0],
+        inputHit: [0.15, 0.30],
+        output: [13.5, 27.0],
+    },
+    'deepseek-v4-flash-vision-exp': {
+        inputMiss: [1.5, 3.0],
+        inputHit: [0.05, 0.10],
+        output: [4.5, 9.0],
+    },
+};
+/**
+ * DeepSeek 官方 API key 路由（余额/花费估算只对它们有意义）。参考社区
+ * dsh-balance 的 provider 判定：DSH 自带官方路由 `deepseek-official`
+ * （modelRoute.ts 默认路由），另兼容裸 `deepseek` 与 dsh-vision-router
+ * 的 `deepseek-vision` 包装路由。
+ */
+export const DEEPSEEK_OFFICIAL_PROVIDERS = [
+    'deepseek',
+    'deepseek-official',
+    'deepseek-vision',
+];
+/** 是否 DeepSeek 官方 provider（余额与定价只适用于官方计费口径）。 */
+export function isDeepSeekOfficialProvider(provider) {
+    return DEEPSEEK_OFFICIAL_PROVIDERS.includes(provider);
+}
+/**
+ * 是否处于高峰计费时段：北京时间周一至周五 9:00-12:00、14:00-18:00。
+ * 北京时间为 UTC+8 固定偏移（无夏令时），用 UTC 时刻加偏移换算。
+ */
+export function isPeakHour(date = new Date()) {
+    const shifted = new Date(date.getTime() + 8 * 3_600_000);
+    const weekday = shifted.getUTCDay(); // 0 = Sunday
+    const hour = shifted.getUTCHours();
+    if (weekday === 0 || weekday === 6)
+        return false;
+    return (hour >= 9 && hour < 12) || (hour >= 14 && hour < 18);
+}
+/** 按前缀匹配模型价目，最长前缀优先；未收录返回 undefined。 */
+export function priceForModel(model) {
+    let best;
+    let bestLength = 0;
+    for (const [prefix, price] of Object.entries(DEEPSEEK_MODEL_PRICES)) {
+        if (model.startsWith(prefix) && prefix.length > bestLength) {
+            best = price;
+            bestLength = prefix.length;
+        }
+    }
+    return best;
+}
+/** 空桶（防御 tokens.peak/idle 缺失的旧数据/测试桩）。 */
+const EMPTY_TOTALS = Object.freeze({
+    input: 0,
+    output: 0,
+    cacheRead: 0,
+    cacheWrite: 0,
+});
+/** 按高峰/空闲单价分别计价，返回 [高峰元, 空闲元]（未除 1e6）。 */
+function costSplit(tokens, price) {
+    // 分桶字段在真实 Channel 上恒有（emptyTokenUsage 初始化），但旧快照与
+    // 测试桩可能缺桶——缺失时按空桶计，绝不抛错。
+    const peak = tokens.peak ?? EMPTY_TOTALS;
+    const idle = tokens.idle ?? EMPTY_TOTALS;
+    const costOf = (bucket, rateIndex) => {
+        const input = Math.max(0, bucket.input);
+        const output = Math.max(0, bucket.output);
+        const cacheRead = Math.max(0, Math.min(input, bucket.cacheRead));
+        return (input - cacheRead) * price.inputMiss[rateIndex]
+            + cacheRead * price.inputHit[rateIndex]
+            + output * price.output[rateIndex];
+    };
+    return {
+        peak: costOf(peak, 1),
+        idle: costOf(idle, 0),
+    };
+}
+/**
+ * 估算本会话花费拆分（人民币，元）：高峰桶按高峰价、空闲桶按空闲价。
+ * 公式（每桶）：(input − cacheRead) × 输入未命中价 + cacheRead × 输入命中价
+ * + output × 输出价；cacheWrite 不单独计价（写入缓存的 token 已计入 input
+ * 的未命中部分）。模型未收录或所有 token 均为零时返回 undefined（调用方
+ * 不显示金额）。这是**估算**，不是账单——定价可能变动，以 DeepSeek 平台
+ * 账单为准。
+ * @param tokens - 按计价时段分桶的会话累计 token。
+ * @param model - 当前模型 id（前缀匹配价目）。
+ */
+export function estimateSessionCostSplitCny(tokens, model) {
+    const price = priceForModel(model);
+    if (price === undefined)
+        return undefined;
+    const split = costSplit(tokens, price);
+    const peak = tokens.peak ?? EMPTY_TOTALS;
+    const idle = tokens.idle ?? EMPTY_TOTALS;
+    const totalTokens = peak.input + peak.output + idle.input + idle.output;
+    if (totalTokens <= 0)
+        return undefined;
+    return {
+        total: split.peak / 1_000_000 + split.idle / 1_000_000,
+        peak: split.peak / 1_000_000,
+        idle: split.idle / 1_000_000,
+    };
+}
+/**
+ * 估算本会话花费（人民币，元）——estimateSessionCostSplitCny 的总价捷径。
+ */
+export function estimateSessionCostCny(tokens, model) {
+    return estimateSessionCostSplitCny(tokens, model)?.total;
+}