dsh-codearts 0.2.1 → 0.4.0

package/lib/index.mjs

@@ -1,4 +1,4 @@
-import { _ as CodeArtsAccountStore, a as SNAP_HOST, b as codeartsAuthPath, c as fetchCallerIdentity, d as maxTokensCeilingFor, f as prepareChatBody, g as isBenefitModel, h as filterEnabledModels, i as refreshCatalog, l as fetchModels, m as FALLBACK_CODEARTS_MODELS, n as codeartsUsagePath, o as canonicalModel, p as CodeArtsCatalog, r as discoverModels, s as chatStream, t as CodeArtsUsageTracker, u as isConcurrencyCap, v as CodeArtsCredentialStore, x as startLogin, y as codeartsAccountsPath } from "./usage-ClRZWUS4.mjs";
+import { C as codeartsAccountsPath, S as CodeArtsCredentialStore, T as startLogin, _ as CodeArtsCatalog, a as SNAP_HOST, b as isBenefitModel, c as claimBenefit, d as fetchModels, f as isConcurrencyCap, g as signedGet, h as prepareChatBody, i as refreshCatalog, l as degradeTokenCeiling, m as maxTokensCeilingFor, n as codeartsUsagePath, o as canonicalModel, p as isParamInvalidFrame, r as discoverModels, s as chatStream, t as CodeArtsUsageTracker, u as fetchCallerIdentity, v as FALLBACK_CODEARTS_MODELS, w as codeartsAuthPath, x as CodeArtsAccountStore, y as filterEnabledModels } from "./usage-3W88T_H1.mjs";
 import z from "@deepseek-ai/schemastery";
 import { randomBytes, timingSafeEqual } from "node:crypto";
 import { createServer } from "node:http";
@@ -136,6 +136,227 @@ var CodeArtsAccountPool = class {
 	}
 };
 //#endregion
