dsh-router-core 0.1.0 → 0.2.0

package/lib/index.js

@@ -10,12 +10,265 @@ const ROUTER_API_BASE = "/router/api";
 /** Bearer key env / credential reference protecting /v1/*. */
 const API_KEY_REF = "TW2A_API_KEY";
 //#endregion
+//#region src/router/account-pool.ts
+const MINUTE = 6e4;
+/**
+* 状态 → 处置表。**核心策略就在这一张表里**，插件只报状态不做决策。
+* 时长参考 9router 的 errorConfig（限流类短冷却、额度类长冷却），
+* 但 9router 按文本/状态匹配，这里按插件解读后的语义状态匹配，更准。
+*/
+const RULES = {
+	ok: {
+		cooldownMs: 0,
+		disable: false,
+		counts: false
+	},
+	rate_limit: {
+		cooldownMs: 1 * MINUTE,
+		disable: false,
+		counts: false
+	},
+	quota: {
+		cooldownMs: 10 * MINUTE,
+		disable: false,
+		counts: false
+	},
+	session_dead: {
+		cooldownMs: 0,
+		disable: true,
+		counts: false
+	},
+	unavailable: {
+		cooldownMs: 0,
+		disable: false,
+		counts: true
+	},
+	transport: {
+		cooldownMs: 0,
+		disable: false,
+		counts: true
+	},
+	unknown: {
+		cooldownMs: 0,
+		disable: false,
+		counts: true
+	},
+	no_such_model: {
+		cooldownMs: 0,
+		disable: false,
+		counts: false
+	}
+};
+/** 连续错误攒够这么多次就自动冷却（防止坏号被反复重试）。 */
+const ERR_THRESHOLD = 3;
+/** 攒够后的冷却时长。 */
+const ERR_COOLDOWN_MS = 10 * MINUTE;
+var AccountPool = class {
+	entries = /* @__PURE__ */ new Map();
+	rrCursor = 0;
+	entry(uid) {
+		let e = this.entries.get(uid);
+		if (!e) {
+			e = {
+				until: 0,
+				disabled: false,
+				errCount: 0,
+				reason: ""
+			};
+			this.entries.set(uid, e);
+		}
+		return e;
+	}
+	/** 是否可服务：未禁用且不在冷却中。 */
+	healthy(uid, now) {
+		const e = this.entries.get(uid);
+		if (!e) return true;
+		if (e.disabled) return false;
+		return e.until <= now;
+	}
+	/**
+	* 按策略选一个健康账号。
+	* @param accounts 插件报告的「现在状态」（顺序即插件的自然顺序）
+	* @param poolOrder 用户在面板拖出来的顺序（核心管）
+	* @returns 选中的 uid；无健康账号返回 undefined
+	*/
+	pick(accounts, poolOrder, strategy) {
+		const now = Date.now();
+		const byUid = new Map(accounts.map((a) => [a.uid, a]));
+		const healthy = [...poolOrder.filter((uid) => byUid.has(uid)), ...accounts.map((a) => a.uid).filter((uid) => !poolOrder.includes(uid))].filter((uid) => this.healthy(uid, now));
+		if (healthy.length === 0) return void 0;
+		if (strategy !== "round-robin") return healthy[0];
+		const uid = healthy[this.rrCursor % healthy.length];
+		this.rrCursor = (this.rrCursor + 1) % healthy.length;
+		return uid;
+	}
+	/** 记录一次失败：按状态处置（冷却/禁用/错误累计）。 */
+	noteFailure(uid, state, message) {
+		const rule = RULES[state];
+		const e = this.entry(uid);
+		if (rule.disable) {
+			e.disabled = true;
+			e.reason = message;
+			return;
+		}
+		if (rule.cooldownMs > 0) {
+			e.until = Math.max(e.until, Date.now() + rule.cooldownMs);
+			e.reason = message;
+			e.errCount = 0;
+			return;
+		}
+		if (rule.counts) {
+			e.errCount += 1;
+			e.reason = message;
+			if (e.errCount >= ERR_THRESHOLD) {
+				e.until = Date.now() + ERR_COOLDOWN_MS;
+				e.errCount = 0;
+			}
+		}
+	}
+	/** 记录一次成功：清零连续错误。 */
+	noteSuccess(uid) {
+		const e = this.entries.get(uid);
+		if (e) e.errCount = 0;
+	}
+	/** 手动冷却（面板/管理用途）。 */
+	cooldown(uid, ms, reason) {
+		const e = this.entry(uid);
+		e.until = Date.now() + ms;
+		e.reason = reason;
+		e.errCount = 0;
+	}
+	/** 把核心的冷却/禁用/错误累计叠加到插件报告的「现在状态」上，产出面板态。 */
+	decorate(accounts) {
+		const now = Date.now();
+		return accounts.map((a) => {
+			const e = this.entries.get(a.uid);
+			const cooling = e !== void 0 && !e.disabled && e.until > now;
+			return {
+				...a,
+				cooling,
+				disabled: e?.disabled ?? false,
+				err_count: e?.errCount ?? 0,
+				until: cooling && e ? new Date(e.until).toISOString() : void 0,
+				reason: e?.reason !== "" ? e?.reason : void 0
+			};
+		});
+	}
+};
+//#endregion
+//#region src/supplier-config.ts
+/**
+* 通用供应商配置 —— dsh-router 核心能力,按供应商 id 存储。
+*
+* 通用能力(所有供应商共享,供应商 js 不需要实现)：
+*   - 别名 alias(前缀,模型全名 = alias/id)
+*   - 模型管理:启用/禁用 disabled、自定义 custom
+*   - 连接池:poolOrder(拖动排序)、poolStrategy(回退/轮询)
+*
+* 持久化到 data/supplier-config.json。
+*/
+/** 通用供应商配置存储。 */
+var SupplierConfigStore = class {
+	fp = "";
+	bySupplier = /* @__PURE__ */ new Map();
+	constructor(stateFile) {
+		this.fp = stateFile ? join(dirname(stateFile), "supplier-config.json") : "";
+		this.load();
+	}
+	/** 读取某供应商配置(不存在则返回默认并注册)。 */
+	get(supplierId) {
+		let cfg = this.bySupplier.get(supplierId);
+		if (!cfg) {
+			cfg = {
+				alias: "",
+				disabled: [],
+				custom: [],
+				poolOrder: [],
+				poolStrategy: "fallback"
+			};
+			this.bySupplier.set(supplierId, cfg);
+		}
+		return cfg;
+	}
+	setAlias(supplierId, alias) {
+		this.get(supplierId).alias = alias;
+		this.saveLocked();
+	}
+	setModelEnabled(supplierId, modelId, enabled) {
+		const cfg = this.get(supplierId);
+		cfg.disabled = enabled ? cfg.disabled.filter((m) => m !== modelId) : [.../* @__PURE__ */ new Set([...cfg.disabled, modelId])];
+		this.saveLocked();
+	}
+	setAllModelsEnabled(supplierId, enabled, allModelIds) {
+		const cfg = this.get(supplierId);
+		cfg.disabled = enabled ? [] : [...new Set(allModelIds)];
+		this.saveLocked();
+	}
+	addCustomModel(supplierId, modelId) {
+		const cfg = this.get(supplierId);
+		if (!cfg.custom.includes(modelId)) cfg.custom.push(modelId);
+		this.saveLocked();
+	}
+	removeCustomModel(supplierId, modelId) {
+		const cfg = this.get(supplierId);
+		cfg.custom = cfg.custom.filter((m) => m !== modelId);
+		cfg.disabled = cfg.disabled.filter((m) => m !== modelId);
+		this.saveLocked();
+	}
+	setPoolOrder(supplierId, uids) {
+		this.get(supplierId).poolOrder = [...new Set(uids)];
+		this.saveLocked();
+	}
+	setPoolStrategy(supplierId, strategy) {
+		if (strategy !== "fallback" && strategy !== "round-robin") return;
+		this.get(supplierId).poolStrategy = strategy;
+		this.saveLocked();
+	}
+	load() {
+		if (this.fp === "") return;
+		let f;
+		try {
+			f = JSON.parse(readFileSync(this.fp, "utf8"));
+		} catch {
+			return;
+		}
+		for (const [id, c] of Object.entries(f.suppliers ?? {})) this.bySupplier.set(id, {
+			alias: typeof c.alias === "string" ? c.alias : "",
+			disabled: Array.isArray(c.disabled) ? c.disabled.filter((m) => typeof m === "string") : [],
+			custom: Array.isArray(c.custom) ? c.custom.filter((m) => typeof m === "string") : [],
+			poolOrder: Array.isArray(c.poolOrder) ? c.poolOrder.filter((u) => typeof u === "string") : [],
+			poolStrategy: c.poolStrategy === "round-robin" ? "round-robin" : "fallback"
+		});
+	}
+	saveLocked() {
+		if (this.fp === "") return;
+		const f = { suppliers: {} };
+		for (const [id, cfg] of this.bySupplier) f.suppliers[id] = {
+			alias: cfg.alias,
+			disabled: [...cfg.disabled],
+			custom: [...cfg.custom],
+			poolOrder: [...cfg.poolOrder],
+			poolStrategy: cfg.poolStrategy
+		};
+		try {
+			const dir = dirname(this.fp);
+			if (dir !== "" && dir !== ".") mkdirSync(dir, { recursive: true });
+			const raw = JSON.stringify(f, null, 2);
+			const tmp = this.fp + ".tmp";
+			writeFileSync(tmp, raw, { mode: 384 });
+			renameSync(tmp, this.fp);
+		} catch {}
+	}
+};
+//#endregion
 //#region src/router/index.ts
 /**
 * dsh-router 路由器本体：供应商注册表 + OpenAI 兼容 /v1/* 处理。
 * 仿 9router：组合 = 一组模型，请求 model 命中组合名时，按策略
 * （fallback 顺序尝试 / round-robin 轮转）选中一个模型路由。
 */
