dsh-model-extension 1.1.0 → 1.2.0

package/lib/client.js

@@ -217,8 +217,10 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 		/** Same-origin routes served by the server half. */
 		const INDEX_URL = "/plugins/dsh-model-extension/models-index";
 		const DOWNLOAD_URL = "/plugins/dsh-model-extension/models-download";
-		/** Module-level cache: one page load fetches the index at most once. */
-		let cached;
+		const PI_AI_URL = "/plugins/dsh-model-extension/pi-ai-catalog";
+		/** Module-level cache: one page load fetches each source at most once. */
+		let cachedIndex;
+		/** Normalize the models.dev route payload. */
 		function normalize(raw) {
 			if (!Array.isArray(raw)) return [];
 			const entries = [];
@@ -237,23 +239,137 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 			}
 			return entries;
 		}
+		/** Narrow a modality list to what this UI offers. */
+		function supportedInput(value) {
+			if (!Array.isArray(value)) return [];
+			return value.filter((m) => typeof m === "string" && (m === "text" || m === "image"));
+		}
+		/** Read one object-valued field off a raw record. */
+		function objectField(source, key) {
+			const value = source[key];
+			return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+		}
+		/**
+		* The provider a models.dev id belongs to.
+		*
+		* models.dev ids are directory paths (`zhipuai/glm-5.3-flash`), so the leading
+		* segment names the provider. Reading it here gives the picker the same
+		* provider-first navigation that pi-ai's per-provider catalog has for free —
+		* and it is what lets a user narrow by vendor instead of guessing between
+		* same-named ids.
+		* @param id - the models.dev directory id.
+		* @returns the provider segment, or undefined when the id carries none.
+		*/
+		function modelsDevProvider(id) {
+			const slash = id.indexOf("/");
+			return slash > 0 ? id.slice(0, slash) : void 0;
+		}
+		/** Turn models.dev rows into prefill candidates. */
+		function toModelsDevEntries(rows) {
+			return rows.map((row) => ({
+				source: "models.dev",
+				key: `models.dev\u0000${row.id}`,
+				id: row.id,
+				provider: modelsDevProvider(row.id),
+				context: row.context,
+				output: row.output,
+				input: row.input,
+				reasoning: row.reasoning
+			}));
+		}
+		/** Read the diagnostics warnings the server attaches to a catalog payload. */
+		function diagnosticsWarnings(payload) {
+			if (typeof payload !== "object" || payload === null) return [];
+			const diagnostics = payload["diagnostics"];
+			if (typeof diagnostics !== "object" || diagnostics === null) return [];
+			const warnings = diagnostics["warnings"];
+			if (!Array.isArray(warnings)) return [];
+			return warnings.filter((warning) => typeof warning === "string");
+		}
+		/** Turn a pi-ai route payload into prefill candidates, keeping both ids' provenance. */
+		function toPiAiEntries(payload) {
+			const warnings = diagnosticsWarnings(payload);
+			if (typeof payload !== "object" || payload === null) return {
+				entries: [],
+				warnings
+			};
+			const body = payload;
+			if (!Array.isArray(body["models"])) return {
+				entries: [],
+				warnings
+			};
+			const entries = [];
+			for (const item of body["models"]) {
+				if (typeof item !== "object" || item === null) continue;
+				const row = item;
+				const id = row["id"];
+				const provider = row["provider"];
+				if (typeof id !== "string" || id.length === 0) continue;
+				if (typeof provider !== "string" || provider.length === 0) continue;
+				entries.push({
+					source: "pi-ai",
+					key: `pi-ai\u0000${provider}\u0000${id}`,
+					id,
+					provider,
+					name: typeof row["name"] === "string" && row["name"].length > 0 ? row["name"] : void 0,
+					context: typeof row["contextWindow"] === "number" ? row["contextWindow"] : void 0,
+					output: typeof row["maxTokens"] === "number" ? row["maxTokens"] : void 0,
+					input: supportedInput(row["input"]),
+					reasoning: row["reasoning"] === true,
+					api: typeof row["api"] === "string" ? row["api"] : void 0,
+					thinkingLevelMap: objectField(row, "thinkingLevelMap"),
+					compat: objectField(row, "compat")
+				});
+			}
+			return {
+				entries,
+				warnings,
+				version: typeof body["piAiVersion"] === "string" ? body["piAiVersion"] : void 0,
+				generatedAt: typeof body["generatedAt"] === "string" ? body["generatedAt"] : void 0
+			};
+		}
 		/**
-		* The metadata index, fetched once per page load; `undefined` while the
-		* server has no metadata file (the caller shows the not-ready hint).
+		* Fetch one JSON route, keeping a refusal distinguishable from an empty source.
+		*
+		* The distinction matters for the pi-ai half: "the host ships no catalog" and
+		* "the host's catalog could not be called" both leave the list empty, but only
+		* the second one has a fix, and the server names it in the refusal body.
+		* @param url - the same-origin route.
+		* @returns the parsed payload, or the reason it is missing.
 		*/