+//#region src/credits.ts
+/**
+* CodeArts 积分与额度。
+*
+* 老结论「CodeArts 没有额度接口」是**错的**。2026-10-10 从官方 CodeArts Agent
+* 客户端（`<安装目录>/resources/app/extensions/vscode-codebot/out/extension.js`）
+* 里挖出它自己的接口清单，并逐条实测通过：
+*
+*   GET {SNAP_HOST}/snap-manager/v1/statistics/plugin
+*       积分体系：套餐名/状态、总量、已用、剩余、即将过期、额度周期（重置日）
+*   GET https://opengw.developer.huaweicloud.com/api/v1/user/tokens/balance
+*       日/月 token 额度与余额
+*
+* 鉴权必须带 AK/SK 签名（SDK-HMAC-SHA256）。官方客户端那里只写了 `x-auth-token`，
+* 是因为它走 IDE 内部的请求通道；我们直连时只带 `x-auth-token` 会被 APIG 拒掉：
+* `401 APIG.0301 decrypt token fail`（实测三种组合，只有签名那一路 200）。
+*
+* 卡片每次刷新都会问一次状态，所以这里带 TTL 缓存 + 单飞：命中缓存不打上游，
+* 失败也缓存一小段，免得上游抽风时每次刷新都要等一次超时。
+*
+* @module dsh-codearts/credits
+*/
+/** 福利网关：token 余额接口在这里（与 benefit/claim、gateway/config 同一个 host）。 */
+const BENEFIT_GATEWAY_HOST = "https://opengw.developer.huaweicloud.com";
+const EP_STATISTICS_PLUGIN = "/snap-manager/v1/statistics/plugin";
+const EP_TOKEN_BALANCE = "/api/v1/user/tokens/balance";
+function asRecord(value) {
+	return typeof value === "object" && value !== null ? value : {};
+}
+function asArray(value) {
+	return Array.isArray(value) ? value : [];
+}
+function firstString(...values) {
+	for (const value of values) if (typeof value === "string" && value.trim() !== "") return value.trim();
+	return "";
+}
+/**
+* 取一个非负数字。
+*
+* 上游用 `-1` 表示「这个指标不适用」（例如模型维度的 usage_token / model_quota_num），
+* 所以负数一律当「没有」而不是当 0 —— 否则界面会把「不适用」显示成「已用 0」。
+*/
+function nonNegative(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : void 0;
+}
+function numberOrZero(value) {
+	return nonNegative(value) ?? 0;
+}
+/** 按 name 找一条 metrics（上游的 metrics 是一个带 name 的数组）。 */
+function metricNamed(raw, name) {
+	for (const item of asArray(raw)) {
+		const metric = asRecord(item);
+		if (firstString(metric.name) === name) return metric;
+	}
+}
+function categoryOf(metric) {
+	if (metric === void 0) return void 0;
+	const total = nonNegative(metric.package_credit_amount);
+	const used = nonNegative(metric.package_credit_used);
+	const remain = nonNegative(metric.package_credit_remain);
+	if (total === void 0 && used === void 0 && remain === void 0) return void 0;
+	return {
+		total: numberOrZero(total),
+		used: numberOrZero(used),
+		remain: numberOrZero(remain),
+		expiring: numberOrZero(metric.package_credit_expiring_amount)
+	};
+}
+/** 套餐状态映射：与官方客户端 CreditPackageService.mapPackageStatus 一致。 */
+function mapPlanStatus(raw) {
+	if (raw === "normal") return "active";
+	if (raw === "closed") return "expired";
+	if (raw === "freeze") return "frozen";
+	return "unknown";
+}
+/**
+* 解析 `GET /snap-manager/v1/statistics/plugin` 的响应。
+*
+* 返回 undefined 表示这不是一份能用的积分文档（上游改了形状/账号没有积分体系）——
+* 调用方据此报「积分不可用」，而不是显示一排 0 假装是真的。
+*/
+function parseCreditStatistics(raw) {
+	const body = asRecord(raw);
+	const metrics = body.metrics;
+	if (!Array.isArray(metrics)) return void 0;
+	const total = categoryOf(metricNamed(metrics, "usageTotalPackageCredit"));
+	if (total === void 0) return void 0;
+	const pkg = asRecord(body.package);
+	const planNameCn = firstString(pkg.package_name_cn);
+	const planNameEn = firstString(pkg.package_name_en);
+	const packageUrl = firstString(pkg.package_url);
+	const periodStart = firstString(body.start_date);
+	const periodEnd = firstString(body.end_date);
+	return {
+		planName: planNameCn !== "" ? planNameCn : planNameEn,
+		planNameEn,
+		specCode: firstString(pkg.spec_code),
+		planStatus: mapPlanStatus(firstString(pkg.status)),
+		isCreditPackage: pkg.is_credit_package === true,
+		...packageUrl === "" ? {} : { packageUrl },
+		...periodStart === "" ? {} : { periodStart },
+		...periodEnd === "" ? {} : { periodEnd },
+		total,
+		...pick("bonus", categoryOf(metricNamed(metrics, "usageBonusPackageCredit"))),
+		...pick("basic", categoryOf(metricNamed(metrics, "usageBasicPackageCredit"))),
+		...pick("onDemand", categoryOf(metricNamed(metrics, "usageOnDemandPackageCredit"))),
+		fetchedAt: Date.now()
+	};
+}
+function pick(key, value) {
+	return value === void 0 ? {} : { [key]: value };
+}
+/** 解析 `GET /api/v1/user/tokens/balance` 的响应（`result` 里是额度口径）。 */
+function parseTokenBalance(raw) {
+	const result = asRecord(asRecord(raw).result);
+	const balance = nonNegative(result.total_balance);
+	const quota = nonNegative(result.total_quota);
+	if (balance === void 0 && quota === void 0) return void 0;
+	return {
+		dailyLimit: numberOrZero(result.daily_token_limit),
+		dailyUsed: numberOrZero(result.daily_tokens_used),
+		monthlyLimit: numberOrZero(result.monthly_token_limit),
+		monthlyUsed: numberOrZero(result.monthly_tokens_used),
+		balance: numberOrZero(balance),
+		quota: numberOrZero(quota)
+	};
+}
+function errorOf(action, result) {
+	return new Error(`${action} HTTP ${result.status} ${result.message}`.trim().slice(0, 300));
+}
+/**
+* 拉一次积分与 token 额度。
+*
+* 积分是主口径：它失败就整体失败（卡片要能看见原因）。token 额度是附带的，
+* 它失败只让 `tokens` 缺席 —— 别让一个次要接口把主数字一起拖没。
+*/
+async function fetchCredits(credential, signal) {
+	const [statistics, balance] = await Promise.all([signedGet(`${SNAP_HOST}${EP_STATISTICS_PLUGIN}`, credential, void 0, signal), signedGet(`${BENEFIT_GATEWAY_HOST}${EP_TOKEN_BALANCE}`, credential, void 0, signal).catch(() => ({
+		ok: false,
+		status: 0,
+		message: "request failed"
+	}))]);
+	if (!statistics.ok) throw errorOf("statistics", statistics);
+	const credits = parseCreditStatistics(safeJson(statistics.text));
+	if (credits === void 0) throw new Error("statistics response carries no credit metrics");
+	const tokens = balance.ok ? parseTokenBalance(safeJson(balance.text)) : void 0;
+	return {
+		credits,
+		...tokens === void 0 ? {} : { tokens }
+	};
+}
+function safeJson(text) {
+	try {
+		return JSON.parse(text);
+	} catch {
+		return;
+	}
+}
+/**
+* 积分缓存（TTL + 单飞）。
+*
+* 单飞很重要：卡片刷新、对话底部的轮询可能同时打进来，没有它就会并发问上游好几次；
+* 而上游对同一账号的并发是有成本/风险的。
+*/
+var CodeArtsCreditCache = class {
+	state;
+	inflight;
+	ttlMs;
+	failureTtlMs;
+	load;
+	now;
+	constructor(options = {}) {
+		this.ttlMs = options.ttlMs ?? 6e4;
+		this.failureTtlMs = options.failureTtlMs ?? 15e3;
+		this.load = options.load ?? fetchCredits;
+		this.now = options.now ?? (() => Date.now());
+	}
+	/** 当前缓存内容（不触发请求），供只想读快照的场景使用。 */
+	peek() {
+		return this.state;
+	}
+	/** 丢掉缓存，下次 get 会重新拉（重新登录/添加账号后调用）。 */
+	invalidate() {
+		this.state = void 0;
+		this.inflight = void 0;
+	}
+	/**
+	* 取一次积分。命中缓存直接返回；否则合并成一次上游请求。
+	* **不抛异常**：失败以 `phase: 'error'` 返回，调用方（状态路由）照样能渲染。
+	*/
+	async get(credential, signal) {
+		const cached = this.state;
+		if (cached !== void 0) {
+			const ttl = cached.phase === "ok" ? this.ttlMs : this.failureTtlMs;
+			if (this.now() - cached.at < ttl) return cached;
+		}
+		return this.inflight ??= this.run(credential, signal).finally(() => {
+			this.inflight = void 0;
+		});
+	}
+	async run(credential, signal) {
+		try {
+			const state = {
+				phase: "ok",
+				value: await this.load(credential, signal),
+				at: this.now()
+			};
+			this.state = state;
+			return state;
+		} catch (error) {
+			const state = {
+				phase: "error",
+				message: error instanceof Error ? error.message : String(error),
+				at: this.now()
+			};
+			this.state = state;
+			return state;
+		}
+	}
+};
+//#endregion
 //#region src/adapter.ts
 /**
 * The `codearts` pi-ai provider.
@@ -146,7 +367,7 @@ var CodeArtsAccountPool = class {
 * models and points pi-ai at the shim's OpenAI-compatible endpoint.
 *
 * MVP simplifications vs dsh-codebuddy-cli:
-*   - no billing rate in the model name (CodeArts has no balance API)
+*   - no billing rate in the model name (per-request cost not exposed by the API)
 *   - no per-model reasoning ladder (models are surfaced as plain chat models)
 *
 * @module dsh-codearts/adapter
@@ -401,6 +622,8 @@ function readBody$1(req) {
 }
 /** 一次请求最多试几个账号（与 Go 参考的 MaxRotate 一致）。 */
 const MAX_ROTATE = 3;
