dsh-codex-subscription 1.2.2 → 1.3.0

package/lib/index.js

@@ -496,7 +496,7 @@ function openaiCodexSubscriptionProvider({ resolveSpeedMode = () => void 0 } = {
 }
 //#endregion
 //#region src/version.js
-const PACKAGE_VERSION = "1.2.2";
+const PACKAGE_VERSION = "1.3.0";
 const USER_AGENT = `dsh-codex-subscription/${PACKAGE_VERSION}`;
 //#endregion
 //#region src/codex-search.js
@@ -505,7 +505,7 @@ const CODEX_SEARCH_URL = "https://chatgpt.com/backend-api/codex/alpha/search";
 const DEFAULT_MODEL = "gpt-5.6-luna";
 const MAX_OUTPUT_TOKENS = 4096;
 const MAX_SOURCE_DATE = 64;
-const record$2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const record$3 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const nonEmpty$1 = (value) => typeof value === "string" && value.length > 0 ? value : void 0;
 const displayText = (value) => {
 	const text = nonEmpty$1(value)?.replace(/\s+/gu, " ").trim();
@@ -518,7 +518,7 @@ const boundedDisplayText = (value, maximum) => {
 	return `${text.slice(0, maximum - 1)}…`;
 };
 function sourceOf(value) {
-	if (!record$2(value)) return void 0;
+	if (!record$3(value)) return void 0;
 	const url = nonEmpty$1(value.url);
 	if (url === void 0) return void 0;
 	let parsed;
@@ -539,7 +539,7 @@ function sourceOf(value) {
 	};
 }
 function parseSearchResponse(value) {
-	if (!record$2(value) || !Array.isArray(value.results)) throw new Error("Codex returned a malformed search response");
+	if (!record$3(value) || !Array.isArray(value.results)) throw new Error("Codex returned a malformed search response");
 	const seen = /* @__PURE__ */ new Set();
 	const sources = [];
 	for (const result of value.results ?? []) {
@@ -631,7 +631,7 @@ const PNG_SIGNATURE = Buffer.from([
 	26,
 	10
 ]);
-const record$1 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const record$2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 const nonEmpty = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 function encodedLimit(decodedBytes) {
 	return Math.ceil(decodedBytes / 3) * 4;
@@ -732,7 +732,7 @@ function imageOutputSchema() {
 }
 function responseMetadata(value) {
 	const data = Array.isArray(value?.data) ? value.data[0] : void 0;
-	const encoded = record$1(data) ? data.b64_json : void 0;
+	const encoded = record$2(data) ? data.b64_json : void 0;
 	if (typeof encoded !== "string") throw new Error("Codex returned no image data");
 	return {
 		encoded,
@@ -865,11 +865,11 @@ async function createSubscriptionDiagnostics({ auth, preferences }) {
 //#region src/usage.js
 const CODEX_USAGE_URL = "https://chatgpt.com/backend-api/wham/usage";
 const DEFAULT_TTL_MS = 6e4;
-const DEFAULT_TIMEOUT_MS = 15e3;
-const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const DEFAULT_TIMEOUT_MS$1 = 15e3;
+const record$1 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
 function windowOf(value) {
 	if (value === void 0 || value === null) return void 0;
-	if (!record(value)) throw new Error("Codex returned a malformed rate-limit window");
+	if (!record$1(value)) throw new Error("Codex returned a malformed rate-limit window");
 	const used = value.used_percent;
 	const seconds = value.limit_window_seconds;
 	if (!Number.isFinite(used) || used < 0 || used > 100) throw new Error("Codex returned an invalid used percentage");
@@ -884,7 +884,7 @@ function windowOf(value) {
 }
 function limitOf(id, name, value) {
 	if (value === void 0 || value === null) return void 0;
-	if (!record(value)) throw new Error("Codex returned malformed rate-limit details");
+	if (!record$1(value)) throw new Error("Codex returned malformed rate-limit details");
 	const windows = [windowOf(value.primary_window), windowOf(value.secondary_window)].filter(Boolean);
 	return windows.length === 0 ? void 0 : {
 		id,
@@ -903,7 +903,7 @@ function epochSeconds(value, label) {
 }
 function creditsOf(value) {
 	if (value === void 0 || value === null) return void 0;
-	if (!record(value) || typeof value.has_credits !== "boolean" || typeof value.unlimited !== "boolean") throw new Error("Codex returned malformed credit details");
+	if (!record$1(value) || typeof value.has_credits !== "boolean" || typeof value.unlimited !== "boolean") throw new Error("Codex returned malformed credit details");
 	if (!value.has_credits) return void 0;
 	return {
 		unlimited: value.unlimited,
@@ -912,10 +912,10 @@ function creditsOf(value) {
 }
 function individualOf(value) {
 	if (value === void 0 || value === null) return void 0;
-	if (!record(value)) throw new Error("Codex returned malformed spend control");
+	if (!record$1(value)) throw new Error("Codex returned malformed spend control");
 	const item = value.individual_limit;
 	if (item === void 0 || item === null) return void 0;
-	if (!record(item) || !Number.isFinite(item.remaining_percent) || item.remaining_percent < 0 || item.remaining_percent > 100) throw new Error("Codex returned an invalid individual-limit percentage");
+	if (!record$1(item) || !Number.isFinite(item.remaining_percent) || item.remaining_percent < 0 || item.remaining_percent > 100) throw new Error("Codex returned an invalid individual-limit percentage");
 	const resetsAt = epochSeconds(item.reset_at, "individual-limit reset time");
 	return {
 		limit: decimal(item.limit, "individual limit"),
@@ -926,19 +926,19 @@ function individualOf(value) {
 }
 function spendControlReachedOf(value) {
 	if (value === void 0 || value === null) return void 0;
-	if (!record(value)) throw new Error("Codex returned malformed spend control");
+	if (!record$1(value)) throw new Error("Codex returned malformed spend control");
 	if (value.reached === void 0 || value.reached === null) return void 0;
 	if (typeof value.reached !== "boolean") throw new Error("Codex returned an invalid spend-control state");
 	return value.reached;
 }
 function resetCreditsOf(value) {
 	if (value === void 0 || value === null) return void 0;
-	if (!record(value) || !Number.isSafeInteger(value.available_count) || value.available_count < 0) throw new Error("Codex returned malformed reset credit details");
+	if (!record$1(value) || !Number.isSafeInteger(value.available_count) || value.available_count < 0) throw new Error("Codex returned malformed reset credit details");
 	return { availableCount: value.available_count };
 }
 /** Reduce the provider payload to a browser-safe quota projection. */
 function parseCodexUsage(value) {
-	if (!record(value)) throw new Error("Codex returned a malformed usage response");
+	if (!record$1(value)) throw new Error("Codex returned a malformed usage response");
 	const rateLimits = [];
 	const seenLimitIds = /* @__PURE__ */ new Set();
 	const addLimit = (limit) => {
@@ -949,7 +949,7 @@ function parseCodexUsage(value) {
 	addLimit(limitOf("codex", "Codex", value.rate_limit));
 	if (value.additional_rate_limits !== void 0 && value.additional_rate_limits !== null && !Array.isArray(value.additional_rate_limits)) throw new Error("Codex returned malformed additional rate limits");
 	for (const entry of value.additional_rate_limits ?? []) {
-		if (!record(entry) || typeof entry.metered_feature !== "string" || entry.metered_feature.length === 0) throw new Error("Codex returned a malformed additional rate limit");
+		if (!record$1(entry) || typeof entry.metered_feature !== "string" || entry.metered_feature.length === 0) throw new Error("Codex returned a malformed additional rate limit");
 		if (entry.limit_name !== void 0 && entry.limit_name !== null && typeof entry.limit_name !== "string") throw new Error("Codex returned an invalid additional rate-limit name");
 		addLimit(limitOf(entry.metered_feature, entry.limit_name || void 0, entry.rate_limit));
 	}
@@ -966,7 +966,7 @@ function parseCodexUsage(value) {
 		...resetCredits === void 0 ? {} : { resetCredits }
 	};
 }
-const requestSignal = (signal, timeoutMs) => {
+const requestSignal$1 = (signal, timeoutMs) => {
 	const timeout = AbortSignal.timeout(timeoutMs);
 	return signal === void 0 ? timeout : AbortSignal.any([signal, timeout]);
 };
@@ -981,7 +981,7 @@ function createCodexUsageReader(options) {
 	const fetchUsage = options.fetch ?? fetch;
 	const now = options.now ?? Date.now;
 	const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
-	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS$1;
 	let cached;
 	let inFlight;
 	let generation = 0;
@@ -1001,7 +1001,7 @@ function createCodexUsageReader(options) {
 				"cache-control": "no-store",
 				"user-agent": USER_AGENT
 			},
-			signal: requestSignal(signal, timeoutMs)
+			signal: requestSignal$1(signal, timeoutMs)
 		});
 		if (!response.ok) throw new Error(response.status === 401 || response.status === 403 ? "ChatGPT sign-in needs to be renewed" : `ChatGPT usage request failed (HTTP ${response.status})`);
 		let value;
@@ -1037,6 +1037,185 @@ function createCodexUsageReader(options) {
 	});
 }
 //#endregion
+//#region src/reset-credits.js
+const CODEX_RESET_CREDITS_URL = "https://chatgpt.com/backend-api/wham/rate-limit-reset-credits";
+const CODEX_RESET_CONSUME_URL = `${CODEX_RESET_CREDITS_URL}/consume`;
+const RESET_CONFIRM_PHRASE = "USE RESET";
+const DEFAULT_CONFIRM_DELAY_MS = 5e3;
+const DEFAULT_CHALLENGE_TTL_MS = 6e4;
+const DEFAULT_TIMEOUT_MS = 15e3;
+const MAX_COPY_LENGTH = 240;
+const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const requestSignal = (signal, timeoutMs) => {
+	const timeout = AbortSignal.timeout(timeoutMs);
+	return signal === void 0 ? timeout : AbortSignal.any([signal, timeout]);
+};
+function safeCopy(value) {
+	return typeof value === "string" && value.length > 0 ? value.slice(0, MAX_COPY_LENGTH) : void 0;
+}
+function credentialsOf(auth, credential) {
+	const access = auth?.auth?.apiKey;
+	const accountId = credential?.type === "oauth" ? credential.accountId : void 0;
+	if (typeof access !== "string" || access.length === 0 || typeof accountId !== "string" || accountId.length === 0) throw new Error("ChatGPT subscription is not signed in");
+	return {
+		access,
+		accountId
+	};
+}
+function parseDetails(value, now) {
+	if (!record(value) || !Number.isSafeInteger(value.available_count) || value.available_count < 0 || !Array.isArray(value.credits)) throw new Error("ChatGPT returned malformed quota reset details");
+	if (value.available_count === 0) throw new Error("No quota reset is available");
+	const available = value.credits.filter((credit) => record(credit) && typeof credit.id === "string" && credit.id.length > 0 && credit.id.length <= 256 && typeof credit.status === "string" && credit.status.toLowerCase() === "available").map((credit) => {
+		const expiresAt = credit.expires_at === void 0 || credit.expires_at === null ? void 0 : credit.expires_at * 1e3;
+		if (expiresAt !== void 0 && (!Number.isSafeInteger(credit.expires_at) || credit.expires_at <= 0)) throw new Error("ChatGPT returned malformed quota reset details");
+		return {
+			credit,
+			expiresAt
+		};
+	}).filter(({ expiresAt }) => expiresAt === void 0 || expiresAt > now).sort((a, b) => (a.expiresAt ?? Number.MAX_SAFE_INTEGER) - (b.expiresAt ?? Number.MAX_SAFE_INTEGER));
+	if (available.length === 0) throw new Error("No usable quota reset is available");
+	return {
+		availableCount: value.available_count,
+		creditId: available[0].credit.id,
+		title: safeCopy(available[0].credit.title),
+		description: safeCopy(available[0].credit.description),
+		creditExpiresAt: available[0].expiresAt
+	};
+}
+function parseConsumeResult(value) {
+	if (!record(value) || ![
+		"reset",
+		"nothing_to_reset",
+		"no_credit",
+		"already_redeemed"
+	].includes(value.code)) throw new Error("ChatGPT returned an unreadable quota reset response");
+	const windowsReset = Array.isArray(value.windows_reset) ? value.windows_reset.filter((item) => typeof item === "string").slice(0, 16) : [];
+	return {
+		code: value.code,
+		windowsReset
+	};
+}
+function quotaIsExhausted(usage) {
+	return Array.isArray(usage?.rateLimits) && usage.rateLimits.some((limit) => limit?.id !== "code_review" && Array.isArray(limit?.windows) && limit.windows.some((window) => Number.isFinite(window?.usedPercent) && window.usedPercent >= 100));
+}
+/**
+* Host-only reset redemption. The browser receives an opaque, short-lived
+* challenge; account ids, bearer tokens, credit ids, and idempotency keys stay
+* in memory on the host.
+*/
+function createCodexResetCreditService(options) {
+	const getAuth = options.getAuth;
+	const readCredential = options.readCredential;
+	const usageReader = options.usageReader;
+	const fetchReset = options.fetch ?? fetch;
+	const now = options.now ?? Date.now;
+	const randomUUID$1 = options.randomUUID ?? randomUUID;
+	const confirmDelayMs = options.confirmDelayMs ?? DEFAULT_CONFIRM_DELAY_MS;
+	const challengeTtlMs = options.challengeTtlMs ?? DEFAULT_CHALLENGE_TTL_MS;
+	const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const challenges = /* @__PURE__ */ new Map();
+	const resolveCredentials = async (signal) => credentialsOf(await getAuth({ signal }), await readCredential({ signal }));
+	return Object.freeze({
+		async prepare({ signal } = {}) {
+			const { access, accountId } = await resolveCredentials(signal);
+			const response = await fetchReset(CODEX_RESET_CREDITS_URL, {
+				method: "GET",
+				redirect: "error",
+				headers: {
+					authorization: `Bearer ${access}`,
+					"chatgpt-account-id": accountId,
+					accept: "application/json",
+					"cache-control": "no-store",
+					"user-agent": USER_AGENT
+				},
+				signal: requestSignal(signal, timeoutMs)
+			});
+			if (!response.ok) throw new Error(response.status === 401 || response.status === 403 ? "ChatGPT sign-in needs to be renewed" : `ChatGPT quota reset request failed (HTTP ${response.status})`);
+			let raw;
+			try {
+				raw = await response.json();
+			} catch {
+				throw new Error("ChatGPT returned unreadable quota reset details");
+			}
+			const details = parseDetails(raw, now());
+			const preparedAt = now();
+			const readyAt = preparedAt + confirmDelayMs;
+			const expiresAt = Math.min(preparedAt + challengeTtlMs, details.creditExpiresAt ?? Number.MAX_SAFE_INTEGER);
+			if (expiresAt <= readyAt) throw new Error("The available quota reset expires too soon");
+			const challengeId = randomUUID$1();
+			challenges.set(challengeId, {
+				state: "prepared",
+				accountId,
+				creditId: details.creditId,
+				redeemRequestId: randomUUID$1(),
+				readyAt,
+				expiresAt
+			});
+			return {
+				challengeId,
+				availableCount: details.availableCount,
+				confirmPhrase: RESET_CONFIRM_PHRASE,
+				readyAt,
+				expiresAt,
+				...details.title === void 0 ? {} : { title: details.title },
+				...details.description === void 0 ? {} : { description: details.description }
+			};
+		},
+		async consume({ challengeId, phrase, signal } = {}) {
+			const challenge = typeof challengeId === "string" ? challenges.get(challengeId) : void 0;
+			if (challenge === void 0) throw new Error("This quota reset confirmation is no longer valid");
+			if (challenge.state === "pending") throw new Error("This quota reset is already in progress");
+			if (now() < challenge.readyAt) throw new Error("Wait before confirming this quota reset");
+			if (now() > challenge.expiresAt) {
+				challenges.delete(challengeId);
+				throw new Error("This quota reset confirmation is no longer valid");
+			}
+			if (phrase !== "USE RESET") throw new Error("The quota reset confirmation phrase does not match");
+			challenge.state = "pending";
+			try {
+				if (!quotaIsExhausted(await usageReader.read({
+					force: true,
+					signal
+				}))) throw new Error("The current Codex quota is not exhausted");
+				const { access, accountId } = await resolveCredentials(signal);
+				if (accountId !== challenge.accountId) throw new Error("The signed-in ChatGPT account changed");
+				const response = await fetchReset(CODEX_RESET_CONSUME_URL, {
+					method: "POST",
+					redirect: "error",
+					headers: {
+						authorization: `Bearer ${access}`,
+						"chatgpt-account-id": accountId,
+						accept: "application/json",
+						"content-type": "application/json",
+						"cache-control": "no-store",
+						"user-agent": USER_AGENT
+					},
+					body: JSON.stringify({
+						redeem_request_id: challenge.redeemRequestId,
+						credit_id: challenge.creditId
+					}),
+					signal: requestSignal(signal, timeoutMs)
+				});
+				if (!response.ok) throw new Error(response.status === 401 || response.status === 403 ? "ChatGPT sign-in needs to be renewed" : `ChatGPT quota reset request failed (HTTP ${response.status})`);
+				let raw;
+				try {
+					raw = await response.json();
+				} catch {
+					throw new Error("ChatGPT returned an unreadable quota reset response");
+				}
+				const result = parseConsumeResult(raw);
+				usageReader.clear();
+				return result;
+			} finally {
+				challenges.delete(challengeId);
+			}
+		},
+		clear() {
+			challenges.clear();
+		}
+	});
+}
+//#endregion
 //#region src/index.js
 const name = "codex-subscription";
 const inject = [
@@ -1066,7 +1245,7 @@ const publicError = (code, message) => ({
 		details: { issues: [] }
 	}
 });
-function createSubscriptionRpcHandler({ authHandler, usageReader, preferences, diagnosticsReader }) {
+function createSubscriptionRpcHandler({ authHandler, usageReader, resetCreditService, preferences, diagnosticsReader }) {
 	return async (endpoint, payload, signal) => {
 		if (endpoint === "diagnostics") try {
 			signal.throwIfAborted();
@@ -1120,8 +1299,40 @@ function createSubscriptionRpcHandler({ authHandler, usageReader, preferences, d
 			const message = error instanceof Error && known.has(error.message) ? error.message : "Could not read ChatGPT usage";
 			return publicError("internal", message);
 		}
+		if (endpoint === "reset-credit/prepare" || endpoint === "reset-credit/consume") try {
+			signal.throwIfAborted();
+			return {
+				ok: true,
+				value: endpoint === "reset-credit/prepare" ? await resetCreditService.prepare({ signal }) : await resetCreditService.consume({
+					challengeId: payload?.challengeId,
+					phrase: payload?.phrase,
+					signal
+				})
+			};
+		} catch (error) {
+			if (signal.aborted) throw error;
+			const known = /* @__PURE__ */ new Set([
+				"ChatGPT subscription is not signed in",
+				"ChatGPT sign-in needs to be renewed",
+				"No quota reset is available",
+				"No usable quota reset is available",
+				"The available quota reset expires too soon",
+				"This quota reset confirmation is no longer valid",
+				"This quota reset is already in progress",
+				"Wait before confirming this quota reset",
+				"The quota reset confirmation phrase does not match",
+				"The current Codex quota is not exhausted",
+				"The signed-in ChatGPT account changed"
+			]);
+			const fallback = endpoint === "reset-credit/prepare" ? "Could not prepare a quota reset" : "Could not use the quota reset";
+			const message = error instanceof Error && known.has(error.message) ? error.message : fallback;
+			return publicError("internal", message);
+		}
 		const result = await authHandler(endpoint, payload, signal);
-		if (endpoint === "logout" && result.ok === true) usageReader.clear();
+		if (endpoint === "logout" && result.ok === true) {
+			usageReader.clear();
+			resetCreditService.clear();
+		}
 		return result;
 	};
 }
@@ -1231,9 +1442,15 @@ function apply(ctx) {
 		getAuth: resolveAuth,
 		readCredential: (options) => store.read(PROVIDER, options)
 	});
+	const resetCreditService = createCodexResetCreditService({
+		getAuth: resolveAuth,
+		readCredential: (options) => store.read(PROVIDER, options),
+		usageReader
+	});
 	const handler = createSubscriptionRpcHandler({
 		authHandler: createCodexRpcHandler(coordinator, { openExternal: openCodexAuthUrl }),
 		usageReader,
+		resetCreditService,
 		preferences,
 		diagnosticsReader: () => createSubscriptionDiagnostics({
 			auth,
@@ -1243,4 +1460,4 @@ function apply(ctx) {
 	ctx.effect(() => ctx.connection.rpc.handle(CHANNEL, handler, { authority: "loopback" }), "codex-subscription: loopback account RPC");
 }
 //#endregion
-export { CODEX_IMAGE_GENERATION_URL, CODEX_IMAGE_TOOL_NAME, CODEX_USAGE_URL, CodexLoginCoordinator, DshOAuthCredentialStore, apply, assertCodexAuthUrl, commandForCodexAuthUrl, createCodexAuthService, createCodexImageTool, createCodexRpcHandler, createCodexUsageReader, createSearchProviderSwitcher, createSubscriptionDiagnostics, createSubscriptionRpcHandler, decodeCodexPng, inject, name, openCodexAuthUrl, parseCodexUsage };
+export { CODEX_IMAGE_GENERATION_URL, CODEX_IMAGE_TOOL_NAME, CODEX_RESET_CONSUME_URL, CODEX_RESET_CREDITS_URL, CODEX_USAGE_URL, CodexLoginCoordinator, DshOAuthCredentialStore, RESET_CONFIRM_PHRASE, apply, assertCodexAuthUrl, commandForCodexAuthUrl, createCodexAuthService, createCodexImageTool, createCodexResetCreditService, createCodexRpcHandler, createCodexUsageReader, createSearchProviderSwitcher, createSubscriptionDiagnostics, createSubscriptionRpcHandler, decodeCodexPng, inject, name, openCodexAuthUrl, parseCodexUsage };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-codex-subscription",
-  "version": "1.2.2",
-  "description": "ChatGPT and Codex subscriptions for DeepSeek Harness with OAuth login, image generation, quota, and subscription web search",
+  "version": "1.3.0",
+  "description": "Use ChatGPT and Codex subscriptions in DeepSeek Harness with OAuth, quota, safe resets, web search, images, and Fast mode",
   "type": "module",
   "main": "./lib/index.js",
   "exports": {
@@ -14,7 +14,7 @@
     "lib/*.js",
     "cordis.patch.yml",
     "README.md",
-    "README.en.md",
+    "README.zh-CN.md",
     "DIRECTORY.md",
     "AGENTS.md",
     "compatibility.json",
@@ -52,6 +52,8 @@
     "chatgpt-plus",
     "subscription",
     "quota",
+    "quota-reset",
+    "fast-mode",
     "usage",
     "oauth",
     "web-search",

package/README.en.md

@@ -1,210 +0,0 @@
-<div align="center">
-
-# DSH Codex Subscription
-
-**Use your ChatGPT / Codex subscription directly in DeepSeek Harness**
-
-No OpenAI API key or Codex CLI. Models, search, quota, and image generation stay inside DSH.
-
-[![CI](https://github.com/WSL043/dsh-codex-subscription/actions/workflows/ci.yml/badge.svg)](https://github.com/WSL043/dsh-codex-subscription/actions/workflows/ci.yml)
-[![npm](https://img.shields.io/npm/v/dsh-codex-subscription?logo=npm&label=npm)](https://www.npmjs.com/package/dsh-codex-subscription)
-[![npm downloads](https://img.shields.io/npm/dt/dsh-codex-subscription?logo=npm&label=downloads)](https://www.npmjs.com/package/dsh-codex-subscription)
-[![MIT](https://img.shields.io/badge/license-MIT-111111.svg)](LICENSE)
-[![Star](https://img.shields.io/github/stars/WSL043/dsh-codex-subscription?style=flat&logo=github&label=Star)](https://github.com/WSL043/dsh-codex-subscription/stargazers)
-
-[Three-step start](#three-step-start) · [Agent install](#let-an-agent-install-it-recommended) · [Update and uninstall](#update-and-uninstall) · [简体中文](https://github.com/WSL043/dsh-codex-subscription/blob/main/README.md)
-
-</div>
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/readme-hero-en.webp" width="900" alt="Your Codex subscription inside DSH: subscription models, web search, live quota, and image generation">
-</p>
-
-## Three-step start
-
-1. **Install the plugin.** On Windows, open PowerShell and run the line below. Existing `dsh` and DSH-Portable users can use the standard command that follows.
-
-   ```powershell
-   irm 'https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1' | iex
-   ```
-
-2. **Sign in.** Restart DSH yourself, open **Settings -> Codex**, and choose browser sign-in. No Codex CLI and no pasted token are required.
-3. **Use Codex.** Select a Codex model. Quota, subscription search, image generation, and Fast mode remain inside DSH.
-
-With an existing `dsh` command, install with:
-
-```sh
-dsh plugin --profile web add dsh-codex-subscription
-```
-
-From a DSH-Portable product folder, run `./dsh plugin ...` (`.\dsh.exe plugin ...` in Windows PowerShell). See below for the complete official npm, Agent, update, and uninstall routes.
-
-## Why this plugin
-
-| Capability | What you get |
-| --- | --- |
-| **Subscription models** | Sign in to ChatGPT and use Codex without an OpenAI API key or Codex CLI |
-| **Recoverable and diagnosable** | Sign-in state reconciles automatically; Settings can create a support report without credentials or account identifiers |
-| **Visible quota** | Keep backend-provided standard Codex, Spark, and other limits separate |
-| **Subscription search** | Explicitly choose DSH default search or Codex subscription search |
-| **Codex image generation** | Describe an image in a DSH conversation and view the generated result in that session |
-| **Fast mode (Beta)** | Switch between Standard and Fast directly in the composer |
-
-These capabilities reuse the same local ChatGPT sign-in. Subscription routing failures stay visible and never silently switch to another paid route.
-
-## Product screen
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/settings-focus-en.png" width="820" alt="Codex subscription settings in DeepSeek Harness">
-</p>
-
-<details>
-<summary>View the complete settings screen</summary>
-
-![Complete Codex subscription settings in DeepSeek Harness](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/settings-en.png)
-
-</details>
-
-## Prepare DSH
-
-This plugin is currently compatible through DeepSeek Harness `0.1.1-rc.2` and requires a ChatGPT account that currently has Codex access.
-
-- Do not want to configure Node.js? Use [DSH-Portable](https://github.com/WSL043/DSH-Portable), a community desktop distribution with portable and installed editions for Windows plus desktop packages for macOS and Linux.
-- Prefer the official route? Follow the [DeepSeek Harness run guide](https://github.com/deepseek-ai/deepseek-harness#run).
-
-## Install
-
-### Let an Agent install it (recommended)
-
-Send this link directly to your Agent:
-
-**[Agent install, update, and uninstall guide](https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/AGENTS.md)**
-
-```text
-https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/AGENTS.md
-```
-
-The guide includes verification steps and tells the Agent to preserve the DSH profile, sign-in, and other plugins.
-
-### Manual Windows install
-
-Open PowerShell and paste this one line:
-
-```powershell
-irm 'https://github.com/WSL043/dsh-codex-subscription/releases/latest/download/dsh-codex-setup.ps1' | iex
-```
-
-The lightweight setup checks the current folder, the system command, common locations, and any running official DSH or
-[DSH-Portable](https://github.com/WSL043/DSH-Portable), then invokes the official `plugin add`
-operation once. It does not recursively scan disks, install pnpm, create a resident command, snapshot a
-profile, or download the plugin twice. It needs no administrator access and never restarts DSH. Only
-when no existing DSH is found does it use the official npm route pinned to `0.1.1-rc.2`; the setup warns
-that first-time dependency resolution can take a while.
-
-<details>
-<summary>Official npm route (Node.js installed)</summary>
-
-The official `npx @deepseek-ai/dsh web` command does not create a global `dsh` command. Keep the full `npx` prefix when installing the plugin:
-
-```sh
-npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web add dsh-codex-subscription
-npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web list dsh-codex-subscription --depth 0
-npx -y @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
-```
-
-</details>
-
-<details>
-<summary>An existing <code>dsh</code> command or a DSH-Portable folder</summary>
-
-```sh
-dsh plugin --profile web add dsh-codex-subscription
-dsh plugin --profile web list dsh-codex-subscription --depth 0
-dsh --profile web --dump-config
-```
-
-For DSH-Portable, replace `dsh` with `./dsh` (`.\dsh.exe` in PowerShell). The plugin list should contain
-one `dsh-codex-subscription`, and the config should contain one `codex-subscription` entry.
-
-</details>
-
-Restart DSH manually after installation, then:
-
-1. Open **Settings -> Codex**.
-2. Sign in with a ChatGPT account that has Codex access.
-3. Choose a search source.
-4. Select a Codex model.
-
-## Features
-
-- ChatGPT OAuth sign-in with credentials kept on the host;
-- Codex models and image generation directly inside DSH conversations;
-- A clear choice between DSH default search and Codex subscription search;
-- Actual backend-provided quota, reset time, and freshness;
-- Separate standard Codex, Codex-Spark, Credits, and other independent limits;
-- Optional composer quota for the selected Codex model (Beta, off by default);
-- Standard or Fast mode for supported Codex models directly in the composer (Beta);
-- A copyable support report in Settings that excludes OAuth credentials, account identifiers, and authorization timestamps;
-- Visible errors when subscription routing is unavailable, with no silent paid fallback.
-
-### Composer quota
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/WSL043/dsh-codex-subscription/main/docs/assets/composer-quota-en.png" width="800" alt="Codex quota inside the composer">
-</p>
-
-The compact percentage appears only for a selected Codex model. Standard Codex uses the lowest remaining
-window returned by the service; Spark uses its independent quota. The plugin does not hard-code a
-“5-hour + weekly” layout or invent Credits and spending caps that the service did not return.
-
-### Composer speed (Beta)
-
-With a supported Codex model selected, open the composer's model menu to choose Standard or Fast.
-Standard adds no icon; only Fast shows a lightning icon before the model name. Spark does not show the speed entry. Fast mode increases speed and uses more Credits;
-see the [OpenAI Codex Speed documentation](https://learn.chatgpt.com/docs/agent-configuration/speed) for the current rules.
-
-## Update and uninstall
-
-On Windows, rerun the one-line setup above to update. For the official npm route, use:
-
-```sh
-npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web update dsh-codex-subscription
-npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web list dsh-codex-subscription --depth 0
-npx -y @deepseek-ai/dsh@0.1.1-rc.2 --profile web --dump-config
-npx -y @deepseek-ai/dsh@0.1.1-rc.2 plugin --profile web remove dsh-codex-subscription
-```
-
-These operations preserve the DSH profile, other plugins, and saved sign-in.
-
-<details>
-<summary>Update or uninstall with an existing <code>dsh</code> command</summary>
-
-```sh
-dsh plugin --profile web update dsh-codex-subscription
-dsh plugin --profile web list dsh-codex-subscription --depth 0
-dsh --profile web --dump-config
-dsh plugin --profile web remove dsh-codex-subscription
-```
-
-</details>
-
-From a DSH-Portable folder, replace `dsh` above with `.\dsh.exe`.
-
-## Troubleshooting
-
-- **`dsh` is not recognized:** the official npm route does not create a global `dsh` command; use the complete `npx -y @deepseek-ai/dsh@0.1.1-rc.2 ...` command above;
-- **`dsh.exe` is not recognized:** that file is not in the current folder; enter the DSH-Portable folder first or use the one-line Windows setup;
-- **DSH-Portable is not found:** enter its folder and rerun setup, or run `.\dsh.exe plugin --profile web add dsh-codex-subscription` directly;
-- **More than one DSH exists:** the one-line setup combines running copies with Portable folders detected in common locations; enter its number. For an Agent, use the intended folder or pass `-DshPath` explicitly;
-- **Setup still fails:** send the Agent guide above to an Agent. Do not delete the profile or change the system PATH to force an install.
-- **Need to report a problem:** generate a **Support diagnostics** report at the bottom of Settings, then open the [bug report form](https://github.com/WSL043/dsh-codex-subscription/issues/new?template=install-problem.yml). The form collects exact DSH/plugin versions and reproduction steps. The generated report excludes credentials and account identifiers; still do not attach sign-in URLs, authorization codes, or browser callback addresses.
-
-The ChatGPT Codex backend and DSH can change independently. This community project is not affiliated with or endorsed by DeepSeek or OpenAI.
-
-Use the [bug report form](https://github.com/WSL043/dsh-codex-subscription/issues/new?template=install-problem.yml) for project feedback.
-For DSH plugin discussion, visit [DeepSeek Harness Discussions](https://github.com/deepseek-ai/deepseek-harness/discussions).
-Read [SECURITY.md](SECURITY.md) before reporting sensitive issues.
-
-If this project is useful, the [Star button](https://github.com/WSL043/dsh-codex-subscription/stargazers) helps more DSH users find it.
-
-[简体中文](README.md) · [MIT](LICENSE)