@dsh-plus/llm-pi 0.1.27 → 0.1.28

package/lib/index.js

@@ -8,7 +8,7 @@ import { request as request$1 } from "node:https";
 import { dirname, join, resolve } from "node:path";
 import { HttpsProxyAgent } from "https-proxy-agent";
 import { credentialKeyId, credentialKeyScope, credentialRef, isCredentialKeySegment, isCredentialRefName } from "@deepseek-ai/dsh-credentials";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import * as vendoredAnonId from "@deepseek-ai/dsh-anonymous-user-id";
 import * as vendoredLlm from "@deepseek-ai/dsh-llm";
 import { LlmError } from "@deepseek-ai/dsh-llm";
@@ -201,8 +201,313 @@ function inheritedCatalogEntries(kit, provider) {
 	}));
 }
 //#endregion
+//#region src/compat-gates.ts
+/** 从 `{` 起做括号配对，返回内部文本；未配对返回 undefined。 */
+function balancedBody(text, openIndex) {
+	const start = text.indexOf("{", openIndex);
+	if (start < 0) return void 0;
+	let depth = 0;
+	for (let i = start; i < text.length; i += 1) {
+		const ch = text[i];
+		if (ch === "{") depth += 1;
+		else if (ch === "}") {
+			depth -= 1;
+			if (depth === 0) return text.slice(start + 1, i);
+		}
+	}
+}
+/** 解析 `field: "offer" | "withhold"` 键值对。 */
+function parseGateFields(body) {
+	const out = {};
+	for (const m of body.matchAll(/(\w+):\s*"(offer|withhold)"/g)) out[m[1]] = m[2];
+	return out;
+}
+/** 取 `const NAME = { ... }` 的块体（兼容 `let`/`var` 与省略分号）。 */
+function namedBlock(bundle, name) {
+	const m = new RegExp(`(?:const|let|var)\\s+${name}\\s*=\\s*`).exec(bundle);
+	return m === null ? void 0 : balancedBody(bundle, m.index + m[0].length);
+}
+/** 解析顶层 `"api": IDENT` 与 `"api": { ... }` 两种条目。 */
+function splitGateEntries(body) {
+	const out = /* @__PURE__ */ new Map();
+	const re = /"([^"]+)"\s*:\s*/g;
+	let m = re.exec(body);
+	while (m !== null) {
+		const api = m[1];
+		const rest = body.slice(m.index + m[0].length);
+		if (rest.startsWith("{")) {
+			const inner = balancedBody(rest, 0);
+			if (inner !== void 0) out.set(api, parseGateFields(inner));
+		} else {
+			const ident = /^[A-Za-z_$][\w$]*/.exec(rest);
+			if (ident !== null) out.set(api, ident[0]);
+		}
+		m = re.exec(body);
+	}
+	return out;
+}
+/**
+* 从运行期 bundle 推导「协议 → 门控」：解析 COMPAT_GATES 的每条目，
+* 命名常量回查同名 `const` 块，内联对象直接取字段。
+*/
+function deriveGates(bundle) {
+	const gatesBody = namedBlock(bundle, "COMPAT_GATES");
+	if (gatesBody === void 0) return void 0;
+	const out = {};
+	for (const [api, ref] of splitGateEntries(gatesBody)) {
+		if (typeof ref !== "string") {
+			out[api] = ref;
+			continue;
+		}
+		const block = namedBlock(bundle, ref);
+		if (block === void 0) continue;
+		const fields = parseGateFields(block);
+		if (Object.keys(fields).length > 0) out[api] = fields;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+/** 单个 schema 节点 → 取值约束；无法归类的返回 undefined（跳过该字段）。 */
+function specOfNode(node) {
+	if (node === void 0) return void 0;
+	if (node.type === "boolean") return "boolean";
+	if (node.type === "number") return node.meta?.step === 1 ? "integer" : "number";
+	if (node.type === "dict") return "object";
+	if (node.type === "object") return "object";
+	if (node.type === "union" && Array.isArray(node.list) && node.list.length > 0) {
+		const values = [];
+		for (const member of node.list) if (member?.type === "const" && typeof member.value === "string") values.push(member.value);
+		else return void 0;
+		return values;
+	}
+}
+/** 从官方 Config schema 推导字段取值约束（`providers.*.compat` 节点）。 */
+function deriveSpecs(module) {
+	const fields = (module["Config"]?.dict?.["providers"]?.inner?.dict?.["compat"])?.dict;
+	if (fields === void 0) return {};
+	const out = {};
+	for (const [field, node] of Object.entries(fields)) {
+		const spec = specOfNode(node);
+		if (spec !== void 0) out[field] = spec;
+	}
+	return out;
+}
+/** 官方门控表不可解析时的最后已知快照（0.1.5-rc.2 实测值）。 */
+const FALLBACK_TABLE = {
+	source: "fallback",
+	gates: {
+		"openai-completions": {
+			supportsStore: "offer",
+			supportsDeveloperRole: "offer",
+			supportsReasoningEffort: "offer",
+			supportsUsageInStreaming: "offer",
+			supportsFinishReason: "offer",
+			maxTokensField: "offer",
+			requiresToolResultName: "offer",
+			requiresAssistantAfterToolResult: "offer",
+			requiresThinkingAsText: "offer",
+			requiresReasoningContentOnAssistantMessages: "offer",
+			thinkingFormat: "offer",
+			chatTemplateKwargs: "offer",
+			chatTemplateArgs: "offer",
+			supportsThinkingTokenBudget: "offer",
+			thinkingTokenBudgetField: "offer",
+			vllmPriority: "offer",
+			supportsStrictMode: "offer",
+			cacheControlFormat: "offer",
+			supportsLongCacheRetention: "offer",
+			openRouterRouting: "withhold",
+			vercelGatewayRouting: "withhold",
+			zaiToolStream: "withhold",
+			supportsOpenAIGrammarTools: "withhold",
+			sendSessionAffinityHeaders: "withhold",
+			deferredToolsMode: "withhold",
+			sessionAffinityFormat: "withhold"
+		},
+		"openai-responses": {
+			supportsDeveloperRole: "offer",
+			supportsMaxOutputTokens: "offer",
+			supportsStrictMode: "offer",
+			supportsLongCacheRetention: "offer",
+			sessionAffinityFormat: "withhold",
+			supportsOpenAIGrammarTools: "withhold",
+			supportsAdditionalTools: "withhold",
+			supportsToolSearch: "withhold",
+			supportsExplicitPromptCacheMode: "withhold"
+		},
+		"anthropic-messages": {
+			supportsEagerToolInputStreaming: "offer",
+			supportsLongCacheRetention: "offer",
+			supportsCacheControlOnTools: "offer",
+			supportsTemperature: "offer",
+			forceAdaptiveThinking: "offer",
+			allowEmptySignature: "offer",
+			supportsStrictTools: "offer",
+			sendSessionAffinityHeaders: "withhold",
+			supportsToolReferences: "withhold",
+			supportsMidConvoEffort: "withhold",
+			allowedFallbackModels: "withhold"
+		}
+	},
+	specs: {
+		supportsStore: "boolean",
+		supportsDeveloperRole: "boolean",
+		supportsReasoningEffort: "boolean",
+		supportsUsageInStreaming: "boolean",
+		supportsFinishReason: "boolean",
+		maxTokensField: ["max_completion_tokens", "max_tokens"],
+		requiresToolResultName: "boolean",
+		requiresAssistantAfterToolResult: "boolean",
+		requiresThinkingAsText: "boolean",
+		requiresReasoningContentOnAssistantMessages: "boolean",
+		thinkingFormat: [
+			"openai",
+			"deepseek",
+			"openrouter",
+			"together",
+			"baseten",
+			"zai",
+			"qwen",
+			"chat-template",
+			"qwen-chat-template",
+			"string-thinking",
+			"ant-ling"
+		],
+		chatTemplateKwargs: "object",
+		chatTemplateArgs: "object",
+		supportsThinkingTokenBudget: "boolean",
+		thinkingTokenBudgetField: [
+			"thinking_token_budget",
+			"thinking_budget",
+			"thinking_budget_tokens"
+		],
+		vllmPriority: "integer",
+		supportsMaxOutputTokens: "boolean",
+		supportsStrictMode: "boolean",
+		cacheControlFormat: ["anthropic"],
+		supportsLongCacheRetention: "boolean",
+		supportsEagerToolInputStreaming: "boolean",
+		supportsCacheControlOnTools: "boolean",
+		supportsTemperature: "boolean",
+		forceAdaptiveThinking: "boolean",
+		allowEmptySignature: "boolean",
+		supportsStrictTools: "boolean"
+	}
+};
+//#endregion
+//#region src/compat.ts
+/**
+* 生效门控表：由 resolve-dsh 的套件加载流程经 {@link installCompatTable} 注入
+* （与 PiAiAdapter 同源——即 dsh 树或 vendored 副本里**正在运行**的那份官方代码）。
+* 未注入时用 FALLBACK_TABLE（纯函数测试路径/极端启动顺序下的保守兜底）。
+*/
+let active = FALLBACK_TABLE;
+/** 注入推导结果（幂等；resolve-dsh 在套件加载后调用一次）。 */
+function installCompatTable(table) {
+	active = table;
+}
+/** 当前生效表的来源诊断（状态行/日志）。 */
+function compatTableInfo() {
+	return active.problem === void 0 ? { source: active.source } : {
+		source: active.source,
+		problem: active.problem
+	};
+}
+/** 某协议全部可配置（offer）的 compat 键（UI 渲染字段组与校验共用）。 */
+function compatFieldsOf(api) {
+	const gate = active.gates[api];
+	if (gate === void 0) return [];
+	return Object.entries(gate).flatMap(([field, disposition]) => disposition === "offer" ? [field] : []);
+}
+/** 某协议某 offer 字段的取值约束（UI 渲染开关/下拉用）。 */
+function compatFieldSpec(api, field) {
+	return active.gates[api]?.[field] === "offer" ? active.specs[field] : void 0;
+}
+/** 官方声明的全部可配置字段（未知键报错时列出，对齐官方 allOfferedCompatFields）。 */
+function allOfferedFields() {
+	const out = /* @__PURE__ */ new Set();
+	for (const gate of Object.values(active.gates)) for (const [field, disposition] of Object.entries(gate)) if (disposition === "offer") out.add(field);
+	return [...out];
+}
+function checkValue(field, spec, value, where) {
+	if (spec === "boolean") {
+		if (typeof value !== "boolean") throw new Error(`${where}: compat.${field} 必须是布尔值`);
+		return;
+	}
+	if (spec === "integer") {
+		if (typeof value !== "number" || !Number.isInteger(value)) throw new Error(`${where}: compat.${field} 必须是整数`);
+		return;
+	}
+	if (spec === "number") {
+		if (typeof value !== "number" || !Number.isFinite(value)) throw new Error(`${where}: compat.${field} 必须是数字`);
+		return;
+	}
+	if (spec === "object") {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error(`${where}: compat.${field} 必须是对象`);
+		return;
+	}
+	if (typeof value !== "string" || !spec.includes(value)) throw new Error(`${where}: compat.${field} 必须是 ${spec.map((v) => JSON.stringify(v)).join(" | ")} 之一`);
+}
+/**
+* 校验一份 compat 字典对指定协议合法（对齐官方门控语义 + schema 值约束）：
+* - 未知键/withhold 字段拒绝（官方写时拒绝，替代旧版静默丢弃）；
+* - 值类型/枚举按官方 schema 校验；
+* - 无值键（null/undefined）拒绝（官方 assertOfferedCompatFields 同款）。
+*/
+function validateCompat(api, compat, where) {
+	if (compat === void 0) return;
+	const gate = active.gates[api];
+	if (gate === void 0) throw new Error(`${where}: 协议 ${JSON.stringify(api)} 无 compat 字段表（支持：${Object.keys(active.gates).join(", ")}）`);
+	const offered = compatFieldsOf(api);
+	for (const [key, value] of Object.entries(compat)) {
+		const disposition = gate[key];
+		if (disposition !== "offer") {
+			if (disposition === "withhold") throw new Error(`${where}: compat.${key} 官方按协议 withhold（内置目录已为对应厂商设置该开关）；请以目录 provider 名作为 route 名（继承目录值），或移除该字段`);
+			throw new Error(`${where}: compat.${key} 不是 ${api} 协议的合法字段（可配置字段：${offered.join(", ")}；官方全部可配字段：${allOfferedFields().join(", ")}）`);
+		}
+		if (value === void 0 || value === null) throw new Error(`${where}: compat.${key} 未设置值；给出值或移除该键（留空不会生效）`);
+		const spec = active.specs[key];
+		if (spec !== void 0) checkValue(key, spec, value, where);
+	}
+}
+/**
+* 逐字段合并 compat 层（后者覆盖前者），丢弃 undefined/null 值。
+* 层序：继承源（仅同协议）→ route 级 → 模型级。
+*/
+function mergeCompat(...layers) {
+	const merged = {};
+	for (const layer of layers) {
+		if (layer === void 0) continue;
+		for (const [key, value] of Object.entries(layer)) if (value !== void 0 && value !== null) merged[key] = value;
+	}
+	return Object.keys(merged).length > 0 ? merged : void 0;
+}
+//#endregion
 //#region src/config-api.ts
 const ROUTE_CATALOG = "/dsh-plus/llm-pi/catalog";
+/**
+* 服务端推导的 compat 字段表（协议 → 字段 → 取值约束）。浏览器半读不到官方包，
+* 由本端点下发，UI 渲染与服务端校验同源（不再各存一份手抄镜像表）。
+*/
+function compatTablePayload() {
+	const fields = {};
+	for (const api of PROTOCOL_IDS) {
+		const perField = {};
+		for (const field of compatFieldsOf(api)) {
+			const spec = compatFieldSpec(api, field);
+			if (spec !== void 0) perField[field] = spec;
+		}
+		fields[api] = perField;
+	}
+	const info = compatTableInfo();
+	return info.problem === void 0 ? {
+		fields,
+		source: info.source
+	} : {
+		fields,
+		source: info.source,
+		problem: info.problem
+	};
+}
 function sendJson(res, status, body) {
 	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
 	res.end(JSON.stringify(body));
@@ -218,19 +523,23 @@ function handleCatalog(runtime, req, res) {
 	}
 	const url = new URL(req.url ?? "", "http://localhost");
 	const provider = url.searchParams.get("provider") ?? "";
-	if ((url.searchParams.get("source") ?? "builtin") === "models-dev") {
+	const source = url.searchParams.get("source") ?? "builtin";
+	const compat = compatTablePayload();
+	if (source === "models-dev") {
 		sendJson(res, 200, {
 			providers: runtime.modelsDev.providerIds(),
 			models: provider.length > 0 ? runtime.modelsDev.modelIds(provider) : [],
 			status: runtime.modelsDev.status(),
-			kitSource
+			kitSource,
+			compat
 		});
 		return;
 	}
 	sendJson(res, 200, {
 		providers: runtime.kit.getBuiltinProviders(),
 		models: provider.length > 0 ? builtinModelIds(runtime.kit, provider) : [],
-		kitSource
+		kitSource,
+		compat
 	});
 }
 /** 注册目录路由（webServer 缺失时由调用方保证不调用）。 */
@@ -768,148 +1077,6 @@ async function discoverModels(request, deps) {
 	}
 }
 //#endregion
-//#region src/compat.ts
-const GATES_BY_PROTOCOL = {
-	"openai-completions": {
-		supportsStore: "offer",
-		supportsDeveloperRole: "offer",
-		supportsReasoningEffort: "offer",
-		supportsUsageInStreaming: "offer",
-		supportsFinishReason: "offer",
-		maxTokensField: "offer",
-		requiresToolResultName: "offer",
-		requiresAssistantAfterToolResult: "offer",
-		requiresThinkingAsText: "offer",
-		requiresReasoningContentOnAssistantMessages: "offer",
-		thinkingFormat: "offer",
-		chatTemplateKwargs: "offer",
-		chatTemplateArgs: "offer",
-		supportsThinkingTokenBudget: "offer",
-		supportsStrictMode: "offer",
-		cacheControlFormat: "offer",
-		supportsLongCacheRetention: "offer",
-		openRouterRouting: "withhold",
-		vercelGatewayRouting: "withhold",
-		zaiToolStream: "withhold",
-		supportsOpenAIGrammarTools: "withhold",
-		sendSessionAffinityHeaders: "withhold",
-		deferredToolsMode: "withhold",
-		sessionAffinityFormat: "withhold"
-	},
-	"openai-responses": {
-		supportsDeveloperRole: "offer",
-		supportsStrictMode: "offer",
-		supportsLongCacheRetention: "offer",
-		sessionAffinityFormat: "withhold",
-		supportsOpenAIGrammarTools: "withhold",
-		supportsAdditionalTools: "withhold",
-		supportsToolSearch: "withhold",
-		supportsExplicitPromptCacheMode: "withhold"
-	},
-	"anthropic-messages": {
-		supportsEagerToolInputStreaming: "offer",
-		supportsLongCacheRetention: "offer",
-		supportsCacheControlOnTools: "offer",
-		supportsTemperature: "offer",
-		forceAdaptiveThinking: "offer",
-		allowEmptySignature: "offer",
-		supportsStrictTools: "offer",
-		sendSessionAffinityHeaders: "withhold",
-		supportsToolReferences: "withhold"
-	}
-};
-/**
-* 字段取值约束（对齐官方 config.ts compatProfile schema）：
-* boolean 字段 → 'boolean'；maxTokensField/thinkingFormat/cacheControlFormat
-* → 枚举；chatTemplateKwargs/chatTemplateArgs → 对象。
-*/
-const VALUE_SPECS = {
-	supportsStore: "boolean",
-	supportsDeveloperRole: "boolean",
-	supportsReasoningEffort: "boolean",
-	supportsUsageInStreaming: "boolean",
-	supportsFinishReason: "boolean",
-	maxTokensField: ["max_completion_tokens", "max_tokens"],
-	requiresToolResultName: "boolean",
-	requiresAssistantAfterToolResult: "boolean",
-	requiresThinkingAsText: "boolean",
-	requiresReasoningContentOnAssistantMessages: "boolean",
-	thinkingFormat: [
-		"openai",
-		"deepseek",
-		"openrouter",
-		"together",
-		"baseten",
-		"zai",
-		"qwen",
-		"chat-template",
-		"qwen-chat-template",
-		"string-thinking",
-		"ant-ling"
-	],
-	chatTemplateKwargs: "object",
-	chatTemplateArgs: "object",
-	supportsThinkingTokenBudget: "boolean",
-	supportsStrictMode: "boolean",
-	cacheControlFormat: ["anthropic"],
-	supportsLongCacheRetention: "boolean",
-	supportsEagerToolInputStreaming: "boolean",
-	supportsCacheControlOnTools: "boolean",
-	supportsTemperature: "boolean",
-	forceAdaptiveThinking: "boolean",
-	allowEmptySignature: "boolean",
-	supportsStrictTools: "boolean"
-};
-/** 某协议全部可配置（offer）的 compat 键（UI 渲染字段组与校验共用）。 */
-function compatFieldsOf(api) {
-	return Object.entries(GATES_BY_PROTOCOL[api]).flatMap(([field, disposition]) => disposition === "offer" ? [field] : []);
-}
-function checkValue(field, spec, value, where) {
-	if (spec === "boolean") {
-		if (typeof value !== "boolean") throw new Error(`${where}: compat.${field} 必须是布尔值`);
-		return;
-	}
-	if (spec === "object") {
-		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error(`${where}: compat.${field} 必须是对象`);
-		return;
-	}
-	if (typeof value !== "string" || !spec.includes(value)) throw new Error(`${where}: compat.${field} 必须是 ${spec.map((v) => JSON.stringify(v)).join(" | ")} 之一`);
-}
-/**
-* 校验一份 compat 字典对指定协议合法（对齐官方门控语义 + schema 值约束）：
-* - 未知键/withhold 字段拒绝（官方 0.1.2-alpha.1 写时拒绝，替代旧版静默丢弃）；
-* - 值类型/枚举按官方 schema 校验；
-* - 无值键（null/undefined）拒绝（官方 assertOfferedCompatFields 同款：
-*   "写了但没生效" 的表面状态不允许）。
-*/
-function validateCompat(api, compat, where) {
-	if (compat === void 0) return;
-	const gate = GATES_BY_PROTOCOL[api];
-	if (gate === void 0) throw new Error(`${where}: 协议 ${JSON.stringify(api)} 无 compat 字段表（支持：${Object.keys(GATES_BY_PROTOCOL).join(", ")}）`);
-	const offered = compatFieldsOf(api);
-	for (const [key, value] of Object.entries(compat)) {
-		const disposition = gate[key];
-		if (disposition !== "offer") {
-			if (disposition === "withhold") throw new Error(`${where}: compat.${key} 官方按协议 withhold（内置目录已为对应厂商设置该开关）；请以目录 provider 名作为 route 名（继承目录值），或移除该字段`);
-			throw new Error(`${where}: compat.${key} 不是 ${api} 协议的合法字段（可配置字段：${offered.join(", ")}）`);
-		}
-		if (value === void 0 || value === null) throw new Error(`${where}: compat.${key} 未设置值；给出值或移除该键（留空不会生效）`);
-		checkValue(key, VALUE_SPECS[key], value, where);
-	}
-}
-/**
-* 逐字段合并 compat 层（后者覆盖前者），丢弃 undefined/null 值。
-* 层序：继承源（仅同协议）→ route 级 → 模型级。
-*/
-function mergeCompat(...layers) {
-	const merged = {};
-	for (const layer of layers) {
-		if (layer === void 0) continue;
-		for (const [key, value] of Object.entries(layer)) if (value !== void 0 && value !== null) merged[key] = value;
-	}
-	return Object.keys(merged).length > 0 ? merged : void 0;
-}
-//#endregion
 //#region src/inherit.ts
 var ExtendsError = class extends Error {};
 /** 解析 "provider/model" 或裸 "model" 引用。 */
@@ -1772,6 +1939,34 @@ function treeResolverDeps(mods, protocolFactories) {
 		resolveRetryPolicy: mods.llm["resolveRetryPolicy"]
 	};
 }
+/**
+* 从官方安装副本推导 compat 门控表（bundle 文本给分型、Config schema 给取值约束），
+* 并安装为插件生效表。任一环节失败回退 FALLBACK_TABLE 并给诊断——绝不因推导失败
+* 弄挂插件启动（宁可放宽校验，也不误拒官方可配字段）。
+*/
+function installOfficialCompatTable(bundlePath, module, diagnostics) {
+	const label = "compat 门控表";
+	try {
+		const gates = deriveGates(readFileSync(bundlePath, "utf8"));
+		if (gates === void 0) {
+			diagnostics.push(`${label}未能从官方 bundle 解析 COMPAT_GATES（${bundlePath}）；使用内置快照（官方新增字段可能被误拒，请检查 dsh-llm-pi-ai 打包形态）`);
+			installCompatTable(FALLBACK_TABLE);
+			return;
+		}
+		installCompatTable({
+			gates,
+			specs: {
+				...FALLBACK_TABLE.specs,
+				...deriveSpecs(module)
+			},
+			source: "official"
+		});
+	} catch (error) {
+		const reason = error instanceof Error ? error.message : String(error);
+		diagnostics.push(`${label}推导失败（${reason}）；使用内置快照`);
+		installCompatTable(FALLBACK_TABLE);
+	}
+}
 function kitFromTree(mods, auth, config) {
 	const protocolFactories = protocolFactoriesOf(mods);
 	const resolverDeps = treeResolverDeps(mods, protocolFactories);
@@ -1811,9 +2006,17 @@ function loadVendoredDeepseek() {
 	return checkDeepseekShape(kit).length === 0 ? kit : void 0;
 }
 /**
+* vendored `dsh-llm-pi-ai` 的 bundle 绝对路径（compat 门控推导用）。
+* 经包名解析拿到入口文件——npm/pnpm 各布局都适用，不硬编码 node_modules 结构。
+*/
+function vendoredAdapterBundlePath() {
+	return fileURLToPath(import.meta.resolve("@deepseek-ai/dsh-llm-pi-ai"));
+}
+/**
 * vendored 兜底副本套件（导出供单测直接使用，免走 dsh 树解析）。
 * npm 发布形态不携带 src/、lib 仅 index.js/invariant.js——resolveProfiles 与
-* auth 助手在此无条件走插件等价实现（内联/门控表对齐，见文件头说明）。
+* auth 助手在此无条件走插件等价实现（内联，见文件头说明）；compat 门控表则
+* 仍从 vendored 副本的 bundle + Config schema 现场推导（与 dsh 树同一推导链）。
 */
 function loadVendoredKit() {
 	const deepseek = loadVendoredDeepseek();
@@ -1822,6 +2025,7 @@ function loadVendoredKit() {
 		"openai-responses": openAIResponsesApi,
 		"anthropic-messages": anthropicMessagesApi
 	};
+	installOfficialCompatTable(vendoredAdapterBundlePath(), vendoredPiAiAdapter, []);
 	const kit = {
 		source: "vendored",
 		PiAiAdapter: vendoredPiAiAdapter.PiAiAdapter,
@@ -1876,6 +2080,7 @@ async function resolveDshKit() {
 			const [auth, config] = await Promise.all([probeSubmodule(treePkgDir, "auth"), probeSubmodule(treePkgDir, "config")]);
 			const kit = kitFromTree(mods, auth, config);
 			assertKitShape(kit, "dsh-tree");
+			installOfficialCompatTable(join(treePkgDir, "lib", "index.js"), mods.piAiAdapter, diagnostics);
 			if (auth === void 0) diagnostics.push("dsh 树不含 dsh-llm-pi-ai/src（npm 发布形态）；认证助手使用插件内联等价实现");
 			if (config === void 0) diagnostics.push("dsh 树不含 dsh-llm-pi-ai/src（npm 发布形态）；profile 解析使用插件等价实现（compat 门控对齐官方 catalog.ts）");
 			const tree = await importTreeDeepseek(anchor);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/llm-pi",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "description": "dsh-plus service+ui plugin: 基于 PiAiAdapter 的自定义 LLM 路由（全量 compat、模型继承、models.dev 目录兜底）",
   "type": "module",
   "main": "lib/index.js",
@@ -32,40 +32,40 @@
   },
   "dependencies": {
     "https-proxy-agent": "^9.1.0",
-    "@dsh-plus/shared": "0.1.16"
+    "@dsh-plus/shared": "0.1.17"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-anonymous-user-id": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-credentials": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-launch-environment": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm-deepseek": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm-pi-ai": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-anonymous-user-id": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-launch-environment": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.5-rc.2",
     "@deepseek-ai/schemastery": "^3.18.2",
     "@earendil-works/pi-ai": "^0.85.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-anonymous-user-id": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-atomic-write": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-credentials": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-home-paths": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-launch-environment": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm-deepseek": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm-pi-ai": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-timeout": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-util-crypto": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-util-values": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-anonymous-user-id": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-atomic-write": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-home-paths": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-launch-environment": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm-deepseek": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-timeout": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-util-crypto": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-util-values": "0.1.5-rc.2",
     "@deepseek-ai/schemastery": "3.18.2",
     "@earendil-works/pi-ai": "0.85.1",
     "@types/react": "~18.3.31",

package/src/client/api.ts

@@ -63,12 +63,20 @@ export interface ConfigValue {
 /** 保存提交形状：完整配置对象，providers 全量替换（settings.replace 语义）。 */
 export type ConfigPatch = ConfigValue
 
+/** compat 字段表（服务端从官方包推导后下发；浏览器半不手抄）。 */
+export interface WireCompatTable {
+  fields: Record<string, Record<string, 'boolean' | 'integer' | 'number' | 'object' | string[]>>
+  source: string
+  problem?: string
+}
+
 /** GET /catalog?provider=&source= 返回（kitSource 为运行期套件来源诊断）。 */
 export interface CatalogResult {
   providers: string[]
   models: string[]
   status?: WireModelsDevStatus
   kitSource?: string
+  compat?: WireCompatTable
 }
 
 const ROUTE_CATALOG = '/dsh-plus/llm-pi/catalog'