@lyogvce/dsh-codex-subscription 0.2.5 → 0.2.7

package/README.md

@@ -13,15 +13,16 @@
    - 每次请求前检查 `access_token` 的 JWT `exp`：距离过期不足 5 分钟时自动通过单飞锁（Single-flight）向 `https://auth.openai.com/oauth/token` 刷新，并通过 `realpathSync` + 临时文件 `rename` 原子写回 `auth.json`，保证与 Codex CLI 永不互踢下线。
 2. **零网络轮询的本地模型目录发现、防降级保护与可观测性日志**
    - 直接读取 `~/.codex/models_cache.json`（每次按文件 `mtime` 与大小做微秒级 `stat` 校验，仅在文件变化时重读解析），提取 `visibility === "list"` 的模型及其 `context_window`、`supported_reasoning_levels`（自动将 `ultra` 映射为 DSH 的 `max` 档位）与 `default_verbosity`。
-   - **防旧版客户端降级污染**：自动将高版本 `models_cache.json` 备份至 `~/.codex/.dsh-models-cache-backup.json`；当外部旧版进程（如 `dsh-subagent-codex` 内置的 `0.153.4`）将 `models_cache.json` 降级覆写为不含新模型的旧缓存时，自动拦截降级并保留高版本模型目录。
-   - **可观测性日志**：自动在 `~/.codex/dsh-codex-subscription.log`（带 512KB 自动滚动截断）记录目录加载（`catalog.load` / `catalog.snapshot`）、降级拦截（`catalog.downgrade_rejected`）、备份恢复（`catalog.backup_restored`）与凭证续期（`auth.refreshed`）事件。
+   - **防旧版客户端降级污染**：自动将高版本 `models_cache.json` 备份至 `~/.codex/cache/dsh-codex-subscription/models-cache-backup.json`；当外部旧版进程（如 `dsh-subagent-codex` 内置的 `0.153.4`）将 `models_cache.json` 降级覆写为不含新模型的旧缓存时，自动拦截降级并保留高版本模型目录。
+   - **可观测性日志**：自动在 `~/.codex/cache/dsh-codex-subscription/plugin.log`（带 512KB 自动滚动截断，忽略纯 `fetched_at` 心跳刷新）记录目录加载（`catalog.load` / `catalog.snapshot`）、降级拦截（`catalog.downgrade_rejected`）、备份恢复（`catalog.backup_restored`）与凭证续期（`auth.refreshed` / `auth.refresh_failed`）事件。
 3. **支持按配置屏蔽模型（`disabledModels`）与自定义上下文窗口（`contextWindows`）**
    - 在插件配置中通过 `disabledModels` 屏蔽指定模型 `slug`，保持模型选择器干净清爽。
    - 通过 `contextWindows` 按模型 `slug` 自定义向 DSH 会话与自动压缩器暴露的预算窗口（例如设为 `400000`）；未配置时默认使用模型物理上限 `max_context_window`（`872000`）。同时底层 `PiCodexModel.contextWindow` 始终保持物理上限 `872000`，彻底防止 `dsh-llm-pi-ai` 在预算窗口与物理上限之间误判 `CONTEXT_WINDOW_EXCEEDED`。
 4. **原生多轮思考链回放与工具调用**
    - 底层复用 DSH 内置的 `PiAiAdapter` 与 `@earendil-works/pi-ai` 的 `openaiCodexProvider()`，固定使用 `sse` 传输（含 `zstd` 请求体压缩、规范化纯 UUID `session-id` / `x-client-request-id` 缓存头、`reasoning.encrypted_content` 签名回放与图片自动缩放卸载）。
-5. **Codex 订阅限额内联展示（`conversation.input.right`）**
+5. **Codex 订阅限额内联展示与 ⚡ Fast 极速模式一键切换（`conversation.input.right`）**
    - 当会话选中 `openai-codex` 模型时，在输入框右下角紧邻模型选择器左侧展示限额胶囊（根据 `wham/usage` 返回的 `limit_window_seconds` 自适应展示 Plus 的 `5h X% · 7d Y%` 双窗口或 Pro 的 `7d X%` 单窗口，内置 60 秒缓存、单飞合并与每轮回复结束自动刷新），点击可展开查看对应窗口进度条、重置倒计时与手动刷新按钮；切换至其他 Provider 模型时自动隐藏。