-		async function getMetadataIndex() {
-			if (cached !== void 0) return cached;
+		async function fetchJson(url) {
 			try {
-				const response = await fetch(INDEX_URL);
-				if (!response.ok) return void 0;
-				cached = normalize(await response.json());
-				return cached;
-			} catch {
-				return;
+				const response = await fetch(url);
+				const payload = await response.json().catch(() => void 0);
+				if (response.ok) return { payload };
+				const message = typeof payload === "object" && payload !== null ? payload["message"] : void 0;
+				return { failure: typeof message === "string" ? message : `HTTP ${String(response.status)}` };
+			} catch (error) {
+				return { failure: error instanceof Error ? error.message : String(error) };
 			}
 		}
 		/**
-		* Download/refresh the metadata file through the server half (user-triggered
+		* The prefill index, fetched once per page load. Both sources are requested
+		* together and either may come back empty; an entirely empty index is a
+		* legitimate answer the caller renders as "nothing to load yet".
+		* @returns the merged index.
+		*/
+		async function getPrefillIndex() {
+			if (cachedIndex !== void 0) return cachedIndex;
+			const [piAiResult, modelsDevResult] = await Promise.all([fetchJson(PI_AI_URL), fetchJson(INDEX_URL)]);
+			const piAi = toPiAiEntries(piAiResult.payload);
+			cachedIndex = {
+				piAi: piAi.entries,
+				modelsDev: toModelsDevEntries(normalize(modelsDevResult.payload)),
+				piAiVersion: piAi.version,
+				piAiGeneratedAt: piAi.generatedAt,
+				piAiWarnings: piAi.warnings,
+				...piAiResult.failure !== void 0 ? { piAiFailure: piAiResult.failure } : {}
+			};
+			return cachedIndex;
+		}
+		/**
+		* Download/refresh the models.dev file through the server half (user-triggered
 		* from the title-row button). A success also refreshes the local cache.
 		*/
 		async function downloadMetadata() {
@@ -264,7 +380,7 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 					ok: false,
 					message: body?.message ?? `HTTP ${String(response.status)}`
 				};
-				cached = normalize(body["index"]);
+				cachedIndex = void 0;
 				return { ok: true };
 			} catch (error) {
 				return {
@@ -274,24 +390,61 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 			}
 		}
 		/**
-		* Case-insensitive substring match over model ids, at most {@link limit}
-		* candidates (plan: show ids only, never the whole list).
-		* @param index - the metadata index, or undefined while unavailable.
-		* @param query - the user's typed text.
-		* @param limit - maximum candidates to return.
-		* @returns the matching ids; empty when the index is unavailable.
+		* How many candidates the picker renders before it stops and reports the rest.
+		*
+		* Ten was too few once one id could arrive from a dozen providers; fifty shows
+		* a vendor's catalog without pouring a 1354-row index into the DOM.
+		*/
+		const DEFAULT_PREFILL_LIMIT = 50;
+		/**
+		* The providers a source offers, alphabetically.
+		*
+		* This is what turns "which `glm-5.3-flash` did you mean?" into a choice the
+		* user can actually make: the same id ships under several providers, and each
+		* provider's copy can carry different capacities and compat switches.
+		* @param index - the fetched index, or undefined while the page still loads.
+		* @param source - the source to enumerate.
+		* @returns the provider names; empty when the source has none.
 		*/