+/** 模型列表缓存有效期。 */
+const MODELS_TTL_MS = 6e4;
 function openAIError(code, msg) {
 	return { error: {
 		message: msg,
@@ -30,6 +283,76 @@ function writeJson$2(res, status, body) {
 	});
 	res.end(JSON.stringify(body));
 }
+/** 丢弃响应的假 ServerResponse（测试模型用：记录状态+内容，用于判定成败）。 */
+function sinkRes() {
+	let status = 200;
+	let text = "";
+	const self = {
+		headersSent: false,
+		writableEnded: false,
+		writeHead: (code) => {
+			status = code;
+			return self;
+		},
+		write: (chunk) => {
+			if (chunk !== void 0) text += String(chunk);
+			return true;
+		},
+		end: (chunk) => {
+			if (chunk !== void 0) text += String(chunk);
+			return self;
+		},
+		flushHeaders: () => {},
+		status: () => status,
+		body: () => text
+	};
+	return self;
+}
+/**
+* 把 chatOnce 的结果写进 res（核心独占响应写入权）。
+* 流式：SSE 头 + pipe 上游已转好的 OpenAI SSE；非流式：原样写 JSON。
+*/
+async function writeChatResult(res, r) {
+	if (!r.ok) return;
+	if (!("stream" in r)) {
+		res.writeHead(r.status, {
+			"Content-Type": "application/json; charset=utf-8",
+			"Cache-Control": "no-store"
+		});
+		res.end(r.body);
+		return;
+	}
+	res.writeHead(200, {
+		"Content-Type": "text/event-stream",
+		"Cache-Control": "no-cache",
+		Connection: "keep-alive",
+		"X-Accel-Buffering": "no"
+	});
+	if (typeof res.flushHeaders === "function") res.flushHeaders();
+	const onError = () => {
+		res.destroy();
+	};
+	res.once("error", onError);
+	try {
+		await r.stream.pipeTo(new WritableStream({ write: (chunk) => new Promise((resolve) => {
+			if (res.write(chunk)) resolve();
+			else res.once("drain", resolve);
+		}) }));
+	} catch {} finally {
+		res.removeListener("error", onError);
+		res.end();
+	}
+}
+/** 从上游响应体提取错误信息（OpenAI {error:{message}} 或 {code,msg}/{message}）。 */
+function extractUpstreamError(body) {
+	try {
+		const j = JSON.parse(body);
+		if (typeof j.error?.message === "string") return j.error.message;
+		if (typeof j.message === "string") return j.message;
+		if (typeof j.msg === "string") return j.msg;
+	} catch {}
+	return body.slice(0, 200);
+}
 /** 路由器。 */
 var Router = class {
 	suppliers = [];
@@ -37,8 +360,13 @@ var Router = class {
 	customCombos = [];
 	/** round-robin 轮转游标（按组合 id 记忆）。 */
 	rrCursors = /* @__PURE__ */ new Map();
-	constructor(stateFile = "") {
+	/** 通用供应商配置（连接池顺序/策略、模型启用、别名）。 */
+	store;
+	/** 模型列表缓存（supplierId → 模型 + 拉取时间）。插件只管拉，不缓存。 */
+	modelsCache = /* @__PURE__ */ new Map();
+	constructor(stateFile = "", store) {
 		this.combosFp = stateFile ? join(dirname(stateFile), "combos.json") : "";
+		this.store = store ?? new SupplierConfigStore(stateFile);
 		this.loadCombos();
 	}
 	loadCombos() {
@@ -48,7 +376,7 @@ var Router = class {
 			if (Array.isArray(f.combos)) this.customCombos = f.combos.filter((c) => typeof c.id === "string" && c.id !== "").map((c) => {
 				const old = c;
 				const models = (Array.isArray(c.models) ? c.models.filter((m) => typeof m === "string" && m !== "") : Array.isArray(old.steps) ? old.steps.map((s) => s.supplier).filter((m) => typeof m === "string" && m !== "") : []).map((m) => {
-					const slash = m.lastIndexOf("/");
+					const slash = m.indexOf("/");
 					return slash >= 0 ? m.slice(slash + 1) : m;
 				});
 				return {
@@ -80,6 +408,7 @@ var Router = class {
 		const i = this.suppliers.findIndex((s) => s.id === id);
 		if (i < 0) return false;
 		const [s] = this.suppliers.splice(i, 1);
+		this.modelsCache.delete(id);
 		s?.dispose();
 		return true;
 	}
@@ -120,21 +449,67 @@ var Router = class {
 	async combos() {
 		return [...this.customCombos];
 	}
-	/** 可用模型（按供应商分组，仅启用），面板加模型用。 */
-	async supplierModels() {
-		const out = [];
-		for (const s of this.suppliers) try {
-			const models = (await s.modelsWithEnabled()).filter((m) => m.enabled);
-			out.push({
-				supplier: {
-					id: s.id,
-					name: s.name,
-					alias: s.getAlias()
-				},
-				models
+	/**
+	* 取某供应商的模型（核心统一缓存）。
+	*
+	* 模型列表只在这里缓存一次：`/suppliers/:id/models`（供应商详情）和
+	* `/combos`（组合加模型）共用。组合面板**不主动打上游**——它只是读缓存，
+	* 冷启动（缓存还没建）时才拉一次；真正刷新由详情页打开或「获取模型」
+	* 按钮（force）触发。
+	*
+	* 天花板：TTL 60s 是拍的。若上游模型列表变更很频繁，可调小；要彻底实时
+	* 就得让供应商暴露 etag/版本号，目前没有这个需求。
+	*/
+	async modelsOf(supplierId, force = false) {
+		const s = this.suppliers.find((x) => x.id === supplierId);
+		if (s === void 0) return [];
+		const hit = this.modelsCache.get(supplierId);
+		if (!force && hit !== void 0 && Date.now() - hit.fetchedAt < MODELS_TTL_MS) return hit.models;
+		const cfg = this.store.get(supplierId);
+		const custom = new Set(cfg.custom);
+		const disabled = new Set(cfg.disabled);
+		const models = (await Promise.resolve(s.listModels())).map((mm) => ({
+			...mm,
+			enabled: !disabled.has(mm.id),
+			custom: custom.has(mm.id) ? true : void 0
+		}));
+		const seen = new Set(models.map((mm) => mm.id));
+		for (const id of custom) if (!seen.has(id)) {
+			seen.add(id);
+			models.push({
+				id,
+				enabled: !disabled.has(id),
+				custom: true
 			});
-		} catch {}
-		return out;
+		}
+		this.modelsCache.set(supplierId, {
+			models,
+			fetchedAt: Date.now()
+		});
+		return models;
+	}
+	/** 失效某供应商的模型缓存（增删改模型后调用）。 */
+	invalidateModels(supplierId) {
+		this.modelsCache.delete(supplierId);
+	}
+	/** 可用模型（按供应商分组，仅启用），面板加模型用。
+	*  各供应商**并行**拉取——串行会把每个上游的延迟累加起来。 */
+	async supplierModels() {
+		return (await Promise.all(this.suppliers.map(async (s) => {
+			try {
+				const models = (await this.modelsOf(s.id)).filter((m) => m.enabled);
+				return {
+					supplier: {
+						id: s.id,
+						name: s.name,
+						alias: s.getAlias()
+					},
+					models
+				};
+			} catch {
+				return;
+			}
+		}))).filter((g) => g !== void 0);
 	}
 	validModels(models) {
 		return Array.isArray(models) && models.length > 0 && models.every((m) => typeof m === "string" && m !== "");
@@ -142,11 +517,15 @@ var Router = class {
 	validStrategy(strategy) {
 		return strategy === "fallback" || strategy === "round-robin";
 	}
-	/** 组合模型统一存裸 id：剥掉 alias/ 前缀（前缀随供应商动态变）。 */
+	/** 组合模型统一存裸 id：剥掉 alias/ 前缀（前缀随供应商动态变）。
+	*  只剥「已知 alias + /」开头的前缀——模型 id 本身可以含斜杠
+	*  （如 nvidia 的 `deepseek-ai/deepseek-v4-flash-0731`），用 lastIndexOf 会把
+	*  命名空间一起吃掉，后面请求必然 404。 */
 	normalizeModelIds(models) {
+		const aliases = this.suppliers.map((s) => s.getAlias()).filter((a) => a !== "");
 		return models.map((m) => {
-			const slash = m.lastIndexOf("/");
-			return slash >= 0 ? m.slice(slash + 1) : m;
+			const prefix = aliases.find((a) => m.startsWith(`${a}/`));
+			return prefix === void 0 ? m : m.slice(prefix.length + 1);
 		});
 	}
 	/** 创建组合（name 唯一，非 default）。 */
@@ -257,10 +636,10 @@ var Router = class {
 			writeJson$2(res, 503, openAIError("no_healthy_supplier", `combo ${JSON.stringify(req.model)}: all models unavailable`));
 			return;
 		}
-		for (const s of this.suppliers) if (await s.chatCompletions(req, res)) return;
+		if (await this.chatWithModel(req, res, req.model)) return;
 		writeJson$2(res, 503, openAIError("no_healthy_supplier", "all suppliers unavailable"));
 	}
-	/** 把 model 改写为组合选中的模型名后尝试供应商。 */
+	/** 把 model 改写为组合选中的模型名后，遍历供应商 + 账号（策略全在核心）。 */
 	async chatWithModel(req, res, model) {
 		const clone = {
 			...req,
@@ -273,9 +652,86 @@ var Router = class {
 		} catch {
 			clone.rawBody = req.rawBody;
 		}
-		for (const s of this.suppliers) if (await s.chatCompletions(clone, res)) return true;
+		for (const s of this.suppliers) if (await this.chatWithSupplier(s, clone, res)) return true;
 		return false;
 	}
+	/**
+	* 单个供应商内遍历账号（核心策略）：选号 → 调 chatOnce → 按返回的
+	* AccountState 处置 → 失败换号；写响应只在成功后发生。
+	*
+	* 流式一旦写出响应头就绑死（上游协议如此，9router 同样如此），所以
+	* 「拿到 ok:true 的流」即视为该账号成功，之后出错不再换号——要能回退
+	* 就得在写头前缓冲判定，代价是首字节延迟，目前未做。
+	*/
+	async chatWithSupplier(s, req, res) {
+		const pool = s.pool;
+		const cfg = this.store.get(s.id);
+		if (s.accounts !== void 0 && s.accounts().length === 0) {
+			const r = await s.chatOnce("", req);
+			if (!r.ok) {
+				if (r.state === "no_such_model") return false;
+				pool.noteFailure("", r.state, r.message);
+				return false;
+			}
+			await writeChatResult(res, r);
+			return true;
+		}
+		const tried = /* @__PURE__ */ new Set();
+		for (;;) {
+			const uid = pool.pick(s.accounts().filter((a) => !tried.has(a.uid)), cfg.poolOrder, cfg.poolStrategy);
+			if (uid === void 0) return false;
+			tried.add(uid);
+			const r = await s.chatOnce(uid, req);
+			if (!r.ok) {
+				if (r.state === "no_such_model") return false;
+				pool.noteFailure(uid, r.state, r.message);
+				continue;
+			}
+			pool.noteSuccess(uid);
+			await writeChatResult(res, r);
+			return true;
+		}
+	}
+	/** 测试某供应商的某模型是否可用。
+	*  走真实的账号遍历 + chatOnce 路径：账号池回退/冷却由核心实现，自动生效；
+	*  响应丢弃到 sink，限定单一供应商（不跨供应商回退）。 */
+	async testModel(supplierId, model) {
+		const s = this.suppliers.find((x) => x.id === supplierId);
+		if (s === void 0) return {
+			ok: false,
+			error: `unknown supplier ${JSON.stringify(supplierId)}`
+		};
+		const sink = sinkRes();
+		const req = {
+			model,
+			stream: false,
+			rawBody: JSON.stringify({
+				model,
+				messages: [{
+					role: "user",
+					content: "ping"
+				}],
+				stream: false,
+				max_tokens: 1
+			})
+		};
+		let served = false;
+		try {
+			served = await this.chatWithSupplier(s, req, sink);
+		} catch (err) {
+			return {
+				ok: false,
+				error: err.message
+			};
+		}
+		if (served && sink.status() < 400) return { ok: true };
+		const fromSink = served && sink.status() >= 400 ? extractUpstreamError(sink.body()) : "";
+		const detail = fromSink !== "" ? fromSink : s.lastError?.();
+		return {
+			ok: false,
+			error: detail !== void 0 && detail !== "" ? `${detail}（账号/额度/限流问题，非模型问题）` : "所有账号都失败或账号都在冷却中（稍后重试）"
+		};
+	}
 	dispose() {
 		for (const s of this.suppliers) s.dispose();
 		this.suppliers = [];
@@ -720,7 +1176,6 @@ function resolveModule(mod, file) {
 	if (typeof cand !== "object" || cand === null) throw new Error(`供应商模块无效: ${file}`);
 	if (typeof cand.id !== "string" || cand.id === "") throw new Error(`供应商缺少 id: ${file}`);
 	if (typeof cand.name !== "string" || cand.name === "") throw new Error(`供应商缺少 name: ${file}`);
-	if (typeof cand.testModel !== "function") throw new Error(`供应商 ${cand.id} 缺少 testModel（必要差异化能力）: ${file}`);
 	return cand;
 }
 /** 加载单个供应商文件，返回模块对象或抛错。 */
@@ -729,7 +1184,7 @@ async function importSupplierFile(file) {
 }
 /**
 * 差异化能力（供应商 js 实现；其余为通用能力由核心提供）。
-* testModel 是必要差异化能力（核心必须），不在此列。
+* testModel / 连接池 / 模型管理 / 别名 / 凭证存储均为核心通用能力，不在此列。
 */
 const DIFF_CAPS = [
 	"generateLoginUrl",
@@ -745,7 +1200,6 @@ async function loadOne(file, env, source) {
 	if (typeof mod === "function") {
 		instance = mod(env);
 		if (typeof instance !== "object" || instance === null || typeof instance.id !== "string" || instance.id === "") throw new Error(`供应商 factory 返回无效: ${file}`);
-		if (typeof instance.testModel !== "function") throw new Error(`供应商 ${instance.id} 缺少 testModel（必要差异化能力）: ${file}`);
 	} else instance = mod;
 	return wrapModule(instance, env, file, source);
 }
@@ -755,15 +1209,22 @@ async function loadOne(file, env, source) {
 */
 function wrapModule(instance, env, source, kind = "external") {
 	if (typeof instance !== "object" || instance === null || typeof instance.id !== "string" || instance.id === "") throw new Error(`供应商模块无效: ${source}`);
-	if (typeof instance.testModel !== "function") throw new Error(`供应商 ${instance.id} 缺少 testModel（必要差异化能力）: ${source}`);
 	const capabilities = /* @__PURE__ */ new Set();
 	for (const key of DIFF_CAPS) if (isFn(instance[key])) capabilities.add(key);
+	const pool = new AccountPool();
 	const supplier = {
 		id: instance.id,
 		name: instance.name,
 		priority: instance.priority ?? 0,
 		icon: instance.icon,
-		status: () => instance.status(),
+		status: () => {
+			const now = instance.status();
+			return {
+				id: now.id,
+				name: now.name,
+				accounts: pool.decorate(now.accounts)
+			};
+		},
 		listModels: (force) => instance.listModels(force),
 		modelsWithEnabled: (force) => {
 			const cfg = env.store.get(instance.id);
@@ -777,10 +1238,12 @@ function wrapModule(instance, env, source, kind = "external") {
 		},
 		getAlias: () => env.store.get(instance.id).alias || instance.getAlias(),
 		customModelIds: () => [...env.store.get(instance.id).custom],
-		chatCompletions: (req, res) => instance.chatCompletions(req, res),
-		testModel: (id) => instance.testModel(id),
+		accounts: () => instance.status().accounts,
+		chatOnce: (uid, req) => instance.chatOnce(uid, req),
+		lastError: isFn(instance.lastError) ? () => instance.lastError() : void 0,
 		removeLink: isFn(instance.removeLink) ? (uid) => instance.removeLink(uid) : void 0,
-		dispose: () => instance.dispose()
+		dispose: () => instance.dispose(),
+		pool
 	};
 	supplier.__module = instance;
 	return {
@@ -862,41 +1325,36 @@ async function readBody$1(req, limit = 65536) {
 function cap(set, key) {
 	return set.has(key);
 }
-/** 模型列表统一缓存（dsh-router 核心管；插件只管拉取，不缓存）。 */
-const modelsCache = /* @__PURE__ */ new Map();
-const MODELS_TTL_MS = 6e4;
-/** 拉取并缓存某供应商模型（force 时强制刷新）。custom 模型并入显示。 */
-async function cachedModels(s, cfg, force = false) {
-	const hit = modelsCache.get(s.id);
-	if (!force && hit && Date.now() - hit.fetchedAt < MODELS_TTL_MS) return hit.models;
-	const list = await Promise.resolve(s.listModels());
-	const custom = new Set(cfg.custom);
-	const disabled = new Set(cfg.disabled);
-	const models = list.map((mm) => ({
-		...mm,
-		enabled: !disabled.has(mm.id),
-		custom: custom.has(mm.id) ? true : void 0
-	}));
-	const seen = new Set(models.map((mm) => mm.id));
-	for (const id of custom) if (!seen.has(id)) {
-		seen.add(id);
-		models.push({
-			id,
-			enabled: !disabled.has(id),
-			custom: true
-		});
+/** 账号状态指纹（积分 + 健康），用于判断刷新是否落地。 */
+function fingerprint(accounts) {
+	return accounts.map((a) => `${a.uid}:${a.credits}:${a.cooling}:${a.disabled}`).join("|");
+}
+/**
+* 反复调插件已有的 status()，直到快照稳定再返回（是否有变化 = changed）。
+* 插件的积分刷新是 fire-and-forget（status() 内部异步拉），核心拿不到句柄，
+* 只能按指纹变化等它落地。天花板：缓存未过期时插件不会真拉上游，此时按钮
+* 退化为「重读一次状态」（冷却/禁用这类健康状态仍是 status() 实时算的）。
+* 升级路径：插件暴露可 await 的刷新能力，这里就不用轮询了。
+*/
+async function settleStatus(s, timeoutMs = 3e3) {
+	const first = fingerprint(s.status().accounts);
+	const deadline = Date.now() + timeoutMs;
+	let last = first;
+	let stable = 0;
+	while (Date.now() < deadline) {
+		await new Promise((resolve) => setTimeout(resolve, 200));
+		const now = fingerprint(s.status().accounts);
+		stable = now === last ? stable + 1 : 0;
+		last = now;
+		if (stable >= 2) break;
 	}
-	modelsCache.set(s.id, {
-		models,
-		fetchedAt: Date.now()
-	});
-	return models;
+	return last !== first;
 }
 function mod(s) {
 	return s.supplier.__module ?? {};
 }
 /** 为一个供应商生成端点（通用 + 差异化，返回 route 列表）。 */
-function supplierRoutes(base, loaded, store) {
+function supplierRoutes(base, loaded, store, router) {
 	const s = loaded.supplier;
 	const m = mod(loaded);
 	const c = loaded.capabilities;
@@ -906,7 +1364,7 @@ function supplierRoutes(base, loaded, store) {
 		kind: "exact",
 		path: `${p}/models`,
 		handler: async (_req, res) => {
-			const models = await cachedModels(s, store.get(s.id));
+			const models = await router.modelsOf(s.id);
 			writeJson$1(res, 200, {
 				ok: true,
 				alias: s.getAlias(),
@@ -935,8 +1393,8 @@ function supplierRoutes(base, loaded, store) {
 		path: `${p}/models/toggle`,
 		handler: async (req, res) => {
 			const body = JSON.parse(await readBody$1(req));
-			const cfg = store.get(s.id);
-			const models = await cachedModels(s, cfg);
+			store.get(s.id);
+			const models = await router.modelsOf(s.id);
 			if (!body.id || !models.some((mm) => mm.id === body.id)) {
 				writeJson$1(res, 400, {
 					ok: false,
@@ -945,7 +1403,7 @@ function supplierRoutes(base, loaded, store) {
 				return;
 			}
 			store.setModelEnabled(s.id, body.id, !!body.enabled);
-			modelsCache.delete(s.id);
+			router.invalidateModels(s.id);
 			writeJson$1(res, 200, { ok: true });
 		}
 	});
@@ -961,7 +1419,7 @@ function supplierRoutes(base, loaded, store) {
 				});
 				return;
 			}
-			if ((await cachedModels(s, store.get(s.id))).some((mm) => mm.id === id)) {
+			if ((await router.modelsOf(s.id)).some((mm) => mm.id === id)) {
 				writeJson$1(res, 400, {
 					ok: false,
 					error: `模型 ${id} 已存在`
@@ -969,7 +1427,7 @@ function supplierRoutes(base, loaded, store) {
 				return;
 			}
 			store.addCustomModel(s.id, id);
-			modelsCache.delete(s.id);
+			router.invalidateModels(s.id);
 			writeJson$1(res, 200, { ok: true });
 		}
 	});
@@ -987,7 +1445,7 @@ function supplierRoutes(base, loaded, store) {
 				return;
 			}
 			store.removeCustomModel(s.id, body.id);
-			modelsCache.delete(s.id);
+			router.invalidateModels(s.id);
 			writeJson$1(res, 200, { ok: true });
 		}
 	});
@@ -996,9 +1454,9 @@ function supplierRoutes(base, loaded, store) {
 		path: `${p}/models/bulk`,
 		handler: async (req, res) => {
 			const body = JSON.parse(await readBody$1(req));
-			const models = await cachedModels(s, store.get(s.id));
+			const models = await router.modelsOf(s.id);
 			store.setAllModelsEnabled(s.id, !!body.enabled, models.map((mm) => mm.id));
-			modelsCache.delete(s.id);
+			router.invalidateModels(s.id);
 			writeJson$1(res, 200, { ok: true });
 		}
 	});
@@ -1054,7 +1512,7 @@ function supplierRoutes(base, loaded, store) {
 		handler: async (_req, res) => {
 			writeJson$1(res, 200, {
 				ok: true,
-				models: await cachedModels(s, store.get(s.id), true)
+				models: await router.modelsOf(s.id, true)
 			});
 		}
 	});
@@ -1063,7 +1521,7 @@ function supplierRoutes(base, loaded, store) {
 		path: `${p}/models/test`,
 		handler: async (req, res) => {
 			const body = JSON.parse(await readBody$1(req));
-			const result = await s.testModel(body.id ?? "");
+			const result = await router.testModel(s.id, body.id ?? "");
 			writeJson$1(res, result.ok ? 200 : 400, result);
 		}
 	});
@@ -1158,159 +1616,64 @@ function supplierRoutes(base, loaded, store) {
 	});
 	routes.push({
 		kind: "exact",
-		path: `${p}/checkin/rule`,
-		handler: async (req, res) => {
-			if (req.method === "GET") {
+		path: `${p}/links/refresh`,
+		handler: async (_req, res) => {
+			try {
 				writeJson$1(res, 200, {
 					ok: true,
-					rule: store.get(s.id).checkinRule
+					changed: await settleStatus(s),
+					accounts: s.status().accounts
 				});
-				return;
-			}
-			const body = JSON.parse(await readBody$1(req));
-			if (body.rule !== "all" && body.rule !== "first") {
-				writeJson$1(res, 400, {
+			} catch (err) {
+				writeJson$1(res, 500, {
 					ok: false,
-					error: "rule 必须是 all 或 first"
+					error: err.message
 				});
-				return;
 			}
-			store.setCheckinRule(s.id, body.rule);
-			writeJson$1(res, 200, { ok: true });
 		}
 	});
 	if (cap(c, "checkinNow")) routes.push({
 		kind: "exact",
 		path: `${p}/checkin`,
 		handler: async (_req, res) => {
-			try {
-				const result = await m.checkinNow.call(loaded.supplier);
-				writeJson$1(res, result.ok === false ? 400 : 200, result);
+			const checkinOne = m.checkinNow;
+			if (!checkinOne) {
+				writeJson$1(res, 400, {
+					ok: false,
+					error: "该供应商不支持签到"
+				});
+				return;
+			}
+			const uids = s.status().accounts.map((a) => a.uid);
+			const results = [];
+			for (const uid of uids) try {
+				results.push({
+					uid,
+					...await checkinOne.call(loaded.supplier, uid)
+				});
 			} catch (err) {
-				writeJson$1(res, 500, {
+				results.push({
+					uid,
 					ok: false,
-					error: err.message
+					status: "error",
+					message: err.message
 				});
 			}
+			const succeeded = results.filter((r) => r.status === "ok").length;
+			const already = results.filter((r) => r.status === "already").length;
+			const payload = {
+				ok: succeeded + already > 0,
+				total: uids.length,
+				succeeded,
+				already,
+				results
+			};
+			writeJson$1(res, payload.ok ? 200 : 400, payload);
 		}
 	});
 	return routes;
 }
 //#endregion
-//#region src/supplier-config.ts
-/**
-* 通用供应商配置 —— dsh-router 核心能力,按供应商 id 存储。
-*
-* 通用能力(所有供应商共享,供应商 js 不需要实现)：
-*   - 别名 alias(前缀,模型全名 = alias/id)
-*   - 模型管理:启用/禁用 disabled、自定义 custom
-*   - 连接池:poolOrder(拖动排序)、poolStrategy(回退/轮询)
-*   - 签到规则 checkinRule(所有链接 / 首个链接)
-*
-* 持久化到 data/supplier-config.json。
-*/
-/** 通用供应商配置存储。 */
-var SupplierConfigStore = class {
-	fp = "";
-	bySupplier = /* @__PURE__ */ new Map();
-	constructor(stateFile) {
-		this.fp = stateFile ? join(dirname(stateFile), "supplier-config.json") : "";
-		this.load();
-	}
-	/** 读取某供应商配置(不存在则返回默认并注册)。 */
-	get(supplierId) {
-		let cfg = this.bySupplier.get(supplierId);
-		if (!cfg) {
-			cfg = {
-				alias: "",
-				disabled: [],
-				custom: [],
-				poolOrder: [],
-				poolStrategy: "fallback",
-				checkinRule: "all"
-			};
-			this.bySupplier.set(supplierId, cfg);
-		}
-		return cfg;
-	}
-	setAlias(supplierId, alias) {
-		this.get(supplierId).alias = alias;
-		this.saveLocked();
-	}
-	setModelEnabled(supplierId, modelId, enabled) {
-		const cfg = this.get(supplierId);
-		cfg.disabled = enabled ? cfg.disabled.filter((m) => m !== modelId) : [.../* @__PURE__ */ new Set([...cfg.disabled, modelId])];
-		this.saveLocked();
-	}
-	setAllModelsEnabled(supplierId, enabled, allModelIds) {
-		const cfg = this.get(supplierId);
-		cfg.disabled = enabled ? [] : [...new Set(allModelIds)];
-		this.saveLocked();
-	}
-	addCustomModel(supplierId, modelId) {
-		const cfg = this.get(supplierId);
-		if (!cfg.custom.includes(modelId)) cfg.custom.push(modelId);
-		this.saveLocked();
-	}
-	removeCustomModel(supplierId, modelId) {
-		const cfg = this.get(supplierId);
-		cfg.custom = cfg.custom.filter((m) => m !== modelId);
-		cfg.disabled = cfg.disabled.filter((m) => m !== modelId);
-		this.saveLocked();
-	}
-	setPoolOrder(supplierId, uids) {
-		this.get(supplierId).poolOrder = [...new Set(uids)];
-		this.saveLocked();
-	}
-	setPoolStrategy(supplierId, strategy) {
-		if (strategy !== "fallback" && strategy !== "round-robin") return;
-		this.get(supplierId).poolStrategy = strategy;
-		this.saveLocked();
-	}
-	setCheckinRule(supplierId, rule) {
-		if (rule !== "all" && rule !== "first") return;
-		this.get(supplierId).checkinRule = rule;
-		this.saveLocked();
-	}
-	load() {
-		if (this.fp === "") return;
-		let f;
-		try {
-			f = JSON.parse(readFileSync(this.fp, "utf8"));
-		} catch {
-			return;
-		}
-		for (const [id, c] of Object.entries(f.suppliers ?? {})) this.bySupplier.set(id, {
-			alias: typeof c.alias === "string" ? c.alias : "",
-			disabled: Array.isArray(c.disabled) ? c.disabled.filter((m) => typeof m === "string") : [],
-			custom: Array.isArray(c.custom) ? c.custom.filter((m) => typeof m === "string") : [],
-			poolOrder: Array.isArray(c.poolOrder) ? c.poolOrder.filter((u) => typeof u === "string") : [],
-			poolStrategy: c.poolStrategy === "round-robin" ? "round-robin" : "fallback",
-			checkinRule: c.checkinRule === "first" ? "first" : "all"
-		});
-	}
-	saveLocked() {
-		if (this.fp === "") return;
-		const f = { suppliers: {} };
-		for (const [id, cfg] of this.bySupplier) f.suppliers[id] = {
-			alias: cfg.alias,
-			disabled: [...cfg.disabled],
-			custom: [...cfg.custom],
-			poolOrder: [...cfg.poolOrder],
-			poolStrategy: cfg.poolStrategy,
-			checkinRule: cfg.checkinRule
-		};
-		try {
-			const dir = dirname(this.fp);
-			if (dir !== "" && dir !== ".") mkdirSync(dir, { recursive: true });
-			const raw = JSON.stringify(f, null, 2);
-			const tmp = this.fp + ".tmp";
-			writeFileSync(tmp, raw, { mode: 384 });
-			renameSync(tmp, this.fp);
-		} catch {}
-	}
-};
-//#endregion
 //#region src/credential-store.ts
 /**
 * 通用凭证存储 —— dsh-router 核心统一管账号凭证（SQLite，参考 9router 的
@@ -1399,7 +1762,7 @@ function apply(rawContext) {
 	const stateFile = process.env.TW2A_STATE_FILE ?? "data/state.json";
 	const store = new SupplierConfigStore(stateFile);
 	const credentials = new CredentialStore(process.env.TW2A_AUTH_DIR ?? join(dirname(stateFile), "auths"));
-	const router = new Router(stateFile);
+	const router = new Router(stateFile, store);
 	const keys = new KeysStore(stateFile);
 	const disposers = [];
 	const route = (path, handler) => {
@@ -1414,7 +1777,7 @@ function apply(rawContext) {
 	const supplierDisposers = /* @__PURE__ */ new Map();
 	const registerSupplierRoutes = (loaded) => {
 		const dis = [];
-		for (const r of supplierRoutes(ROUTER_API_BASE, loaded, store)) dis.push(ctx.webServer.register(r));
+		for (const r of supplierRoutes(ROUTER_API_BASE, loaded, store, router)) dis.push(ctx.webServer.register(r));
 		supplierDisposers.set(loaded.supplier.id, dis);
 		log(`supplier routes registered: ${loaded.supplier.id}`);
 	};