dsh-router-core 0.3.9 → 0.3.11

package/lib/index.js

@@ -1,9 +1,10 @@
-import { basename, dirname, join } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 import { mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
-import { EMPTY_RESPONSE_CODE, LlmAdapter, LlmError, ToolCallId, attributionHeaders } from "@deepseek-ai/dsh-llm";
+import { EMPTY_RESPONSE_CODE, LlmAdapter, LlmError, ReasoningEffortId, ToolCallId, attributionHeaders } from "@deepseek-ai/dsh-llm";
 import { randomBytes } from "node:crypto";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { DatabaseSync } from "node:sqlite";
+import { homedir } from "node:os";
 //#region src/shared.ts
 /** Same-origin API base the client panel fetches (host half serves it). */
 const ROUTER_API_BASE = "/router/api";
@@ -256,6 +257,13 @@ function readCredits(raw) {
 	for (const [uid, v] of Object.entries(raw)) if (typeof v === "number" && Number.isFinite(v) && v >= 0) out[uid] = v;
 	return out;
 }
+/** 读盘时的连接显示别名校验：只留非空字符串。 */
+function readNames(raw) {
+	const out = {};
+	if (typeof raw !== "object" || raw === null) return out;
+	for (const [uid, v] of Object.entries(raw)) if (typeof v === "string" && v.trim() !== "") out[uid] = v.trim();
+	return out;
+}
 /** 通用供应商配置存储。 */
 var SupplierConfigStore = class {
 	fp = "";
@@ -286,7 +294,8 @@ var SupplierConfigStore = class {
 				custom: [],
 				poolOrder: [],
 				poolStrategy: "fallback",
-				credits: {}
+				credits: {},
+				accountNames: {}
 			};
 			this.bySupplier.set(supplierId, cfg);
 		}
@@ -338,6 +347,24 @@ var SupplierConfigStore = class {
 		this.get(supplierId).poolStrategy = strategy;
 		this.saveLocked();
 	}
+	/** 读某连接的显示别名;没设或为空返回 `undefined`(用供应商原始昵称)。 */
+	getAccountName(supplierId, uid) {
+		const n = this.get(supplierId).accountNames[uid];
+		return typeof n === "string" && n !== "" ? n : void 0;
+	}
+	/** 设置连接显示名。空名 = 删除别名(回到供应商原始昵称)。 */
+	setAccountName(supplierId, uid, name) {
+		const cfg = this.get(supplierId);
+		const clean = (name ?? "").trim();
+		if (clean === "") {
+			if (cfg.accountNames[uid] === void 0) return;
+			delete cfg.accountNames[uid];
+			this.saveLocked();
+			return;
+		}
+		cfg.accountNames[uid] = clean;
+		this.saveLocked();
+	}
 	/**
 	* 读缓存的积分。没缓存过返回 `CREDITS_UNKNOWN`(-1),让调用方自己决定
 	* 显示什么——不要把 -1 当 0 展示。
@@ -378,7 +405,8 @@ var SupplierConfigStore = class {
 			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",
-			credits: readCredits(c.credits)
+			credits: readCredits(c.credits),
+			accountNames: readNames(c.accountNames)
 		});
 	}
 	saveLocked() {
@@ -390,7 +418,8 @@ var SupplierConfigStore = class {
 			custom: [...cfg.custom],
 			poolOrder: [...cfg.poolOrder],
 			poolStrategy: cfg.poolStrategy,
-			credits: { ...cfg.credits }
+			credits: { ...cfg.credits },
+			accountNames: { ...cfg.accountNames }
 		};
 		try {
 			const dir = dirname(this.fp);
@@ -1580,6 +1609,36 @@ var Router = class {
 	* 只有两种情况会真的等:`force`(用户主动刷新)和**从来没有过缓存值**
 	* (冷启动,没有旧值可给)。后者只发生一次。
 	*/
+	/**
+	* 组合的上下文窗口(token):组合内各模型窗口的**最小值**,拿不到就 undefined。
+	*
+	* 只读缓存、绝不打上游:调用方是 llm adapter 的 `resolveModel`,它在每次
+	* 请求前后都可能被调用,不能为了报一个容量去触发按供应商的网络往返。
+	* 冷启动(还没缓存)时给 undefined —— 自动压缩会因此跳过这一轮,下次就
+	* 有了,比撒谎说一个窗口值安全。
+	*
+	* 单位:`ModelInfo.context_length` 存的是 **K**(供应商插件统一
+	* `Math.round(tokens / 1000)`,见 codebuddy plugin),这里换算回 token。
+	*
+	* 取最小而不是最大:组合会按策略 fallback 到任意一个模型,按最窄的声明
+	* 才能让「快满了」这件事在任何一条分支上都成立。
+	*/
+	comboContextWindow(combo) {
+		let min;
+		for (const ref of combo.models) {
+			const at = ref.indexOf(",");
+			if (at < 0) continue;
+			const supplierId = ref.slice(0, at);
+			const modelId = ref.slice(at + 1);
+			const hit = this.modelsCache.get(supplierId);
+			if (hit === void 0) return void 0;
+			const k = hit.models.find((x) => x.id === modelId)?.context_length;
+			if (typeof k !== "number" || !Number.isFinite(k) || k <= 0) continue;
+			const tokens = Math.round(k * 1e3);
+			if (min === void 0 || tokens < min) min = tokens;
+		}
+		return min;
+	}
 	async modelsOf(supplierId, force = false) {
 		const s = this.suppliers.find((x) => x.id === supplierId);
 		if (s === void 0) return [];
@@ -1919,7 +1978,7 @@ var Router = class {
 		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);
+			const r = await s.chatOnce("", req.lv ?? "auto", req);
 			if (!r.ok) {
 				if (r.state === "no_such_model") return false;
 				if (trace !== void 0) trace.lastState = r.state;
@@ -1939,7 +1998,7 @@ var Router = class {
 			const uid = pool.pick(s.accounts().filter((a) => !tried.has(a.uid)), cfg.poolOrder, cfg.poolStrategy, req.model);
 			if (uid === void 0) return false;
 			tried.add(uid);
-			const r = await s.chatOnce(uid, req);
+			const r = await s.chatOnce(uid, req.lv ?? "auto", req);
 			if (!r.ok) {
 				if (r.state === "no_such_model") {
 					if (trace !== void 0) trace.lastError = "no_such_model";
@@ -2342,6 +2401,25 @@ function completeJson(text) {
 * DSH adapter：provider `router`。模型目录 = 组合；stream 转发到本插件
 * /v1/chat/completions（组合路由在 /v1 内完成）。
 */
+/** Router provider 对外暴露的推理等级（对齐 dsh/DeepSeek：off/low/high/max）。 */
+const ROUTER_REASONING_EFFORTS = [
+	{
+		id: ReasoningEffortId("off"),
+		name: "Off"
+	},
+	{
+		id: ReasoningEffortId("low"),
+		name: "Low"
+	},
+	{
+		id: ReasoningEffortId("high"),
+		name: "High"
+	},
+	{
+		id: ReasoningEffortId("max"),
+		name: "Max"
+	}
+];
 var RouterAdapter = class extends LlmAdapter {
 	baseURL;
 	source;
@@ -2371,6 +2449,19 @@ var RouterAdapter = class extends LlmAdapter {
 		}
 		return out;
 	}
+	async resolveModel(_provider, model) {
+		const found = (await this.source.comboModels()).find((m) => m.id === model || m.name === model);
+		return {
+			provider: "router",
+			id: model,
+			name: found?.name ?? found?.id ?? model,
+			...found?.contextWindow !== void 0 ? { context: { contextWindow: found.contextWindow } } : {},
+			reasoning: {
+				efforts: ROUTER_REASONING_EFFORTS,
+				defaultEffort: ReasoningEffortId("high")
+			}
+		};
+	}
 	async *stream(options) {
 		const body = wireRequest(options);
 		const controller = new AbortController();
@@ -2637,15 +2728,24 @@ const DIFF_CAPS = [
 	"pollLogin",
 	"checkinNow"
 ];
+/**
+* 每个供应商一份 env 副本：`onLateFailure` 是**按供应商**绑到本供应商的池上
+* 的（见 wrapModule），共用一个 env 对象会让所有插件的上报都落到最后一个
+* 供应商的池里。副本是浅拷贝，store/credentials 仍是同一实例。
+*/
+function ownEnv(env) {
+	return { ...env };
+}
 /** 从文件构造 LoadedSupplier。 */
 async function loadOne(file, env, source) {
 	const mod = await importSupplierFile(file);
+	const mine = ownEnv(env);
 	let instance;
 	if (typeof mod === "function") {
-		instance = mod(env);
+		instance = mod(mine);
 		if (typeof instance !== "object" || instance === null || typeof instance.id !== "string" || instance.id === "") throw new Error(`供应商 factory 返回无效: ${file}`);
 	} else instance = mod;
-	return wrapModule(instance, env, file, source);
+	return wrapModule(instance, mine, file, source);
 }
 /**
 * 从 SupplierModule 实例构造 LoadedSupplier（能力检测 + Supplier 包装）。
@@ -2656,17 +2756,29 @@ function wrapModule(instance, env, source, kind = "external") {
 	const capabilities = /* @__PURE__ */ new Set();
 	for (const key of DIFF_CAPS) if (isFn(instance[key])) capabilities.add(key);
 	const pool = new AccountPool(instance.id);
+	env.onLateFailure = (uid, model, state, message) => {
+		if (uid === "") return;
+		pool.noteFailure(uid, model, state, message);
+	};
 	const supplier = {
 		id: instance.id,
 		name: instance.name,
 		priority: instance.priority ?? 0,
 		icon: instance.icon,
+		apiKeyHint: instance.apiKeyHint,
 		status: () => {
 			const now = instance.status();
+			const accounts = now.accounts.map((a) => {
+				const alias = env.store.getAccountName(instance.id, a.uid);
+				return alias === void 0 || alias === a.nickname ? a : {
+					...a,
+					nickname: alias
+				};
+			});
 			return {
 				id: now.id,
 				name: now.name,
-				accounts: pool.decorate(hydrateCredits(instance.id, env.store, now.accounts))
+				accounts: pool.decorate(hydrateCredits(instance.id, env.store, accounts))
 			};
 		},
 		listModels: (force) => instance.listModels(force),
@@ -2683,7 +2795,7 @@ function wrapModule(instance, env, source, kind = "external") {
 		getAlias: () => env.store.get(instance.id).alias || instance.id,
 		customModelIds: () => [...env.store.get(instance.id).custom],
 		accounts: () => instance.status().accounts,
-		chatOnce: (uid, req) => instance.chatOnce(uid, req),
+		chatOnce: (uid, lv, req) => instance.chatOnce(uid, lv, req),
 		removeLink: isFn(instance.removeLink) ? (uid) => instance.removeLink(uid) : void 0,
 		dispose: () => instance.dispose(),
 		pool
@@ -3179,6 +3291,43 @@ var CredentialStore = class {
 	}
 };
 //#endregion
+//#region src/data-dir.ts
+/**
+* 落盘路径解析 —— dsh-router 所有持久化路径的唯一来源。
+*
+* 以前写的是相对路径 `data/state.json`：**落盘位置跟着 `process.cwd()` 跑**。
+* 不在 `~/.dsh/profiles/web` 里 `dsh web` 启动，state.json / supplier-config.json
+* / keys.json / usage.json 就会静默写进另一个目录（面板显示空配置），切回原目录
+* 启动又「回来」——用户看到的是「配置丢了」。所以这里一律产出绝对路径。
+*/
+/**
+* 本 profile 的目录。
+*
+* 宿主把配置树锚点 `ctx.baseUrl` 挂在每个插件的 context 上，它正是 profile
+* 目录（`cordis.yml` 所在处）——不用猜、也不用像 dsh-market 那样嗅探 argv。
+* 兜底只服务「宿主没给锚点」的冷启动（单测、非常规宿主）：沿用今天的事实
+* 标准 `web` profile。
+*/
+function profileDirOf(baseUrl) {
+	if (typeof baseUrl === "string" && baseUrl !== "") try {
+		return resolve(fileURLToPath(baseUrl));
+	} catch {}
+	return join(dshHome(), "profiles", "web");
+}
+/** 数据目录：state.json / supplier-config.json / keys.json / auths/ 都在这里。 */
+function dataDirOf(baseUrl) {
+	return join(profileDirOf(baseUrl), "data");
+}
+/** `$DSH_HOME`（支持 `~` 前缀），缺省 `~/.dsh`。 */
+function dshHome() {
+	const raw = process.env.DSH_HOME;
+	if (raw === void 0 || raw.trim() === "") return join(homedir(), ".dsh");
+	const value = raw.trim();
+	if (value === "~") return homedir();
+	if (value.startsWith("~/") || value.startsWith("~\\")) return resolve(homedir(), value.slice(2));
+	return resolve(value);
+}
+//#endregion
 //#region src/index.ts
 /**
 * Plugin identity for cordis.yml rows — 必须与 package.json 的 name 一致。
@@ -3216,9 +3365,11 @@ function readBody(req, limit) {
 function apply(rawContext) {
 	const ctx = rawContext;
 	const log = (msg) => ctx.logger.info(`[dsh-router] ${msg}`);
-	const stateFile = "data/state.json";
+	const dataDir = dataDirOf(ctx.baseUrl);
+	const stateFile = join(dataDir, "state.json");
+	log(`data dir: ${dataDir}`);
 	const store = new SupplierConfigStore(stateFile);
-	const credentials = new CredentialStore(join(dirname(stateFile), "auths"));
+	const credentials = new CredentialStore(join(dataDir, "auths"));
 	const router = new Router(stateFile, store, log);
 	const keys = new KeysStore(stateFile);
 	const disposers = [];
@@ -3250,7 +3401,6 @@ function apply(rawContext) {
 		log(`supplier unregistered: ${id}`);
 	};
 	ctx.provide("router.suppliers", {});
-	const dataDir = dirname(stateFile);
 	const registerLoaded = (loaded) => {
 		loadedSuppliers.push(loaded);
 		router.add(loaded.supplier);
@@ -3296,7 +3446,7 @@ function apply(rawContext) {
 	});
 	(async () => {
 		try {
-			const userDir = join(join(process.env.HOME ?? "", ".dsh", "profiles", "web"), "suppliers");
+			const userDir = join(profileDirOf(ctx.baseUrl), "suppliers");
 			const { suppliers, errors } = await loadSuppliers({
 				builtinDir: join(import.meta.dirname, "suppliers"),
 				userDir,
@@ -3356,10 +3506,12 @@ function apply(rawContext) {
 			} });
 			return;
 		}
+		const lv = typeof peek.reasoning_effort === "string" && peek.reasoning_effort !== "" ? peek.reasoning_effort : "auto";
 		await router.chatCompletions({
 			rawBody: body,
 			stream: !!peek.stream,
-			model: typeof peek.model === "string" ? peek.model : ""
+			model: typeof peek.model === "string" ? peek.model : "",
+			lv
 		}, res);
 	}));
 	route(`${ROUTER_API_BASE}/health`, (_req, res) => {
@@ -3372,6 +3524,7 @@ function apply(rawContext) {
 					id: s.id,
 					name: s.name,
 					icon: loaded?.supplier.icon,
+					apiKeyHint: loaded?.supplier.apiKeyHint,
 					capabilities: loaded ? [...loaded.capabilities] : [],
 					source: loaded?.source ?? "external"
 				};
@@ -3388,6 +3541,27 @@ function apply(rawContext) {
 			})))
 		});
 	});
+	route(`${ROUTER_API_BASE}/status/rename`, async (req, res) => {
+		let body;
+		try {
+			body = JSON.parse(await readBody(req, 65536));
+		} catch {
+			writeJson(res, 400, {
+				ok: false,
+				error: "invalid JSON body"
+			});
+			return;
+		}
+		if (typeof body.supplier !== "string" || body.supplier === "" || typeof body.uid !== "string" || body.uid === "") {
+			writeJson(res, 400, {
+				ok: false,
+				error: "supplier and uid are required"
+			});
+			return;
+		}
+		store.setAccountName(body.supplier, body.uid, typeof body.name === "string" ? body.name : "");
+		writeJson(res, 200, { ok: true });
+	});
 	route(`${ROUTER_API_BASE}/models`, async (_req, res) => {
 		try {
 			writeJson(res, 200, {
@@ -3587,8 +3761,23 @@ function apply(rawContext) {
 			disposers.push(ctx.llm.registerModelDiscovery(LLM_NS, async () => {
 				return (await router.combos()).map((c) => ({ id: c.name }));
 			}));
-			disposers.push(ctx.llm.registerAdapter(["router"], new RouterAdapter("http://localhost:3080/v1", { comboModels: async () => (await router.combos()).map((c) => ({ id: c.name })) })));
+			disposers.push(ctx.llm.registerAdapter(["router"], new RouterAdapter("http://localhost:3080/v1", { comboModels: async () => (await router.combos()).map((c) => {
+				const w = router.comboContextWindow(c);
+				return {
+					id: c.name,
+					...w !== void 0 ? { contextWindow: w } : {}
+				};
+			}) })));
 			log("llm provider (Router) + discovery + adapter registered ok");
+			(async () => {
+				for (const c of await router.combos()) for (const ref of c.models) {
+					const at = ref.indexOf(",");
+					if (at < 0) continue;
+					try {
+						await router.modelsOf(ref.slice(0, at));
+					} catch {}
+				}
+			})().catch(() => {});
 		} catch (err) {
 			ctx.logger.warn(`[dsh-router] llm registration failed: ${err.message}`);
 		}

package/lib/suppliers/nvidia.js

@@ -260,7 +260,7 @@ function factory(env) {
 			return true;
 		},
 		/** 对单个 key 调一次上游。选号/冷却/换号是核心的活，这里只报结果。 */
-		async chatOnce(uid, req) {
+		async chatOnce(uid, lv, req) {
 			const base = stripAlias(req.model, currentAlias());
 			if (!(await allModels(false)).some((m) => m.id === base)) return {
 				ok: false,
@@ -277,6 +277,11 @@ function factory(env) {
 			try {
 				const obj = JSON.parse(body);
 				obj.model = base;
+				if (lv !== "auto" && lv !== "" && lv !== "none" && lv !== "off") obj.reasoning_effort = lv;
+				else if (lv === "none" || lv === "off") {
+					delete obj.reasoning_effort;
+					delete obj.reasoning_summary;
+				}
 				body = JSON.stringify(obj);
 			} catch {}
 			let upstream;

package/lib/suppliers/opencode.js

@@ -64,7 +64,7 @@ function factory(env) {
 		}),
 		listModels: (force) => allModels(!!force),
 		/** 无账号供应商：uid 恒为空，只认 free 模型。 */
-		async chatOnce(_uid, req) {
+		async chatOnce(_uid, lv, req) {
 			if (!isFreeModel(req.model)) return {
 				ok: false,
 				state: "no_such_model",
@@ -74,6 +74,11 @@ function factory(env) {
 			try {
 				const obj = JSON.parse(body);
 				obj.model = stripAlias(String(obj.model ?? req.model), currentAlias());
+				if (lv !== "auto" && lv !== "" && lv !== "none" && lv !== "off") obj.reasoning_effort = lv;
+				else if (lv === "none" || lv === "off") {
+					delete obj.reasoning_effort;
+					delete obj.reasoning_summary;
+				}
 				body = JSON.stringify(obj);
 			} catch {}
 			let upstream;

package/lib/suppliers/openrouter.js

@@ -4,6 +4,10 @@ const name = "OpenRouter";
 const priority = 10;
 /** 面板图标。 */
 const icon = "data:image/png;base64,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";
+/**
+* 「添加 API key」弹窗提示（OpenRouter API key 获取页）。
+*/
+const apiKeyHint = "填入 OpenRouter API key（https://openrouter.ai/settings/keys），可起名字区分多个 key。";
 const BASE = "https://openrouter.ai/api/v1";
 const MODELS_URL = `${BASE}/models`;
 const CHAT_URL = `${BASE}/chat/completions`;
@@ -79,6 +83,7 @@ function factory(env) {
 		name,
 		priority: 10,
 		icon,
+		apiKeyHint,
 		status: () => {
 			const accounts = orderedKeys().map(({ uid, acct }) => ({
 				uid,
@@ -142,7 +147,7 @@ function factory(env) {
 			return true;
 		},
 		/** 对单个 key 调一次上游。选号/冷却/换号是核心的活，这里只报结果。 */
-		async chatOnce(uid, req) {
+		async chatOnce(uid, lv, req) {
 			const base = stripAlias(req.model, currentAlias());
 			if (!freeIds.has(base) && !(await allModels(false)).some((m) => m.id === base)) return {
 				ok: false,
@@ -159,6 +164,11 @@ function factory(env) {
 			try {
 				const obj = JSON.parse(body);
 				obj.model = base;
+				if (lv !== "auto" && lv !== "" && lv !== "none" && lv !== "off") obj.reasoning_effort = lv;
+				else if (lv === "none" || lv === "off") {
+					delete obj.reasoning_effort;
+					delete obj.reasoning_summary;
+				}
 				body = JSON.stringify(obj);
 			} catch {}
 			let upstream;
@@ -219,4 +229,4 @@ function factory(env) {
 	};
 }
 //#endregion
-export { factory as default, icon, id, name, priority };
+export { apiKeyHint, factory as default, icon, id, name, priority };

package/lib/types/data-dir.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 本 profile 的目录。
+ *
+ * 宿主把配置树锚点 `ctx.baseUrl` 挂在每个插件的 context 上，它正是 profile
+ * 目录（`cordis.yml` 所在处）——不用猜、也不用像 dsh-market 那样嗅探 argv。
+ * 兜底只服务「宿主没给锚点」的冷启动（单测、非常规宿主）：沿用今天的事实
+ * 标准 `web` profile。
+ */
+export declare function profileDirOf(baseUrl?: string): string;
+/** 数据目录：state.json / supplier-config.json / keys.json / auths/ 都在这里。 */
+export declare function dataDirOf(baseUrl?: string): string;

package/lib/types/llm/adapter.d.ts

@@ -6,12 +6,19 @@
  *
  * 纯文本流：组合为文本模型，本 adapter 不处理图片附件。
  */
-import { LlmAdapter, type GenerateOptions, type LlmModelInfo, type StreamChunk } from '@deepseek-ai/dsh-llm';
+import { LlmAdapter, type GenerateOptions, type LlmModelInfo, type LlmResolvedModelInfo, type StreamChunk } from '@deepseek-ai/dsh-llm';
 /** 模型目录来源：组合。 */
 export interface RouterAdapterSource {
+    /**
+     * 组合列表。`contextWindow` 可选，但**必须尽量给**——自动压缩靠它算阈值
+     * （`dsh-compaction-basic` 在 `context` 缺失时直接抛错并静默关闭自动压缩，
+     * 于是上下文会一路涨到模型硬上限才炸）。
+     * 组合背后是异构供应商时给**最小的那个**（保守，宁可早压缩）。
+     */
     comboModels: () => Promise<Array<{
         id: string;
         name?: string;
+        contextWindow?: number;
     }>>;
 }
 /** openai SSE payload → DSH StreamChunk 流。导出以便单测锁死 usage 契约。 */
@@ -22,10 +29,6 @@ export interface RouterAdapterSource {
  * 用 `for await` 是因为它天然兼容两者 —— 不必为流式再写一份。
  */
 export declare function translateSse(payloads: AsyncIterable<string> | Iterable<string>): AsyncGenerator<StreamChunk>;
-/**
- * DSH adapter：provider `router`。模型目录 = 组合；stream 转发到本插件
- * /v1/chat/completions（组合路由在 /v1 内完成）。
- */
 export declare class RouterAdapter extends LlmAdapter {
     private readonly baseURL;
     private readonly source;
@@ -35,5 +38,6 @@ export declare class RouterAdapter extends LlmAdapter {
         name: string;
     };
     listModels(_provider: string): Promise<readonly LlmModelInfo[]>;
+    resolveModel(_provider: string, model: string): Promise<LlmResolvedModelInfo>;
     stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
 }

package/lib/types/router/index.d.ts

@@ -66,6 +66,21 @@ export declare class Router {
      * 只有两种情况会真的等:`force`(用户主动刷新)和**从来没有过缓存值**
      * (冷启动,没有旧值可给)。后者只发生一次。
      */
+    /**
+     * 组合的上下文窗口(token):组合内各模型窗口的**最小值**,拿不到就 undefined。
+     *
+     * 只读缓存、绝不打上游:调用方是 llm adapter 的 `resolveModel`,它在每次
+     * 请求前后都可能被调用,不能为了报一个容量去触发按供应商的网络往返。
+     * 冷启动(还没缓存)时给 undefined —— 自动压缩会因此跳过这一轮,下次就
+     * 有了,比撒谎说一个窗口值安全。
+     *
+     * 单位:`ModelInfo.context_length` 存的是 **K**(供应商插件统一
+     * `Math.round(tokens / 1000)`,见 codebuddy plugin),这里换算回 token。
+     *
+     * 取最小而不是最大:组合会按策略 fallback 到任意一个模型,按最窄的声明
+     * 才能让「快满了」这件事在任何一条分支上都成立。
+     */
+    comboContextWindow(combo: Combo): number | undefined;
     modelsOf(supplierId: string, force?: boolean): Promise<ModelWithEnabled[]>;
     /**
      * 真拉一次上游并写缓存。并发调用共享同一个 in-flight promise——

package/lib/types/router/types.d.ts

@@ -48,6 +48,8 @@ export interface ChatRequest {
     rawBody: string;
     stream: boolean;
     model: string;
+    /** 推理等级（reasoning effort），供应商各自决定怎么映射到上游。缺省 = 'auto'。 */
+    lv?: string;
 }
 /**
  * 供应商接口。核心负责账号池（选号/冷却/禁用/错误累计/遍历回退），
@@ -60,6 +62,8 @@ export interface Supplier {
     readonly priority: number;
     /** 图标（URL 或 SVG data URI），面板供应商卡片显示。可选。 */
     readonly icon?: string;
+    /** 「添加 API key」弹窗提示文案（缺省前端用通用文案）。可选。 */
+    readonly apiKeyHint?: string;
     status(): SupplierStatus;
     listModels(force?: boolean): Promise<ModelInfo[]> | ModelInfo[];
     /** 面板展示的模型（含启用/自定义标记）。 */
@@ -71,7 +75,7 @@ export interface Supplier {
     /** 账号「现在状态」（从 status() 派生，插件只报它观察到的）。空 = 无账号供应商。 */
     accounts(): SupplierAccountNow[];
     /** 对单个账号调一次上游。不遍历账号、不管冷却、不写 res。 */
-    chatOnce(uid: string, req: ChatRequest): Promise<ChatOnceResult>;
+    chatOnce(uid: string, lv: string, req: ChatRequest): Promise<ChatOnceResult>;
     /** 删除链接（清理凭证；内部能力，js 契约不要求实现）。 */
     removeLink?(uid: string): Promise<boolean>;
     dispose(): void;

package/lib/types/shared.d.ts

@@ -68,6 +68,8 @@ export interface RouterHealthResponse {
         name: string;
         /** 图标（URL 或 SVG data URI）。 */
         icon?: string;
+        /** 「添加 API key」弹窗提示文案（缺省前端用通用文案）。 */
+        apiKeyHint?: string;
         /** 面板能力集合（登录/签到/连接池/模型管理等，按存在性）。 */
         capabilities?: string[];
         /** 来源：内置 / 用户目录 / 外部插件。 */

package/lib/types/supplier-config.d.ts

@@ -16,6 +16,8 @@ export interface SupplierConfig {
     poolStrategy: PoolStrategy;
     /** 积分缓存:uid → 剩余额度(最后一次从插件拿到的非 -1 值)。 */
     credits: Record<string, number>;
+    /** 每连接显示别名:uid → 显示名(空/缺省用供应商原始昵称,纯展示不改路由键)。 */
+    accountNames: Record<string, string>;
 }
 /** 通用供应商配置存储。 */
 export declare class SupplierConfigStore {
@@ -45,6 +47,10 @@ export declare class SupplierConfigStore {
     removeCustomModel(supplierId: string, modelId: string): void;
     setPoolOrder(supplierId: string, uids: string[]): void;
     setPoolStrategy(supplierId: string, strategy: string): void;
+    /** 读某连接的显示别名;没设或为空返回 `undefined`(用供应商原始昵称)。 */
+    getAccountName(supplierId: string, uid: string): string | undefined;
+    /** 设置连接显示名。空名 = 删除别名(回到供应商原始昵称)。 */
+    setAccountName(supplierId: string, uid: string, name: string): void;
     /**
      * 读缓存的积分。没缓存过返回 `CREDITS_UNKNOWN`(-1),让调用方自己决定
      * 显示什么——不要把 -1 当 0 展示。