+   - **⚡ Fast 极速模式（`service_tier: "priority"`，最高 2x 推理速度）**：可在限额弹窗底部直接一键开关 Fast 模式（自动持久化至 `~/.codex/cache/dsh-codex-subscription/runtime-state.json`，也可在插件设置页通过 `fastMode` 配置），开启后胶囊上显示闪电标识 `⚡`，并在请求体中自动为支持 Fast 档位的模型注入 `"service_tier": "priority"`。
 
 ---
 

package/lib/client.js

@@ -139,12 +139,14 @@ window.__ModuleLoader__.load({
 			const ttlMs = options.ttlMs ?? 6e4;
 			let state = {
 				quota: null,
+				fastMode: false,
 				loading: false,
 				error: null
 			};
 			let inflight = null;
 			let inflightForce = false;
 			let requestSeq = 0;
+			let fastModeSeq = 0;
 			const listeners = new Set();
 			function setState(next) {
 				state = next;
@@ -154,6 +156,7 @@ window.__ModuleLoader__.load({
 				if (!force && state.quota !== null && nowFn() - state.quota.fetchedAt < ttlMs) return;
 				if (inflight !== null && (!force || inflightForce)) return inflight;
 				const seq = ++requestSeq;
+				const fastSeqAtStart = fastModeSeq;
 				inflightForce = force;
 				setState({
 					...state,
@@ -170,7 +173,7 @@ window.__ModuleLoader__.load({
 						if (seq !== requestSeq) return;
 						if (!response.ok) {
 							setState({
-								quota: state.quota,
+								...state,
 								loading: false,
 								error: `HTTP ${response.status}`
 							});
@@ -178,8 +181,10 @@ window.__ModuleLoader__.load({
 						}
 						const payload = await response.json();
 						if (seq !== requestSeq) return;
+						const resolvedFastMode = fastSeqAtStart === fastModeSeq && typeof payload?.fastMode === "boolean" ? payload.fastMode : state.fastMode;
 						if (payload && payload.ok === true && payload.quota) setState({
 							quota: payload.quota,
+							fastMode: resolvedFastMode,
 							loading: false,
 							error: null
 						});
@@ -188,6 +193,7 @@ window.__ModuleLoader__.load({
 							const errMsg = payload && !payload.ok && typeof payload.error === "string" ? payload.error : "Invalid response";
 							setState({
 								quota: fallbackQuota ?? null,
+								fastMode: resolvedFastMode,
 								loading: false,
 								error: errMsg
 							});
@@ -195,7 +201,7 @@ window.__ModuleLoader__.load({
 					} catch (error) {
 						if (seq !== requestSeq) return;
 						setState({
-							quota: state.quota,
+							...state,
 							loading: false,
 							error: safeErrorMessage(error)
 						});
@@ -209,6 +215,30 @@ window.__ModuleLoader__.load({
 				inflight = task;
 				return task;
 			}
+			async function setFastMode(enabled) {
+				const nextFastMode = Boolean(enabled);
+				const seq = ++fastModeSeq;
+				setState({
+					...state,
+					fastMode: nextFastMode
+				});
+				try {
+					const response = await fetchFn(USAGE_ROUTE_PATH, {
+						method: "POST",
+						headers: {
+							"Content-Type": "application/json",
+							Accept: "application/json"
+						},
+						body: JSON.stringify({ fastMode: nextFastMode })
+					});
+					if (seq !== fastModeSeq || !response.ok) return;
+					const payload = await response.json();
+					if (seq === fastModeSeq && typeof payload?.fastMode === "boolean") setState({
+						...state,
+						fastMode: payload.fastMode
+					});
+				} catch {}
+			}
 			return {
 				getSnapshot: () => state,
 				subscribe(listener) {
@@ -217,7 +247,8 @@ window.__ModuleLoader__.load({
 						listeners.delete(listener);
 					};
 				},
-				refresh
+				refresh,
+				setFastMode
 			};
 		}
 		//#endregion
@@ -250,6 +281,15 @@ window.__ModuleLoader__.load({
 			".dsh-codex-quota-bar-fill[data-level=\"warn\"]{background:var(--dsw-alias-state-warn-primary)}",
 			".dsh-codex-quota-bar-fill[data-level=\"error\"]{background:var(--dsw-alias-state-error-primary)}",
 			".dsh-codex-quota-meta{display:flex;justify-content:space-between;gap:8px;font-size:11px;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums}",
+			".dsh-codex-quota-fast-bolt{color:var(--dsw-alias-state-warn-primary,#f59e0b);flex:none}",
+			".dsh-codex-fast-row{display:flex;align-items:center;justify-content:space-between;gap:10px;margin-top:8px;padding-top:8px;border-top:1px solid var(--dsw-alias-border-l1)}",
+			".dsh-codex-fast-info{display:flex;flex-direction:column;gap:1px;min-width:0}",
+			".dsh-codex-fast-title{display:inline-flex;align-items:center;gap:4px;font-size:12px;font-weight:500;color:var(--dsw-alias-label-primary)}",
+			".dsh-codex-fast-desc{font-size:11px;line-height:15px;color:var(--dsw-alias-label-tertiary)}",
+			".dsh-codex-fast-switch{position:relative;width:32px;height:18px;border-radius:999px;border:none;padding:0;background:var(--dsw-alias-border-l2,rgba(128,128,128,0.35));cursor:pointer;flex:none;transition:background-color .15s ease}",
+			".dsh-codex-fast-switch[data-checked=\"true\"]{background:var(--dsw-alias-brand-primary,#3b82f6)}",
+			".dsh-codex-fast-switch-thumb{position:absolute;top:2px;left:2px;width:14px;height:14px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgba(0,0,0,0.2);transition:transform .15s ease}",
+			".dsh-codex-fast-switch[data-checked=\"true\"] .dsh-codex-fast-switch-thumb{transform:translateX(14px)}",
 			".dsh-codex-quota-error{margin-top:6px;padding:4px 6px;border-radius:4px;background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-state-error-primary);font-size:11px;word-break:break-word}"
 		].join("");
 		//#endregion
@@ -265,7 +305,9 @@ window.__ModuleLoader__.load({
 			"quota.refresh": "↻ 刷新",
 			"quota.refreshing": "↻ 刷新中…",
 			"quota.usedPrefix": "已用 ",
-			"quota.remainPrefix": "剩余 "
+			"quota.remainPrefix": "剩余 ",
+			"quota.fastTitle": "Fast 极速模式",
+			"quota.fastDesc": "2x 推理速度，消耗更多限额"
 		};
 		const en = {
 			"quota.title": "Codex Subscription Quota",
@@ -273,7 +315,9 @@ window.__ModuleLoader__.load({
 			"quota.refresh": "↻ Refresh",
 			"quota.refreshing": "↻ Refreshing…",
 			"quota.usedPrefix": "Used ",
-			"quota.remainPrefix": "Remaining "
+			"quota.remainPrefix": "Remaining ",
+			"quota.fastTitle": "Fast Mode",
+			"quota.fastDesc": "2x speed, increased usage"
 		};
 		const EMPTY_MODEL_STORE = {
 			getSnapshot: () => null,
@@ -354,6 +398,7 @@ window.__ModuleLoader__.load({
 				type: "button",
 				className: "dsh-codex-quota-trigger",
 				"data-level": level,
+				"data-fast": quotaSnap.fastMode ? "true" : void 0,
 				"aria-label": `${t("quota.title")}: ${pillText}`,
 				"aria-haspopup": "dialog",
 				"aria-expanded": open,
@@ -380,7 +425,16 @@ window.__ModuleLoader__.load({
 				r: 5.5,
 				strokeDasharray: ringDash,
 				transform: "rotate(-90 7 7)"
-			})), h("span", { className: "dsh-codex-quota-text" }, pillText)), open ? h("div", {
+			})), quotaSnap.fastMode ? h("svg", {
+				className: "dsh-codex-quota-fast-bolt",
+				viewBox: "0 0 12 12",
+				width: 11,
+				height: 11,
+				"aria-hidden": true
+			}, h("path", {
+				d: "M6.8 1L2.5 6.8h3.1L4.8 11l4.7-5.8H6.4L6.8 1z",
+				fill: "currentColor"
+			})) : null, h("span", { className: "dsh-codex-quota-text" }, pillText)), open ? h("div", {
 				className: "dsh-codex-quota-popover",
 				role: "dialog",
 				"aria-label": t("quota.title"),
@@ -394,7 +448,26 @@ window.__ModuleLoader__.load({
 				onClick: () => {
 					quotaStore.refresh(true);
 				}
-			}, quotaSnap.loading ? t("quota.refreshing") : t("quota.refresh"))), quota !== null ? renderWindowSection(formatWindowTitle(quota.primary.windowSeconds, locale, DEFAULT_PRIMARY_WINDOW_SECONDS), quota.primary, primaryReached) : quotaSnap.loading || quotaSnap.error === null ? h("div", { className: "dsh-codex-quota-meta" }, t("quota.loading")) : null, quota?.secondary !== null && quota?.secondary !== void 0 ? renderWindowSection(formatWindowTitle(quota.secondary.windowSeconds, locale, DEFAULT_SECONDARY_WINDOW_SECONDS), quota.secondary, secondaryReached) : null, quotaSnap.error !== null ? h("div", { className: "dsh-codex-quota-error" }, quotaSnap.error) : null) : null);
+			}, quotaSnap.loading ? t("quota.refreshing") : t("quota.refresh"))), quota !== null ? renderWindowSection(formatWindowTitle(quota.primary.windowSeconds, locale, DEFAULT_PRIMARY_WINDOW_SECONDS), quota.primary, primaryReached) : quotaSnap.loading || quotaSnap.error === null ? h("div", { className: "dsh-codex-quota-meta" }, t("quota.loading")) : null, quota?.secondary !== null && quota?.secondary !== void 0 ? renderWindowSection(formatWindowTitle(quota.secondary.windowSeconds, locale, DEFAULT_SECONDARY_WINDOW_SECONDS), quota.secondary, secondaryReached) : null, h("div", { className: "dsh-codex-fast-row" }, h("div", { className: "dsh-codex-fast-info" }, h("div", { className: "dsh-codex-fast-title" }, h("svg", {
+				className: "dsh-codex-quota-fast-bolt",
+				viewBox: "0 0 12 12",
+				width: 12,
+				height: 12,
+				"aria-hidden": true
+			}, h("path", {
+				d: "M6.8 1L2.5 6.8h3.1L4.8 11l4.7-5.8H6.4L6.8 1z",
+				fill: "currentColor"
+			})), h("span", null, t("quota.fastTitle"))), h("div", { className: "dsh-codex-fast-desc" }, t("quota.fastDesc"))), h("button", {
+				type: "button",
+				role: "switch",
+				className: "dsh-codex-fast-switch",
+				"aria-checked": quotaSnap.fastMode,
+				"aria-label": t("quota.fastTitle"),
+				"data-checked": quotaSnap.fastMode ? "true" : "false",
+				onClick: () => {
+					quotaStore.setFastMode(!quotaSnap.fastMode);
+				}
+			}, h("span", { className: "dsh-codex-fast-switch-thumb" }))), quotaSnap.error !== null ? h("div", { className: "dsh-codex-quota-error" }, quotaSnap.error) : null) : null);
 		}
 		const inject = ["slots", "locale"];
 		function apply(ctx) {

package/lib/index.d.ts

@@ -59,11 +59,18 @@ declare function createAuthManager(options: AuthManagerOptions): {
 };
 //#endregion
 //#region src/catalog.d.ts
-export declare const BACKUP_CACHE_FILE_NAME = ".dsh-models-cache-backup.json";
+export declare const PLUGIN_CACHE_DIR_NAME = "cache/dsh-codex-subscription";
+export declare const BACKUP_CACHE_FILE_NAME = "models-cache-backup.json";
+export declare const RUNTIME_STATE_FILE_NAME = "runtime-state.json";
 interface RawReasoningLevel {
   effort?: string;
   description?: string;
 }
+interface RawServiceTier {
+  id?: string;
+  name?: string;
+  description?: string;
+}
 interface RawCodexModelEntry {
   slug?: string;
   display_name?: string;
@@ -77,6 +84,8 @@ interface RawCodexModelEntry {
   default_reasoning_level?: string;
   support_verbosity?: boolean;
   default_verbosity?: string;
+  additional_speed_tiers?: unknown[];
+  service_tiers?: RawServiceTier[];
 }
 interface RawModelsCache {
   fetched_at?: string;
@@ -90,6 +99,7 @@ interface CodexModelMetadata {
   readonly supportVerbosity: boolean;
   readonly defaultVerbosity: 'low' | 'medium' | 'high';
   readonly defaultReasoningLevel?: string | undefined;
+  readonly fastServiceTier?: string | undefined;
 }
 interface ParsedModelsCatalog {
   readonly clientVersion: string;
@@ -103,7 +113,7 @@ declare function parseModelsCache(rawCache: RawModelsCache | null | undefined, b
 declare function buildCodexUserAgent(version?: string): string;
 declare function normalizeCodexSessionId(sessionId: string | undefined): string | undefined;
 declare function buildCodexHeaders(existingHeaders?: Record<string, string> | undefined, clientVersion?: string): Record<string, string>;
-declare function sanitizeCodexPayload(payload: Record<string, unknown> | null | undefined, modelMeta?: CodexModelMetadata | undefined): Record<string, unknown> | null | undefined;
+declare function sanitizeCodexPayload(payload: Record<string, unknown> | null | undefined, modelMeta?: CodexModelMetadata | undefined, fastMode?: boolean): Record<string, unknown> | null | undefined;
 //#endregion
 //#region src/usage.d.ts
 declare function safeErrorMessage(error: unknown): string;
@@ -122,10 +132,12 @@ interface CodexQuotaSnapshot {
 type CodexQuotaResponse = {
   readonly ok: true;
   readonly quota: CodexQuotaSnapshot;
+  readonly fastMode?: boolean | undefined;
 } | {
   readonly ok: false;
   readonly error: string;
   readonly quota?: CodexQuotaSnapshot | undefined;
+  readonly fastMode?: boolean | undefined;
 };
 interface UsageFetcherOptions {
   readonly resolveCredentials: () => Promise<CodexResolvedCredentials>;
@@ -143,7 +155,7 @@ declare function createUsageFetcher(options: UsageFetcherOptions): {
 //#region src/index.d.ts
 export declare const name = "codex-subscription";
 export declare const inject: string[];
-export declare const LOG_FILE_NAME = "dsh-codex-subscription.log";
+export declare const LOG_FILE_NAME = "plugin.log";
 export declare const Config: any;
 export declare function apply(ctx: PluginContextLike, config?: Record<string, unknown>): void;
 export declare const __test: Readonly<{

package/lib/index.js

@@ -1,4 +1,4 @@
-import { appendFileSync, chmodSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { appendFileSync, chmodSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
 import z from "@deepseek-ai/schemastery";
 import { LlmError, resolveImageAttachmentAccess, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
@@ -13,7 +13,9 @@ const PROVIDER = "openai-codex";
 const DISPLAY_NAME = "Codex";
 const DEFAULT_CLIENT_VERSION = "0.163.0";
 const DEFAULT_CONTEXT_WINDOW = 872e3;
-const BACKUP_CACHE_FILE_NAME = ".dsh-models-cache-backup.json";
+const PLUGIN_CACHE_DIR_NAME = "cache/dsh-codex-subscription";
+const BACKUP_CACHE_FILE_NAME = "models-cache-backup.json";
+const RUNTIME_STATE_FILE_NAME = "runtime-state.json";
 const THINKING_LEVELS = [
 	"off",
 	"minimal",
@@ -35,6 +37,12 @@ function parseRawModelsCache(rawText) {
 	if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) throw new SyntaxError("models_cache.json root must be a JSON object");
 	return parsed;
 }
+function isSameModelsCatalogPayload(a, b) {
+	if (!a || !b) return false;
+	const { fetched_at: _fa, ...restA } = a;
+	const { fetched_at: _fb, ...restB } = b;
+	return JSON.stringify(restA) === JSON.stringify(restB);
+}
 function compareClientVersions(a, b) {
 	const parseParts = (ver) => typeof ver === "string" && ver.trim() !== "" ? ver.trim().split(/[^0-9]+/u).filter(Boolean).map((n) => Number.parseInt(n, 10)) : [];
 	const pa = parseParts(a);
@@ -74,6 +82,16 @@ function isVerbosity(value) {
 function isPositiveSafeInt(value) {
 	return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
 }
+function resolveFastServiceTier(entry) {
+	if (Array.isArray(entry.service_tiers)) {
+		const matched = entry.service_tiers.find((tier) => tier !== null && typeof tier === "object" && typeof tier.id === "string" && tier.id.trim() !== "" && (tier.id.trim() === "priority" || typeof tier.name === "string" && tier.name.trim().toLowerCase() === "fast"));
+		if (matched && typeof matched.id === "string") return matched.id.trim();
+		if (entry.service_tiers.length === 0 && Array.isArray(entry.additional_speed_tiers)) return entry.additional_speed_tiers.some((t) => typeof t === "string" && t.trim().toLowerCase() === "fast") ? "priority" : void 0;
+		return;
+	}
+	if (Array.isArray(entry.additional_speed_tiers) && entry.additional_speed_tiers.some((t) => typeof t === "string" && t.trim().toLowerCase() === "fast")) return "priority";
+	return "priority";
+}
 function parseModelsCache(rawCache, baseModels, disabledModels = [], contextWindows = {}) {
 	const disabledSet = new Set((Array.isArray(disabledModels) ? disabledModels : []).filter((id) => typeof id === "string").map((id) => id.trim()).filter(Boolean));
 	const clientVersion = typeof rawCache?.client_version === "string" && rawCache.client_version.trim() !== "" ? rawCache.client_version.trim() : DEFAULT_CLIENT_VERSION;
@@ -101,11 +119,13 @@ function parseModelsCache(rawCache, baseModels, disabledModels = [], contextWind
 		const supportVerbosity = entry.support_verbosity !== false;
 		const defaultVerbosity = isVerbosity(entry.default_verbosity) ? entry.default_verbosity : "low";
 		const defaultReasoningLevel = normalizeDefaultReasoningLevel(entry.default_reasoning_level, thinkingLevelMap);
+		const fastServiceTier = resolveFastServiceTier(entry);
 		metadataById.set(id, {
 			contextWindow: targetContextWindow,
 			supportVerbosity,
 			defaultVerbosity,
-			defaultReasoningLevel
+			defaultReasoningLevel,
+			fastServiceTier
 		});
 		models.push({
 			...base ?? {},
@@ -190,11 +210,15 @@ function buildCodexHeaders(existingHeaders, clientVersion = DEFAULT_CLIENT_VERSI
 	headers["User-Agent"] = buildCodexUserAgent(clientVersion);
 	return headers;
 }
-function sanitizeCodexPayload(payload, modelMeta) {
+function sanitizeCodexPayload(payload, modelMeta, fastMode = false) {
 	if (!payload || typeof payload !== "object") return payload;
 	const cleaned = { ...payload };
 	for (const field of FORBIDDEN_PAYLOAD_FIELDS) delete cleaned[field];
-	if (cleaned.service_tier !== "priority" && cleaned.service_tier !== "ultrafast") delete cleaned.service_tier;
+	if (fastMode) {
+		const tier = modelMeta === void 0 ? "priority" : modelMeta.fastServiceTier;
+		if (typeof tier === "string" && tier !== "") cleaned.service_tier = tier;
+		else delete cleaned.service_tier;
+	} else if (cleaned.service_tier !== "priority" && cleaned.service_tier !== "ultrafast") delete cleaned.service_tier;
 	const currentText = cleaned.text && typeof cleaned.text === "object" && !Array.isArray(cleaned.text) ? { ...cleaned.text } : void 0;
 	if (modelMeta?.supportVerbosity === false) {
 		if (currentText !== void 0) {
@@ -380,6 +404,10 @@ function resolveRealTargetPath(filePath) {
 	}
 }
 function writeFileAtomicSync(filePath, content) {
+	mkdirSync(dirname(filePath), {
+		recursive: true,
+		mode: 448
+	});
 	const targetPath = resolveRealTargetPath(filePath);
 	const tempPath = join(dirname(targetPath), `.${basename(targetPath)}.tmp-${process.pid}-${randomUUID()}`);
 	try {
@@ -552,12 +580,15 @@ function createAuthManager(options) {
 //#region src/index.ts
 const name = "codex-subscription";
 const inject = ["llm"];
-const LOG_FILE_NAME = "dsh-codex-subscription.log";
+const LOG_FILE_NAME = "plugin.log";
 const STREAM_IDLE_TIMEOUT_MS = 3e5;
 const MAX_REQUEST_IMAGE_BYTES = 20971520;
 const REQUEST_IMAGE_PIXEL_BUDGET = 4194304;
 const REQUEST_IMAGE_MAX_BYTES = 1048576;
 const MAX_LOG_FILE_BYTES = 524288;
+function resolvePluginCacheDir(codexHome) {
+	return join(codexHome, PLUGIN_CACHE_DIR_NAME);
+}
 function appendPluginLog(codexHome, ctx, level, event, detail) {
 	const line = `[${new Date().toISOString()}] [${level}] ${event} ${JSON.stringify(detail)}\n`;
 	if (level === "ERROR") {
@@ -567,7 +598,12 @@ function appendPluginLog(codexHome, ctx, level, event, detail) {
 		if (typeof ctx.logger?.warn === "function") ctx.logger.warn(`[dsh-codex-subscription] ${event}: ${JSON.stringify(detail)}`);
 	}
 	try {
-		const logPath = join(codexHome, LOG_FILE_NAME);
+		const cacheDir = resolvePluginCacheDir(codexHome);
+		mkdirSync(cacheDir, {
+			recursive: true,
+			mode: 448
+		});
+		const logPath = join(cacheDir, LOG_FILE_NAME);
 		try {
 			if (statSync(logPath).size > MAX_LOG_FILE_BYTES) {
 				const buf = readFileSync(logPath);
@@ -584,17 +620,31 @@ function appendPluginLog(codexHome, ctx, level, event, detail) {
 }
 function readBackupCache(codexHome) {
 	try {
-		return parseRawModelsCache(readFileSync(join(codexHome, BACKUP_CACHE_FILE_NAME), "utf8"));
+		return parseRawModelsCache(readFileSync(join(resolvePluginCacheDir(codexHome), BACKUP_CACHE_FILE_NAME), "utf8"));
 	} catch {
 		return;
 	}
 }
 function writeBackupCache(codexHome, raw) {
 	try {
-		writeFileAtomicSync(join(codexHome, BACKUP_CACHE_FILE_NAME), `${JSON.stringify(raw, null, 2)}\n`);
+		writeFileAtomicSync(join(resolvePluginCacheDir(codexHome), BACKUP_CACHE_FILE_NAME), `${JSON.stringify(raw, null, 2)}\n`);
+	} catch {}
+}
+function readPersistedFastMode(codexHome) {
+	try {
+		const raw = JSON.parse(readFileSync(join(resolvePluginCacheDir(codexHome), RUNTIME_STATE_FILE_NAME), "utf8"));
+		return typeof raw?.fastMode === "boolean" ? raw.fastMode : void 0;
+	} catch {
+		return;
+	}
+}
+function writePersistedFastMode(codexHome, fastMode) {
+	try {
+		writeFileAtomicSync(join(resolvePluginCacheDir(codexHome), RUNTIME_STATE_FILE_NAME), `${JSON.stringify({ fastMode }, null, 2)}\n`);
 	} catch {}
 }
 const Config = z.object({
+	fastMode: z.boolean().default(false).description("开启 Fast 极速模式（注入 service_tier: priority，最高 2x 推理速度，消耗更多订阅限额）").volatile(),
 	disabledModels: z.array(z.string()).default([...DEFAULT_DISABLED_MODELS]).description("在模型选择器中屏蔽的模型 slug 列表").volatile(),
 	contextWindows: z.dict(z.number()).default({}).description("按模型 slug 覆盖上下文窗口大小（tokens），未配置时默认使用 872000").volatile()
 });
@@ -632,8 +682,21 @@ function apply(ctx, config = {}) {
 	const baseModels = baseProvider.getModels();
 	const retryPolicy = resolveRetryPolicy(void 0, "codex-subscription retryPolicy");
 	const getCodexHome = () => resolveCodexHome();
+	const getConfigFastMode = () => Boolean(readVolatile(config.fastMode, false));
 	const getDisabledModels = () => readVolatile(config.disabledModels, DEFAULT_DISABLED_MODELS);
 	const getContextWindows = () => readVolatile(config.contextWindows, {});
+	let lastConfigFastMode = getConfigFastMode();
+	let fastModeOverride = readPersistedFastMode(getCodexHome());
+	const getEffectiveFastMode = () => fastModeOverride !== void 0 ? fastModeOverride : getConfigFastMode();
+	const setFastModeOverride = (nextFastMode, source) => {
+		const codexHome = getCodexHome();
+		fastModeOverride = nextFastMode;
+		writePersistedFastMode(codexHome, nextFastMode);
+		appendPluginLog(codexHome, ctx, "INFO", "fast_mode.updated", {
+			fastMode: nextFastMode,
+			source
+		});
+	};
 	const authManager = createAuthManager({
 		getCodexHome,
 		getClientVersion: () => ensureSnapshot().catalog.clientVersion,
@@ -671,7 +734,7 @@ function apply(ctx, config = {}) {
 			transport: "sse",
 			headers: buildCodexHeaders(rest.headers, catalog.clientVersion),
 			async onPayload(payload, requestModel) {
-				return sanitizeCodexPayload(await onPayload?.(payload, requestModel) ?? payload, modelMeta);
+				return sanitizeCodexPayload(await onPayload?.(payload, requestModel) ?? payload, modelMeta, getEffectiveFastMode());
 			}
 		};
 	}
@@ -749,14 +812,16 @@ function apply(ctx, config = {}) {
 						incomingFetchedAt: incomingRaw.fetched_at ?? null
 					});
 					else if (cachedRaw !== void 0 || !tryRestoreFromBackup({ diskVersion: incomingRaw.client_version ?? "unknown" }, incomingRaw.client_version)) {
-						setActiveRaw(incomingRaw);
-						writeBackupCache(codexHome, incomingRaw);
-						appendPluginLog(codexHome, ctx, "INFO", "catalog.load", {
-							cachePath,
-							clientVersion: incomingRaw.client_version ?? "0.163.0",
-							fetchedAt: incomingRaw.fetched_at ?? null,
-							rawModelCount: Array.isArray(incomingRaw.models) ? incomingRaw.models.length : 0
-						});
+						if (!isSameModelsCatalogPayload(cachedRaw, incomingRaw)) {
+							setActiveRaw(incomingRaw);
+							writeBackupCache(codexHome, incomingRaw);
+							appendPluginLog(codexHome, ctx, "INFO", "catalog.load", {
+								cachePath,
+								clientVersion: incomingRaw.client_version ?? "0.163.0",
+								fetchedAt: incomingRaw.fetched_at ?? null,
+								rawModelCount: Array.isArray(incomingRaw.models) ? incomingRaw.models.length : 0
+							});
+						}
 					}
 				} catch (error) {
 					handleReadError(error);
@@ -833,12 +898,26 @@ function apply(ctx, config = {}) {
 		if (typeof registerFetch !== "function") return;
 		const registerRoute = () => registerFetch.call(connection?.fetch, {
 			path: USAGE_ROUTE_PATH,
-			methods: ["GET"],
+			methods: ["GET", "POST"],
 			requestBody: "buffered",
 			fetch: async (request) => {
+				if (request.method === "POST") {
+					const body = await request.json().catch(() => null);
+					if (typeof body?.fastMode === "boolean") setFastModeOverride(body.fastMode, "ui");
+					return new Response(JSON.stringify({
+						ok: true,
+						fastMode: getEffectiveFastMode()
+					}), {
+						status: 200,
+						headers: { "content-type": "application/json" }
+					});
+				}
 				const force = new URL(request.url, "http://localhost").searchParams.get("force") === "1";
 				const result = await usageFetcher.getUsage(force);
-				return new Response(JSON.stringify(result), {
+				return new Response(JSON.stringify({
+					...result,
+					fastMode: getEffectiveFastMode()
+				}), {
 					status: 200,
 					headers: { "content-type": "application/json" }
 				});
@@ -850,6 +929,11 @@ function apply(ctx, config = {}) {
 	if (typeof ctx.inject === "function") ctx.inject(["connection"], mountUsageRoute);
 	else mountUsageRoute(ctx);
 	ctx.on?.("loader/volatile-update", () => {
+		const currentConfigFastMode = getConfigFastMode();
+		if (currentConfigFastMode !== lastConfigFastMode) {
+			lastConfigFastMode = currentConfigFastMode;
+			setFastModeOverride(currentConfigFastMode, "config");
+		}
 		ensureSnapshot();
 		ctx.llm.emitAdaptersUpdated?.();
 	});
@@ -879,4 +963,4 @@ const __test = Object.freeze({
 	createUsageFetcher
 });
 //#endregion
-export { BACKUP_CACHE_FILE_NAME, Config, LOG_FILE_NAME, __test, apply, inject, name };
+export { BACKUP_CACHE_FILE_NAME, Config, LOG_FILE_NAME, PLUGIN_CACHE_DIR_NAME, RUNTIME_STATE_FILE_NAME, __test, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lyogvce/dsh-codex-subscription",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "description": "复用本机 ~/.codex 订阅凭证与 models_cache.json 模型缓存，在 DSH 中通过 SSE 直连调用 Codex 模型。",
   "type": "module",
   "main": "./lib/index.js",