-		function searchModelIds(index, query, limit = 10) {
+		function providersOf(index, source) {
 			if (index === void 0) return [];
-			const needle = query.trim().toLowerCase();
-			if (needle.length === 0) return [];
+			const entries = source === "pi-ai" ? index.piAi : index.modelsDev;
+			const providers = /* @__PURE__ */ new Set();
+			for (const entry of entries) if (entry.provider !== void 0 && entry.provider.length > 0) providers.add(entry.provider);
+			return [...providers].sort((a, b) => a.localeCompare(b));
+		}
+		/**
+		* Candidates matching one source, one provider and one id substring.
+		*
+		* Either filter may be blank, and a blank one *widens* rather than matching
+		* nothing: a provider with no id typed lists that provider's whole catalog,
+		* which is how a user browses a vendor whose model names they have not
+		* memorized. Both blank lists the source's first page.
+		* @param index - the fetched index, or undefined while the page still loads.
+		* @param query - the source, provider, id substring and cap.
+		* @returns the capped candidates and the total match count.
+		*/
+		function searchPrefill(index, query) {
+			if (index === void 0) return {
+				hits: [],
+				total: 0
+			};
+			const entries = query.source === "pi-ai" ? index.piAi : index.modelsDev;
+			const provider = query.provider?.trim() ?? "";
+			const needle = query.text?.trim().toLowerCase() ?? "";
+			const limit = query.limit ?? DEFAULT_PREFILL_LIMIT;
 			const hits = [];
-			for (const entry of index) {
-				if (!entry.id.toLowerCase().includes(needle)) continue;
-				hits.push(entry.id);
-				if (hits.length >= limit) break;
+			let total = 0;
+			for (const entry of entries) {
+				if (provider.length > 0 && entry.provider !== provider) continue;
+				if (needle.length > 0 && !entry.id.toLowerCase().includes(needle)) continue;
+				total += 1;
+				if (hits.length < limit) hits.push(entry);
 			}
-			return hits;
+			return {
+				hits,
+				total
+			};
 		}
 		//#endregion
 		//#region src/client/models-plus/compat.ts
@@ -494,6 +647,85 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 			"string-thinking",
 			"ant-ling"
 		];
+		/**
+		* The compatibility switches llm-pi-ai *offers*, by wire protocol (the `offer`
+		* set of its COMPAT_GATES @ 0.1.5-rc.2). Only these may reach a model row: the
+		* adapter refuses a switch no protocol offers rather than ignoring it, so
+		* copying pi-ai's catalog `compat` across verbatim would fail resolution on
+		* the withheld fields it also records (routing preferences, session affinity,
+		* deferred tools, grammar tools). Re-check against the host's COMPAT_GATES on
+		* every adapter-anchor bump — the same drift gate the host keeps for itself.
+		*/
+		const COMPAT_FIELDS = {
+			"openai-completions": [
+				"supportsStore",
+				"supportsDeveloperRole",
+				"supportsReasoningEffort",
+				"supportsUsageInStreaming",
+				"supportsFinishReason",
+				"maxTokensField",
+				"requiresToolResultName",
+				"requiresAssistantAfterToolResult",
+				"requiresThinkingAsText",
+				"requiresReasoningContentOnAssistantMessages",
+				"thinkingFormat",
+				"chatTemplateKwargs",
+				"chatTemplateArgs",
+				"supportsThinkingTokenBudget",
+				"thinkingTokenBudgetField",
+				"vllmPriority",
+				"supportsStrictMode",
+				"cacheControlFormat",
+				"supportsLongCacheRetention"
+			],
+			"openai-responses": [
+				"supportsDeveloperRole",
+				"supportsMaxOutputTokens",
+				"supportsStrictMode",
+				"supportsLongCacheRetention"
+			],
+			"azure-openai-responses": [
+				"supportsDeveloperRole",
+				"supportsMaxOutputTokens",
+				"supportsStrictMode",
+				"supportsLongCacheRetention"
+			],
+			"openai-codex-responses": [
+				"supportsDeveloperRole",
+				"supportsMaxOutputTokens",
+				"supportsStrictMode",
+				"supportsLongCacheRetention"
+			],
+			"anthropic-messages": [
+				"supportsEagerToolInputStreaming",
+				"supportsLongCacheRetention",
+				"supportsCacheControlOnTools",
+				"supportsTemperature",
+				"forceAdaptiveThinking",
+				"allowEmptySignature",
+				"supportsStrictTools"
+			],
+			"bedrock-converse-stream": ["supportsStrictMode"]
+		};
+		/**
+		* Switches the base panel already renders a dedicated control for; the
+		* "other compatibility switches" block lists everything else.
+		*/
+		const COMPAT_BASE_FIELDS = [
+			"supportsDeveloperRole",
+			"supportsReasoningEffort",
+			"thinkingFormat"
+		];
+		/**
+		* The offered compat field names for one wire protocol.
+		* @param api - the model's protocol, when known.
+		* @returns the field names; empty for an unknown or absent protocol.
+		*/
+		function offeredCompatFields(api) {
+			if (api === void 0) return [];
+			const fields = COMPAT_FIELDS[api];
+			return fields === void 0 ? [] : fields;
+		}
 		/** Extra copy for the extension, keyed like the official dictionaries (en is authoritative). */
 		const en = {
 			nav: "Models+",
@@ -719,6 +951,104 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 			thinkingFormat: "思考格式"
 		};
 		//#endregion
+		//#region src/client/models-plus/prefill.ts
+		/**
+		* Mapping pi-ai catalog values onto a Models+ row.
+		*
+		* The two sides describe the same thing, but two conventions differ in a way
+		* that makes a straight copy wrong:
+		*
+		* 1. **`null` means the opposite in each.** pi-ai's `thinkingLevelMap[level]`
+		*    is *unsupported* when null; our `reasoningEfforts[level]` is *supported,
+		*    send nothing* when null (the adapter then drops the key entirely, and
+		*    pi-ai reads an absent `off` key as "supported but send no parameter").
+		*    Copying one across would invert the meaning for 338 of the catalog's
+		*    models, so values are mapped rather than copied: a pi-ai `null` becomes
+		*    "omit our key", and an absent pi-ai key becomes an explicit entry.
+		* 2. **An absent base level has a protocol-specific default.** pi-ai resolves
+		*    an absent `off`/`minimal`/`low`/`medium`/`high` by falling back to the
+		*    level name — except on the Anthropic protocols, where `minimal` collapses
+		*    onto `low`, and on Mistral, where every level resolves to `high`. Writing
+		*    the level name there would send a spelling those providers never see.
+		*
+		* `xhigh` and `max` are the one pair pi-ai treats as unsupported when absent,
+		* so they are only written when the catalog declares them.
+		*
+		* @module dsh-model-extension/prefill
+		*/
+		/** The seven levels, in pi-ai's escalation order. */
+		const LEVELS = [
+			"off",
+			"minimal",
+			"low",
+			"medium",
+			"high",
+			"xhigh",
+			"max"
+		];
+		/**
+		* The wire spelling pi-ai falls back to for one absent base level, per
+		* protocol. This mirrors the fallbacks inside pi-ai's own dispatch branches.
+		* @param api - the model's wire protocol.
+		* @param level - the level whose key was absent.
+		* @returns the spelling pi-ai would send for that level.
+		*/
+		function defaultWireSpelling(api, level) {
+			if (api === "anthropic-messages" || api === "bedrock-converse-stream") return level === "minimal" ? "low" : level;
+			if (api === "mistral-conversations") return "high";
+			return level;
+		}
+		/**
+		* Convert a catalog `thinkingLevelMap` into our `reasoningEfforts` dict.
+		*
+		* A model that does not reason gets `false`. An outcome that offers nothing
+		* beyond `off` also becomes `false`, because the adapter rejects a dict whose
+		* only level is `off` — and the two describe the same request anyway.
+		* @param levelMap - the catalog's map, when it carries one.
+		* @param api - the model's wire protocol, which picks the fallback spellings.
+		* @param reasoning - whether the model reasons at all.
+		* @returns the dict to write into the row, or `false` for a non-reasoning model.
+		*/
+		function reasoningEffortsFrom(levelMap, api, reasoning) {
+			if (!reasoning) return false;
+			const map = levelMap ?? {};
+			const efforts = {};
+			for (const level of LEVELS) {
+				if (!(level in map)) {
+					if (level === "off") {
+						efforts[level] = null;
+						continue;
+					}
+					if (level === "xhigh" || level === "max") continue;
+					efforts[level] = defaultWireSpelling(api, level);
+					continue;
+				}
+				const wire = map[level];
+				if (wire === null) continue;
+				efforts[level] = wire;
+			}
+			return Object.keys(efforts).some((level) => level !== "off") ? efforts : false;
+		}
+		/**
+		* Project a catalog `compat` block onto the switches the host offers for one
+		* protocol.
+		*
+		* The filter is load-bearing: pi-ai's catalog also records withheld switches
+		* (routing preferences, session affinity, deferred tools, grammar tools), and
+		* the adapter *refuses* a switch no protocol offers instead of ignoring it — a
+		* verbatim copy would make the route fail to resolve.
+		* @param compat - the catalog's compat record, when it carries one.
+		* @param api - the model's wire protocol.
+		* @returns the writable subset; empty when nothing survives.
+		*/
+		function compatFrom(compat, api) {
+			const offered = offeredCompatFields(api);
+			if (offered.length === 0 || compat === void 0) return {};
+			const next = {};
+			for (const field of offered) if (field in compat) next[field] = compat[field];
+			return next;
+		}
+		//#endregion
 		//#region src/client/models-plus/models-plus.module.css
 		var models_plus_module_default = {
 			"addActions": "J84-9a_addActions",
@@ -812,33 +1142,164 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 		//#endregion
 		//#region src/client/models-plus/QuickLoad.tsx
 		/**
-		* Quick-load: a searchable dropdown over the models.dev metadata index.
-		* Plan constraints: ids only, case-insensitive substring match, at most 10
-		* candidates rendered — the index is filtered on every keystroke and the
-		* candidate list is only mounted while open, so a 370-row index never lands
-		* in the DOM wholesale.
+		* Quick-load: source → provider → model id, three narrowing steps.
+		*
+		* The single search box could not answer the question it raised. One model id
+		* ships under a dozen providers (`glm-5.3-flash` exists in zai, opencode,
+		* opencode-go, baseten, together, huggingface and two gateways), and each
+		* provider's copy can carry different capacities and compat switches — so a
+		* flat list of ten same-looking ids left the user to pick blind, or to decode
+		* a suffix the plugin had appended for want of a better idea.
+		*
+		* Splitting the axis fixes it at the source: the user states *which catalog*
+		* and *whose copy* first, and the id search then runs inside that slice.
+		*
+		* Both drop-downs are plugin-rendered rather than native. A `<datalist>` was
+		* tried for the provider field and abandoned: the browser positions its popup
+		* itself (it opened across unrelated fields) and none of it is themeable, so
+		* it could not look like the list beside it. One `quickList` now serves both,
+		* which also keeps only one popup on screen at a time.
+		*/
+		/** The two sources, in the order the picker offers them; pi-ai leads by default. */
+		const SOURCES = [{
+			id: "pi-ai",
+			label: "llm-pi-ai"
+		}, {
+			id: "models.dev",
+			label: "models.dev"
+		}];
+		/**
+		* One line describing what the selected source currently offers, shown while
+		* nothing is typed. The pi-ai version and snapshot date matter here: a DSH home
+		* can hold more than one pi-ai copy, and knowing which one answered is the
+		* difference between a diagnosis and a mystery.
+		* @param index - the fetched index.
+		* @param source - the selected source.
+		* @returns the summary line.
 		*/
+		function sourceSummary(index, source) {
+			if (source === "pi-ai") {
+				if (index.piAi.length === 0) return index.piAiFailure === void 0 ? "pi-ai 目录不可用" : `pi-ai 目录不可用：${index.piAiFailure}`;
+				const version = index.piAiVersion === void 0 ? "" : ` v${index.piAiVersion}`;
+				const when = index.piAiGeneratedAt === void 0 ? "" : ` · ${index.piAiGeneratedAt.slice(0, 10)}`;
+				return `pi-ai 目录${version}，${String(index.piAi.length)} 个模型${when}；选择提供方或输入 model id`;
+			}
+			if (index.modelsDev.length === 0) return "models.dev 元数据未下载——点击页首「下载/更新元数据」";
+			return `models.dev，${String(index.modelsDev.length)} 条；选择提供方或输入 model id`;
+		}
 		/**
-		* Render the quick-load input with its filtered candidate dropdown.
+		* Render the three-step quick-load picker and its candidate list.
 		* @param props - the pick handler and disabled flag.
-		* @returns the quick-load field.
+		* @returns the quick-load block.
 		*/
 		function QuickLoad(props) {
-			const [query, setQuery] = (0, react.useState)("");
-			const [open, setOpen] = (0, react.useState)(false);
+			const [source, setSource] = (0, react.useState)("pi-ai");
+			const [provider, setProvider] = (0, react.useState)("");
+			const [text, setText] = (0, react.useState)("");
+			const [panel, setPanel] = (0, react.useState)(null);
 			const [index, setIndex] = (0, react.useState)(void 0);
+			const textField = (0, react.useRef)(null);
 			const ensureIndex = () => {
-				if (index !== void 0) return;
-				getMetadataIndex().then((loaded) => {
+				getPrefillIndex().then((loaded) => {
 					setIndex(loaded);
 				});
 			};
-			const hits = searchModelIds(index, query, 10);
-			const pick = (id) => {
-				const entry = index?.find((candidate) => candidate.id === id);
-				setOpen(false);
-				setQuery("");
-				if (entry !== void 0) props.onPick(entry);
+			const providers = providersOf(index, source);
+			const chosenProvider = providers.includes(provider) ? provider : "";
+			const { hits, total } = searchPrefill(index, {
+				source,
+				provider: chosenProvider,
+				text
+			});
+			const pick = (entry) => {
+				setPanel(null);
+				setText(entry.id);
+				props.onPick(entry);
+			};
+			const switchSource = (next) => {
+				setSource(next);
+				setProvider("");
+				setText("");
+				setPanel(null);
+			};
+			/**
+			* Commit one provider choice and move straight on to the id field, so the
+			* flow is pick → type rather than pick → click → type.
+			* @param name - the provider to select; blank means "every provider".
+			*/
+			const chooseProvider = (name) => {
+				setProvider(name);
+				setText("");
+				textField.current?.focus();
+			};
+			const providerBody = () => {
+				if (index === void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: models_plus_module_default["quickEmpty"],
+					children: "正在载入预填数据…"
+				});
+				const needle = provider.trim().toLowerCase();
+				const matches = needle.length === 0 ? providers : providers.filter((name) => name.toLowerCase().includes(needle));
+				if (providers.length === 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: models_plus_module_default["quickEmpty"],
+					children: "该数据源没有提供方信息"
+				});
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: models_plus_module_default["quickItem"],
+						onMouseDown: (event) => {
+							event.preventDefault();
+							chooseProvider("");
+						},
+						children: "全部（不限提供方）"
+					}),
+					matches.map((name) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+						type: "button",
+						className: models_plus_module_default["quickItem"],
+						onMouseDown: (event) => {
+							event.preventDefault();
+							chooseProvider(name);
+						},
+						children: name
+					}, name)),
+					matches.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: models_plus_module_default["quickEmpty"],
+						children: "没有匹配的提供方"
+					}) : null
+				] });
+			};
+			const modelBody = () => {
+				if (index === void 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: models_plus_module_default["quickEmpty"],
+					children: "正在载入预填数据…"
+				});
+				if (chosenProvider.length === 0 && text.trim().length === 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: models_plus_module_default["quickEmpty"],
+					children: sourceSummary(index, source)
+				}), source === "pi-ai" && index.piAiWarnings.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: models_plus_module_default["error"],
+					children: index.piAiWarnings.join("；")
+				}) : null] });
+				if (hits.length === 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: models_plus_module_default["quickEmpty"],
+					children: "没有匹配的模型"
+				});
+				return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [hits.map((entry) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					type: "button",
+					className: models_plus_module_default["quickItem"],
+					onMouseDown: (event) => {
+						event.preventDefault();
+						pick(entry);
+					},
+					children: entry.id
+				}, entry.key)), total > hits.length ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					className: models_plus_module_default["quickEmpty"],
+					children: [
+						"另有 ",
+						total - hits.length,
+						" 项匹配——继续输入或选定提供方以缩小范围"
+					]
+				}) : null] });
 			};
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: models_plus_module_default["quickWrap"],
@@ -847,42 +1308,88 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 						className: models_plus_module_default["extLabel"],
 						children: "快速装入"
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
-						className: models_plus_module_default["input"],
-						type: "text",
-						value: query,
-						placeholder: "搜索模型 id（如 aper）…",
-						"aria-label": "快速装入",
-						disabled: props.disabled,
-						onFocus: () => {
-							ensureIndex();
-							setOpen(true);
-						},
-						onBlur: () => {
-							setOpen(false);
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						style: {
+							display: "flex",
+							gap: 6,
+							alignItems: "center"
 						},
-						onChange: (event) => {
-							setQuery(event.target.value);
-							setOpen(true);
-						}
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("select", {
+								className: `${models_plus_module_default["input"]} ${models_plus_module_default["selectInput"]}`,
+								style: {
+									flex: "0 0 108px",
+									minWidth: 0
+								},
+								value: source,
+								disabled: props.disabled,
+								"aria-label": "数据源",
+								onChange: (event) => {
+									switchSource(event.target.value);
+								},
+								children: SOURCES.map((option) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+									value: option.id,
+									children: option.label
+								}, option.id))
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								className: models_plus_module_default["input"],
+								style: {
+									flex: "0 0 132px",
+									minWidth: 0
+								},
+								type: "text",
+								value: provider,
+								placeholder: "提供方：全部",
+								"aria-label": "提供方",
+								autoComplete: "off",
+								disabled: props.disabled,
+								onFocus: () => {
+									ensureIndex();
+									setPanel("provider");
+								},
+								onBlur: () => {
+									setPanel(null);
+								},
+								onChange: (event) => {
+									setProvider(event.target.value);
+									setPanel("provider");
+								}
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+								className: models_plus_module_default["input"],
+								style: {
+									flex: "1 1 auto",
+									minWidth: 0
+								},
+								type: "text",
+								ref: textField,
+								value: text,
+								placeholder: "model id（如 glm）…",
+								"aria-label": "model id",
+								autoComplete: "off",
+								disabled: props.disabled,
+								onFocus: () => {
+									ensureIndex();
+									setPanel("model");
+								},
+								onBlur: () => {
+									setPanel(null);
+								},
+								onChange: (event) => {
+									setText(event.target.value);
+									setPanel("model");
+								}
+							})
+						]
 					}),