+/** 一次请求最多把 max_tokens 降几档（65536 → 32768 → 16384 → 8192）。 */
+const MAX_CEILING_HEALS = 3;
 /**
 * 所有账号都撞上并发上限时，回落到「在同一账号上原地重发」的预算。
 *
@@ -505,13 +728,85 @@ function createCodeArtsShim(options) {
 			else res.end();
 		}
 	}
+	/** 该模型的上下文窗口（catalog 里查，大小写不敏感）；查不到返回 0 = 不做超长预判。 */
+	function contextWindowFor(id) {
+		const lower = id.trim().toLowerCase();
+		for (const model of catalog.current()) if (model.id.toLowerCase() === lower) return model.contextWindow;
+		return 0;
+	}
+	/**
+	* 打开上游流；撞到「参数非法」就把该模型的 max_tokens 上限折半降一档再开一次。
+	*
+	* 上游的 max_tokens 上限由服务端控制、会漂（GLM-5.2 标称 131072，2026-10-10 起
+	* 直接被拒），手工实测表必然滞后。而这类错误是**流内**帧（HTTP 仍 200），只能在
+	* 第一帧判 —— 此时还没有任何内容产出，重发是安全的。降档结果记在 upstream 的
+	* 进程内表里，该模型后续请求直接从新上限起步，不必每轮再白撞一次。
+	*/
+	async function openWithCeilingHeal(credential, raw, contextWindow, signal) {
+		for (let heal = 0;; heal += 1) {
+			const prepared = prepareChatBody(raw, contextWindow);
+			if (prepared.error !== void 0) return {
+				prepared,
+				result: {
+					ok: false,
+					kind: "client",
+					status: 400,
+					message: prepared.error
+				}
+			};
+			const result = await chatStream(credential, prepared, signal);
+			if (!result.ok) return {
+				prepared,
+				result
+			};
+			const reader = result.stream.getReader();
+			const first = await reader.read();
+			const head = first.done ? void 0 : first.value;
+			const shouldHeal = heal < MAX_CEILING_HEALS && head !== void 0 && isParamInvalidFrame(new TextDecoder().decode(head));
+			reader.releaseLock();
+			if (!shouldHeal) return {
+				prepared,
+				result,
+				head
+			};
+			await result.stream.cancel().catch(() => {});
+			if (degradeTokenCeiling(prepared.model) === 0) return {
+				prepared,
+				result: {
+					ok: false,
+					kind: "client",
+					status: 400,
+					message: `${prepared.model}: max_tokens 已降到下限仍被判参数非法`
+				}
+			};
+			logger?.warn(`dsh-codearts: ${prepared.model} 被判参数非法，max_tokens 降档到 ${maxTokensCeilingFor(prepared.model)} 后重发`);
+		}
+	}
+	/** 先交回降档判定读过的那一帧（它是流的开头，丢了就少一段），再接着读剩下的。 */
+	async function* drainFrames(reader, head) {
+		if (head !== void 0) yield head;
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) return;
+			if (value !== void 0) yield value;
+		}
+	}
 	async function chatCompletions(req, res) {
 		if (!isJsonContentType(req)) {
 			writeOpenAIError(res, 415, "unsupported_media_type", "Content-Type must be application/json");
 			return;
 		}
 		const raw = (await readBody$1(req)).toString("utf8");
-		const prepared = prepareChatBody(raw);
+		let contextWindow = 0;
+		try {
+			const inbound = JSON.parse(raw);
+			if (typeof inbound.model === "string") contextWindow = contextWindowFor(canonicalModel(inbound.model));
+		} catch {}
+		const checked = prepareChatBody(raw, contextWindow);
+		if (checked.error !== void 0) {
+			writeOpenAIError(res, 400, "context_overflow", checked.error);
+			return;
+		}
 		const controller = new AbortController();
 		res.on("close", () => {
 			if (!res.writableEnded) controller.abort();
@@ -544,7 +839,8 @@ function createCodeArtsShim(options) {
 					pool.disable(id, "no credential");
 					continue;
 				}
-				const result = await chatStream(credential, prepared, controller.signal);
+				const opened = await openWithCeilingHeal(credential, raw, contextWindow, controller.signal);
+				const { prepared, result } = opened;
 				if (controller.signal.aborted) {
 					if (result.ok) await result.stream.cancel().catch(() => {});
 					return;
@@ -554,7 +850,7 @@ function createCodeArtsShim(options) {
 					await pipeToResponse(res, result.stream, controller.signal, {
 						accountId: id,
 						model: prepared.model
-					});
+					}, opened.head);
 					return;
 				}
 				lastKind = result.kind;
@@ -581,28 +877,31 @@ function createCodeArtsShim(options) {
 		}
 		if (controller.signal.aborted) return;
 		if (cappedAccount !== void 0) {
-			if (pool.acquire(cappedAccount)) try {
-				const credential = await store.resolve(cappedAccount);
-				if (credential !== void 0) {
-					const result = await openStream(credential, prepared, controller.signal);
-					if (controller.signal.aborted) {
-						if (result.ok) await result.stream.cancel().catch(() => {});
-						return;
-					}
-					if (result.ok) {
-						pool.noteSuccess(cappedAccount);
-						await pipeToResponse(res, result.stream, controller.signal, {
-							accountId: cappedAccount,
-							model: prepared.model
-						});
-						return;
+			if (pool.acquire(cappedAccount)) {
+				const prepared = prepareChatBody(raw, contextWindow);
+				try {
+					const credential = await store.resolve(cappedAccount);
+					if (credential !== void 0) {
+						const result = await openStream(credential, prepared, controller.signal);
+						if (controller.signal.aborted) {
+							if (result.ok) await result.stream.cancel().catch(() => {});
+							return;
+						}
+						if (result.ok) {
+							pool.noteSuccess(cappedAccount);
+							await pipeToResponse(res, result.stream, controller.signal, {
+								accountId: cappedAccount,
+								model: prepared.model
+							});
+							return;
+						}
+						lastKind = result.kind;
+						lastStatus = result.status;
+						lastMessage = result.message;
 					}
-					lastKind = result.kind;
-					lastStatus = result.status;
-					lastMessage = result.message;
+				} finally {
+					pool.release(cappedAccount);
 				}
-			} finally {
-				pool.release(cappedAccount);
 			}
 		}
 		if (lastKind === void 0) {
@@ -611,8 +910,22 @@ function createCodeArtsShim(options) {
 		}
 		writeOpenAIError(res, KIND_STATUS[lastKind], lastKind, `codearts upstream ${lastKind} (http ${lastStatus}): ${lastMessage.slice(0, 400)}`);
 	}
+	/**
+	* 记下一帧里的上游流内错误。判据宽松（帧文本含 "error" 才解析），解析不出来就忽略 ——
+	* 诊断不能影响转发。
+	*/
+	function logInStreamError(frame, model) {
+		try {
+			const payload = frame.startsWith("data:") ? frame.slice(5).trim() : frame;
+			const ev = JSON.parse(payload);
+			if (ev.error === void 0) return;
+			const code = String(ev.error.code ?? "");
+			const message = String(ev.error.message ?? "").slice(0, 200);
+			logger?.error(`dsh-codearts: 上游流内报错 model=${model} code=${code} msg=${message}`);
+		} catch {}
+	}
 	/** 把上游 SSE 按事件边界转发给 DSH，直到流结束或被中止。 */
-	async function pipeToResponse(res, stream, signal, attribution) {
+	async function pipeToResponse(res, stream, signal, attribution, head) {
 		res.writeHead(200, {
 			"Content-Type": "text/event-stream",
 			"Cache-Control": "no-cache",
@@ -629,12 +942,7 @@ function createCodeArtsShim(options) {
 			res.end(sawDone ? void 0 : "data: [DONE]\n\n");
 		};
 		try {
-			for (;;) {
-				const { done, value } = await reader.read();
-				if (done) {
-					finish();
-					return;
-				}
+			for await (const value of drainFrames(reader, head)) {
 				buf += decoder.decode(value, { stream: true });
 				let idx;
 				while ((idx = buf.indexOf("\n\n")) >= 0) {
@@ -642,10 +950,12 @@ function createCodeArtsShim(options) {
 					buf = buf.slice(idx + 2);
 					if (!frame) continue;
 					if (frame.trim() === "data: [DONE]") sawDone = true;
+					if (frame.includes("\"error\"")) logInStreamError(frame, attribution?.model ?? "");
 					if (usage !== void 0 && attribution !== void 0 && frame.includes("\"usage\"")) recordFrameUsage(frame, attribution);
 					if (res.writable) res.write(frame + "\n\n");
 				}
 			}
+			finish();
 		} catch (error) {
 			if (!signal.aborted) logger?.warn("dsh-codearts: upstream stream failed mid-flight", error);
 			finish();
@@ -689,6 +999,8 @@ const CODEARTS_LOGIN_PATH = "/api/codearts/login";
 const CODEARTS_LOGIN_STATUS_PATH = "/api/codearts/login/status";
 /** 删除某个账号：DELETE /api/codearts/accounts?id=<accountId> */
 const CODEARTS_ACCOUNTS_PATH = "/api/codearts/accounts";
+/** POST /api/codearts/claim — 手动领取限时福利（签到领积分，幂等）。 */
+const CODEARTS_CLAIM_PATH = "/api/codearts/claim";
 /**
 * 由完整目录 + 已存 enabled 计算 selection。
 * - enabled 为空/未存 => 全部勾选（restricted=false）
@@ -806,6 +1118,21 @@ function usageOf(deps) {
 		slots: slotsOf(deps)
 	};
 }
+/**
+* 积分区块。
+*
+* 积分是「锦上添花」：拉不到也绝不能把状态接口本身拖垮，所以失败一律降级成
+* `creditsError` 交给卡片显示原因（超时由注入方在自己的闭包里保证）。
+*/
+async function creditsOf(deps) {
+	if (deps.credits === void 0) return {};
+	try {
+		const state = await deps.credits();
+		return state.phase === "ok" ? { credits: state.value } : { creditsError: state.message };
+	} catch (error) {
+		return { creditsError: safeMessage(error) };
+	}
+}
 async function buildStatus(deps) {
 	const models = deps.models().map((m) => ({
 		id: m.id,
@@ -820,14 +1147,23 @@ async function buildStatus(deps) {
 		accounts,
 		usage
 	};
-	return {
-		status: accounts.some(accountUsable) ? "signed-in" : "expired",
+	const usable = accounts.some(accountUsable);
+	const identity = {
 		...cred.label === void 0 ? {} : { label: cred.label },
 		...cred.storedAt === void 0 ? {} : { storedAt: cred.storedAt },
 		models,
 		accounts,
 		usage
 	};
+	if (!usable) return {
+		status: "expired",
+		...identity
+	};
+	return {
+		status: "signed-in",
+		...identity,
+		...await creditsOf(deps)
+	};
 }
 /** GET /api/codearts/status */
 function statusHandler(deps) {
@@ -997,6 +1333,36 @@ function accountsHandler(deps) {
 		}
 	};
 }
+/** POST /api/codearts/claim — 手动领取限时福利（签到领积分，幂等）。 */
+function claimHandler(deps) {
+	return async (req, res) => {
+		if (req.method !== "POST") {
+			json(res, 405, { error: "method not allowed" });
+			return;
+		}
+		if (deps.claim === void 0) {
+			json(res, 404, { error: "claim not available" });
+			return;
+		}
+		if (!loopbackRequest(req)) {
+			json(res, 403, { error: "request-not-trusted" });
+			return;
+		}
+		try {
+			const result = await deps.claim();
+			if (result.ok) json(res, 200, { ok: true });
+			else json(res, 500, {
+				ok: false,
+				message: result.message
+			});
+		} catch (error) {
+			json(res, 500, {
+				ok: false,
+				message: safeMessage(error)
+			});
+		}
+	};
+}
 /** Mount the status / models / token routes. */
 function registerCodeArtsStatusRoute(ctx, deps) {
 	ctx.effect(() => {
@@ -1038,6 +1404,11 @@ function registerCodeArtsStatusRoute(ctx, deps) {
 			path: CODEARTS_ACCOUNTS_PATH,
 			handler: accountsHandler(deps)
 		});
+		const disposeClaim = ctx.webServer.register({
+			kind: "exact",
+			path: CODEARTS_CLAIM_PATH,
+			handler: claimHandler(deps)
+		});
 		return () => {
 			disposeStatus();
 			disposeModels();
@@ -1046,6 +1417,7 @@ function registerCodeArtsStatusRoute(ctx, deps) {
 			disposeLoginStart();
 			disposeLoginStatus();
 			disposeAccounts();
+			disposeClaim();
 			for (const s of activeLogins.values()) s.close();
 			activeLogins.clear();
 		};
@@ -1218,6 +1590,46 @@ function apply(ctx, rawConfig) {
 	const pool = new CodeArtsAccountPool([]);
 	const catalog = new CodeArtsCatalog();
 	const usage = new CodeArtsUsageTracker({ path: codeartsUsagePath() });
+	const credits = new CodeArtsCreditCache();
+	/** /status 是卡片与对话底部都会轮询的接口，积分慢请求不能把它拖成转圈。 */
+	const CREDIT_TIMEOUT_MS = 8e3;
+	/**
+	* 拉一次积分。
+	*
+	* 积分是**账号级**属性，不随请求轮转：这里挑第一个没用坏的账号，够覆盖正常用法
+	* （多账号下的积分差异不在本插件关心范围内）。
+	*/
+	const loadCredits = async (signal) => {
+		const ids = await store.ids();
+		if (ids.length === 0) return {
+			phase: "error",
+			message: "not signed in",
+			at: Date.now()
+		};
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), CREDIT_TIMEOUT_MS);
+		timer.unref?.();
+		signal?.addEventListener("abort", () => controller.abort(), { once: true });
+		try {
+			let last;
+			for (const id of ids) {
+				const stored = await store.credential(id);
+				if (stored === void 0 || stored.stale === true) continue;
+				const resolved = await store.resolve(id);
+				if (resolved === void 0) continue;
+				const state = await credits.get(resolved, controller.signal);
+				if (state.phase === "ok") return state;
+				last = state;
+			}
+			return last ?? {
+				phase: "error",
+				message: "no usable credential",
+				at: Date.now()
+			};
+		} finally {
+			clearTimeout(timer);
+		}
+	};
 	let current = () => config;
 	const enabledModels = () => current().enabledModels;
 	const setEnabledModels = async (ids) => {
@@ -1232,7 +1644,31 @@ function apply(ctx, rawConfig) {
 		enabledModels,
 		setEnabledModels,
 		pool: () => pool.list(),
-		usage: () => usage.snapshot()
+		usage: () => usage.snapshot(),
+		credits: (signal) => loadCredits(signal),
+		claim: async () => {
+			try {
+				const ids = await store.ids();
+				for (const id of ids) {
+					const stored = await store.credential(id);
+					if (stored === void 0 || stored.stale === true) continue;
+					const resolved = await store.resolve(id);
+					if (resolved === void 0) continue;
+					await claimBenefit(resolved, AbortSignal.timeout(1e4));
+					credits.invalidate();
+					return { ok: true };
+				}
+				return {
+					ok: false,
+					message: "no usable credential"
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					message: error instanceof Error ? error.message : String(error)
+				};
+			}
+		}
 	}));
 	installSettingsSectionCompat(ctx, CODEARTS_SETTINGS_NS, Config, config, {
 		setSource(source) {
@@ -1317,4 +1753,4 @@ function apply(ctx, rawConfig) {
 	});
 }
 //#endregion
-export { CODEARTS_PROVIDER, CODEARTS_SETTINGS_NS, CodeArtsAccountPool, CodeArtsAccountStore, CodeArtsCatalog, CodeArtsCredentialStore, CodeArtsUsageTracker, Config, FALLBACK_CODEARTS_MODELS, SNAP_HOST, apply, canonicalModel, chatStream, codeartsAccountsPath, codeartsAuthPath, codeartsUsagePath, createCodeArtsAdapter, createCodeArtsShim, discoverModels, fetchModels, filterEnabledModels, inject, maxTokensCeilingFor, name, prepareChatBody, refreshCatalog };
+export { BENEFIT_GATEWAY_HOST, CODEARTS_PROVIDER, CODEARTS_SETTINGS_NS, CodeArtsAccountPool, CodeArtsAccountStore, CodeArtsCatalog, CodeArtsCredentialStore, CodeArtsCreditCache, CodeArtsUsageTracker, Config, FALLBACK_CODEARTS_MODELS, SNAP_HOST, apply, canonicalModel, chatStream, codeartsAccountsPath, codeartsAuthPath, codeartsUsagePath, createCodeArtsAdapter, createCodeArtsShim, discoverModels, fetchCredits, fetchModels, filterEnabledModels, inject, maxTokensCeilingFor, name, parseCreditStatistics, parseTokenBalance, prepareChatBody, refreshCatalog };