-					open ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					panel === "provider" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: models_plus_module_default["quickList"],
-						children: index === void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: models_plus_module_default["quickEmpty"],
-							children: "元数据预填不可用——点击页首「下载/更新元数据」"
-						}) : hits.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-							className: models_plus_module_default["quickEmpty"],
-							children: query.trim().length === 0 ? "输入关键字搜索模型 id" : "没有匹配的模型"
-						}) : hits.map((id) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-							type: "button",
-							className: models_plus_module_default["quickItem"],
-							onMouseDown: (event) => {
-								event.preventDefault();
-								pick(id);
-							},
-							children: id
-						}, id))
+						children: providerBody()
+					}) : null,
+					panel === "model" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: models_plus_module_default["quickList"],
+						children: modelBody()
 					}) : null
 				]
 			});
@@ -900,6 +1407,15 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 		* the effort gate drops `reasoningEfforts` AND `compat.thinkingFormat` in ONE
 		* commit so partial updates never overwrite each other (no orphan settings).
 		*/
+		/**
+		* Whether a draft field is absent or whitespace-only.
+		* @param value - the field's current value.
+		* @returns true when the field carries nothing worth keeping.
+		*/
+		function isBlank(value) {
+			if (value === void 0 || value === null) return true;
+			return typeof value === "string" && value.trim().length === 0;
+		}
 		/** The row's compat sub-object as a plain record (absent → empty). */
 		function compatOf(model) {
 			const value = model["compat"];
@@ -944,21 +1460,44 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 			const setInput = (modalities) => {
 				setKey("input", modalities.length === 0 ? void 0 : [...modalities]);
 			};
+			/**
+			* Apply one prefill candidate.
+			*
+			* Every value is *restated* from the picked source rather than merged into
+			* whatever was already there: capacities, modalities, reasoning levels and
+			* compat are replaced wholesale. A prefill answers "what does this catalog
+			* say about the model", so an absent field clears — leaving another source's
+			* value behind would describe a model neither catalog claims, and switching
+			* sources then re-picking is meant to be a clean rewrite.
+			*
+			* Two things do not follow that rule. `id` and `name` are filled only into a
+			* blank row, because a catalog id is the request id for the vendor's *own*
+			* endpoint while behind a gateway the string on the wire is often different.
+			* And pi-ai's level map is *mapped* rather than copied, because `null` means
+			* the opposite on each side.
+			* @param entry - the picked candidate.
+			*/
 			const applyMetadata = (entry) => {
 				const next = { ...model };
 				if (entry.context === void 0) Reflect.deleteProperty(next, "contextWindow");
 				else next["contextWindow"] = entry.context;
 				if (entry.output === void 0) Reflect.deleteProperty(next, "maxTokens");
 				else next["maxTokens"] = entry.output;
-				const compat = { ...compatOf(model) };
-				compat["supportsReasoningEffort"] = entry.reasoning;
-				if (!entry.reasoning) {
-					Reflect.deleteProperty(compat, "thinkingFormat");
+				const modality = entry.input.filter((m) => m === "text" || m === "image");
+				if (modality.length > 0) next["input"] = modality;
+				else Reflect.deleteProperty(next, "input");
+				if (entry.source === "pi-ai") {
+					if (isBlank(next["id"])) next["id"] = entry.id;
+					if (isBlank(next["name"]) && entry.name !== void 0) next["name"] = entry.name;
+					next["reasoningEfforts"] = reasoningEffortsFrom(entry.thinkingLevelMap, entry.api, entry.reasoning);
+					const compat = compatFrom(entry.compat, entry.api);
+					if (Object.keys(compat).length === 0) Reflect.deleteProperty(next, "compat");
+					else next["compat"] = compat;
+				} else {
 					Reflect.deleteProperty(next, "reasoningEfforts");
+					if (entry.reasoning) next["compat"] = { supportsReasoningEffort: true };
+					else Reflect.deleteProperty(next, "compat");
 				}
-				setKey("compat", Object.keys(compat).length === 0 ? void 0 : compat);
-				const supported = entry.input.filter((m) => m === "text" || m === "image");
-				if (supported.length > 0) next["input"] = supported;
 				onChange(next);
 				setCapacityText(/* @__PURE__ */ new Map());
 			};
@@ -998,8 +1537,48 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 			};
 			const compat = compatOf(model);
 			const developerRole = compat["supportsDeveloperRole"] !== false;
-			const supportsReasoningEffort = compat["supportsReasoningEffort"] === true;
+			/**
+			* Switches a prefill wrote that the block above has no control for. Listing
+			* them keeps a prefilled value from becoming invisible state: the pi-ai
+			* catalog records far more of the compat surface than this panel models
+			* explicitly, and that API refuses an unknown switch rather than ignoring
+			* it — so a value the user cannot see is a value the user cannot fix.
+			*/
+			const extraCompat = Object.entries(compat).filter(([key]) => !COMPAT_BASE_FIELDS.includes(key)).sort(([a], [b]) => a.localeCompare(b));
+			/**
+			* Read an edited switch back as the type it already had.
+			* @param previous - the value the switch carried when rendered.
+			* @param raw - the field text.
+			* @returns the coerced value, or the previous one when the text is unreadable.
+			*/
+			const readCompatValue = (previous, raw) => {
+				if (typeof previous === "boolean") return raw === "true";
+				if (typeof previous === "number") {
+					const parsed = Number(raw);
+					return Number.isNaN(parsed) ? previous : parsed;
+				}
+				if (typeof previous === "string") return raw;
+				try {
+					return JSON.parse(raw);
+				} catch {
+					return previous;
+				}
+			};
+			/** The switch as a wire field: whether the endpoint takes `reasoning_effort`. */
+			const gateOn = compat["supportsReasoningEffort"] === true;
 			const efforts = effortsOf(model);
+			/**
+			* Whether the reasoning area is worth showing.
+			*
+			* The switch and the area answer different questions: the switch tells the
+			* adapter the endpoint accepts `reasoning_effort`, while the area edits what
+			* *this model* offers. A pi-ai prefill can leave the switch unset on purpose
+			* — an absent key lets the adapter auto-detect from the endpoint — while
+			* still carrying levels worth editing, and those levels reach the provider
+			* through the protocol's own thinking parameter either way. So the area keys
+			* off either signal, not the switch alone.
+			*/
+			const reasoningAreaShown = gateOn || efforts !== void 0 || compat["thinkingFormat"] !== void 0;
 			const toggleGate = (checked) => {
 				if (checked) {
 					setCompatKey("supportsReasoningEffort", true);
@@ -1107,24 +1686,28 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 							})]
 						})
 					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: models_plus_module_default["extGroup"],
-						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
 							className: models_plus_module_default["switchRow"],
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 								type: "checkbox",
 								className: models_plus_module_default["extCheckbox"],
-								checked: supportsReasoningEffort,
+								checked: gateOn,
 								disabled,
 								onChange: (event) => {
 									toggleGate(event.target.checked);
 								}
 							}), "端点接受推理挡位参数（reasoning_effort）"]
-						})
+						}), !gateOn && reasoningAreaShown ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							className: models_plus_module_default["extHint"],
+							style: { marginTop: 6 },
+							children: "此项未设置：由 llm-pi-ai 按其 baseURL 检测结果决定是否发送 reasoning_effort； 下面的挡位不受影响，仍通过各协议自己的 thinking 参数生效。"
+						}) : null]
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: models_plus_module_default["extGated"],
-						hidden: !supportsReasoningEffort,
+						hidden: !reasoningAreaShown,
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: models_plus_module_default["extField"],
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
@@ -1218,7 +1801,50 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 								}) : null
 							]
 						})]
-					})
+					}),
+					extraCompat.length > 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: models_plus_module_default["extGroup"],
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: models_plus_module_default["extLabel"],
+								style: { marginBottom: 6 },
+								children: "其他兼容开关"
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								style: {
+									display: "flex",
+									flexDirection: "column",
+									gap: 6
+								},
+								children: extraCompat.map(([key, value]) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+									style: {
+										display: "flex",
+										flexDirection: "column",
+										gap: 2
+									},
+									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+										className: models_plus_module_default["extHint"],
+										children: key
+									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+										className: models_plus_module_default["input"],
+										type: "text",
+										defaultValue: typeof value === "string" ? value : JSON.stringify(value) ?? "",
+										"aria-label": key,
+										disabled,
+										onBlur: (event) => {
+											const raw = event.target.value.trim();
+											setCompatKey(key, raw.length === 0 ? void 0 : readCompatValue(value, raw));
+										}
+									})]
+								}, key))
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: models_plus_module_default["extHint"],
+								style: { marginTop: 6 },
+								children: "这些开关由 pi-ai 目录预填；清空输入框即移除该开关，回到目录默认。"
+							})
+						]
+					}) : null
 				]
 			});
 		}
@@ -1468,7 +2094,7 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 									onChange(models.map((row, at) => at === index ? next : row));
 								}
 							}) : null]
-						}, `${String(index)}:${textOf(model, "id")}`))
+						}, String(index)))
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 						type: "button",
@@ -1778,7 +2404,7 @@ if (typeof document !== 'undefined' && document.querySelector('style[data-plugin
 								role: "tabpanel",
 								hidden: tab !== "provider",
 								children: [
-									layout === "pi-ai" && props.declared === true ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+									layout === "pi-ai" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 										className: models_plus_module_default["field"],
 										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
 											className: models_plus_module_default["fieldLabel"],