@dsh-plus/llm-pi 0.1.26 → 0.1.28

package/lib/client.js

@@ -168,7 +168,10 @@ window.__ModuleLoader__.load({
 			confirm: "Confirm",
 			cancel: "Cancel"
 		};
-		/** own 覆盖同键合并（返回新对象，入参不可变）。 */
+		/**
+		* own 覆盖同键合并（返回新对象，入参不可变）。
+		* 返回类型保留两侧键集合，调用方据此派生 DictKey。
+		*/
 		function mergeDict(base, own) {
 			return {
 				...base,
@@ -396,6 +399,73 @@ ${extra}
 			}));
 		}
 		//#endregion
+		//#region src/client/constants.ts
+		/**
+		* 浏览器半内联常量：与服务端 packages/llm-pi/src/config.ts、compat.ts 逐字对齐。
+		* 浏览器半不能 import 服务端模块（tsdown 只打包 client 侧入口），
+		* 改动服务端这些常量时必须同步本文件。
+		* @module llm-pi/client/constants
+		*/
+		/** 协议枚举（来源：config.ts PROTOCOL_IDS）。 */
+		const PROTOCOL_IDS = [
+			"openai-completions",
+			"openai-responses",
+			"anthropic-messages"
+		];
+		/** thinking 档位（来源：config.ts THINKING_LEVELS）。 */
+		const THINKING_LEVELS = [
+			"off",
+			"minimal",
+			"low",
+			"medium",
+			"high",
+			"xhigh",
+			"max"
+		];
+		/** 请求模态（来源：config.ts MODALITIES）。 */
+		const MODALITIES = ["text", "image"];
+		/** cacheRetention 枚举（来源：config.ts providerProfile.cacheRetention）。 */
+		const CACHE_RETENTION_OPTIONS = [
+			"none",
+			"short",
+			"long"
+		];
+		/** transport 枚举（来源：config.ts providerProfile.transport）。 */
+		const TRANSPORT_OPTIONS = [
+			"sse",
+			"websocket",
+			"websocket-cached",
+			"auto"
+		];
+		/** thinkingBudgets 档位键（来源：config.ts thinkingBudgets）。 */
+		const BUDGET_KEYS = [
+			"minimal",
+			"low",
+			"medium",
+			"high"
+		];
+		/**
+		* 逐协议 compat 字段表：**服务端推导结果经 /catalog 下发**，浏览器半不再手抄
+		* （手抄遗漏官方新增字段 = UI 不渲染 + 保存被后端拒绝；见 compat-gates.ts）。
+		* 未拿到服务端表时用 EMPTY（UI 只渲染提示行），不放内置副本兜底——宁可少画
+		* 控件，也不给出可能与官方不符的字段集。
+		*/
+		let compatTable = {};
+		/** 安装服务端下发的字段表（card 挂载/刷新目录时调用）。 */
+		function installCompatFields(table) {
+			compatTable = table;
+		}
+		/** 某协议的全部合法 compat 键（与服务端 compatFieldsOf 一致）。 */
+		function compatFieldsOf(api) {
+			return Object.keys(compatTable[api] ?? {});
+		}
+		/** 某协议某字段的取值约束（与服务端 compatFieldSpec 一致）。 */
+		function compatFieldSpec(api, field) {
+			return compatTable[api]?.[field];
+		}
+		/** api 未设置时的渲染回退组（最常见的协议；保存仍由后端按实际协议校验）。 */
+		const COMPAT_FALLBACK_API = "openai-completions";
+		//#endregion
 		//#region src/client/draft.ts
 		function numToText(value) {
 			return value === void 0 ? "" : String(value);
@@ -734,6 +804,53 @@ ${extra}
 				]
 			});
 		}
+		/**
+		* 整数字段：compat 的数值型开关（如 vllmPriority，官方 z.number().step(1)）。
+		* 本地保留文本态（与 JsonField 同款 epoch 播种），仅在解析为整数时回写草稿——
+		* 小数/非数字显示错误且不提交，与服务端 checkValue 的整数语义一致
+		* （后端仍做最终校验）。
+		*/
+		function IntegerField(props) {
+			const [text, setText] = (0, react.useState)(() => props.value === void 0 ? "" : String(props.value));
+			(0, react.useEffect)(() => {
+				setText(props.value === void 0 ? "" : String(props.value));
+			}, [props.epoch]);
+			const trimmed = text.trim();
+			const parsed = trimmed === "" ? void 0 : Number(trimmed);
+			const ok = trimmed === "" || parsed !== void 0 && Number.isInteger(parsed);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: `lpc-field${props.wide === true ? " lpc-wide" : ""}`,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "lpc-head",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("label", {
+							className: "lpc-label",
+							htmlFor: props.id,
+							children: props.label
+						})
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+						id: props.id,
+						className: `lpc-input${ok ? "" : " lpc-inputInvalid"}`,
+						type: "text",
+						inputMode: "numeric",
+						"aria-invalid": ok ? void 0 : true,
+						value: text,
+						disabled: props.disabled === true,
+						onChange: (event) => {
+							const next = event.target.value;
+							setText(next);
+							const value = next.trim() === "" ? void 0 : Number(next.trim());
+							props.onEdit(value !== void 0 && Number.isInteger(value) ? value : void 0);
+						}
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: ok ? "lpc-hint" : "lpc-invalid",
+						children: ok ? props.hint ?? "" : props.invalidLabel
+					})
+				]
+			});
+		}
 		function SelectField(props) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: `lpc-field${props.wide === true ? " lpc-wide" : ""}`,
@@ -891,114 +1008,6 @@ ${extra}
 			});
 		}
 		//#endregion
-		//#region src/client/constants.ts
-		/**
-		* 浏览器半内联常量：与服务端 packages/llm-pi/src/config.ts、compat.ts 逐字对齐。
-		* 浏览器半不能 import 服务端模块（tsdown 只打包 client 侧入口），
-		* 改动服务端这些常量时必须同步本文件。
-		* @module llm-pi/client/constants
-		*/
-		/** 协议枚举（来源：config.ts PROTOCOL_IDS）。 */
-		const PROTOCOL_IDS = [
-			"openai-completions",
-			"openai-responses",
-			"anthropic-messages"
-		];
-		/** thinking 档位（来源：config.ts THINKING_LEVELS）。 */
-		const THINKING_LEVELS = [
-			"off",
-			"minimal",
-			"low",
-			"medium",
-			"high",
-			"xhigh",
-			"max"
-		];
-		/** 请求模态（来源：config.ts MODALITIES）。 */
-		const MODALITIES = ["text", "image"];
-		/** cacheRetention 枚举（来源：config.ts providerProfile.cacheRetention）。 */
-		const CACHE_RETENTION_OPTIONS = [
-			"none",
-			"short",
-			"long"
-		];
-		/** transport 枚举（来源：config.ts providerProfile.transport）。 */
-		const TRANSPORT_OPTIONS = [
-			"sse",
-			"websocket",
-			"websocket-cached",
-			"auto"
-		];
-		/** thinkingBudgets 档位键（来源：config.ts thinkingBudgets）。 */
-		const BUDGET_KEYS = [
-			"minimal",
-			"low",
-			"medium",
-			"high"
-		];
-		/**
-		* 逐协议 compat 字段表（来源：compat.ts，逐字段镜像官方 catalog.ts COMPAT_GATES）。
-		* 只列 offer 字段（withhold 字段官方写时拒绝，UI 不提供）；取值约束对齐官方
-		* config.ts compatProfile schema。
-		*/
-		const COMPAT_FIELDS = {
-			"openai-completions": {
-				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"
-			},
-			"openai-responses": {
-				supportsDeveloperRole: "boolean",
-				supportsStrictMode: "boolean",
-				supportsLongCacheRetention: "boolean"
-			},
-			"anthropic-messages": {
-				supportsEagerToolInputStreaming: "boolean",
-				supportsLongCacheRetention: "boolean",
-				supportsCacheControlOnTools: "boolean",
-				supportsTemperature: "boolean",
-				forceAdaptiveThinking: "boolean",
-				allowEmptySignature: "boolean",
-				supportsStrictTools: "boolean"
-			}
-		};
-		/** 某协议的全部合法 compat 键（与服务端 compatFieldsOf 一致）。 */
-		function compatFieldsOf(api) {
-			return Object.keys(COMPAT_FIELDS[api] ?? {});
-		}
-		/** 某协议某字段的取值约束（与服务端 compatFieldSpec 一致）。 */
-		function compatFieldSpec(api, field) {
-			return COMPAT_FIELDS[api]?.[field];
-		}
-		/** api 未设置时的渲染回退组（最常见的协议；保存仍由后端按实际协议校验）。 */
-		const COMPAT_FALLBACK_API = "openai-completions";
-		//#endregion
 		//#region src/client/views/compat.tsx
 		/** api 变更后裁剪 compat：只保留新渲染组的字段，避免保存时被后端拒绝。 */
 		function pruneCompatForApi(compat, api) {
@@ -1052,6 +1061,15 @@ ${extra}
 								invalidText: props.t("invalidJson"),
 								onEdit: (value) => setField(field, value)
 							}, field);
+							if (spec === "integer" || spec === "number") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(IntegerField, {
+								id: `${props.idPrefix}-${field}`,
+								label: field,
+								value: props.compat[field],
+								epoch: props.epoch,
+								invalidLabel: props.t("invalidInteger"),
+								disabled: props.disabled === true,
+								onEdit: (value) => setField(field, value)
+							}, field);
 							return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SelectField, {
 								id: `${props.idPrefix}-${field}`,
 								label: field,
@@ -1742,6 +1760,7 @@ ${extra}
 					if (!alive) return;
 					setKitSource(result.kitSource ?? null);
 					setModelsDevStatus(result.status ?? null);
+					if (result.compat !== void 0) installCompatFields(result.compat.fields);
 				}).catch(() => {});
 				return () => {
 					alive = false;
@@ -2023,6 +2042,7 @@ ${extra}
 			retryPolicy: "重试策略（JSON）",
 			retryPolicyHint: "dsh-llm RetryPolicy 形状；非法 JSON 不会提交。",
 			invalidJson: "JSON 格式错误（该字段不会提交）。",
+			invalidInteger: "必须是整数（该字段不会提交）。",
 			compatGroup: "Compat 覆盖",
 			compatApiHint: "api 未设置时暂按 openai-completions 字段组渲染；保存时后端按实际协议校验。",
 			compatUnset: "未设置",
@@ -2103,6 +2123,7 @@ ${extra}
 			retryPolicy: "Retry policy (JSON)",
 			retryPolicyHint: "dsh-llm RetryPolicy shape; invalid JSON is not submitted.",
 			invalidJson: "Invalid JSON (this field will not be submitted).",
+			invalidInteger: "Must be an integer (this field will not be submitted).",
 			compatGroup: "Compat overrides",
 			compatApiHint: "When api is unset, fields render per openai-completions; the backend validates per the effective protocol.",
 			compatUnset: "Unset",

package/lib/index.d.ts

@@ -4,13 +4,13 @@ import { Context } from "@deepseek-ai/cordis";
 /** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
 declare const SETTINGS_NS = "dsh-plus-llm-pi";
 /** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
-declare const PROTOCOL_IDS: readonly ["openai-completions", "openai-responses", "anthropic-messages"];
+declare const PROTOCOL_IDS: readonly ['openai-completions', 'openai-responses', 'anthropic-messages'];
 type ProtocolId = (typeof PROTOCOL_IDS)[number];
 /** pi-ai 思考档位，升级序。 */
-declare const THINKING_LEVELS: readonly ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
-declare const MODALITIES: readonly ["text", "image"];
+declare const THINKING_LEVELS: readonly ['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max'];
+declare const MODALITIES: readonly ['text', 'image'];
 /** 路由适配器种类：pi = PiAiAdapter（默认）；deepseek = 官方 DeepSeekAdapter（文件通道）。 */
-declare const ADAPTER_KINDS: readonly ["pi", "deepseek"];
+declare const ADAPTER_KINDS: readonly ['pi', 'deepseek'];
 type AdapterKind = (typeof ADAPTER_KINDS)[number];
 type ThinkingLevel = (typeof THINKING_LEVELS)[number];
 type Modality = (typeof MODALITIES)[number];
@@ -35,6 +35,13 @@ interface ProviderProfileConfig {
   extends?: string;
   displayName?: string;
   api?: ProtocolId;
+  /**
+   * 端点；缺省继承 extends 源 provider 的端点。
+   *
+   * 不并 `| undefined`：schemastery 的输入契约用 null 表示「显式置空」，省略即未设置；
+   * 消费方按 `baseURL ?? 默认值` 处理。并上 undefined 会与 ObjectS 的 `string | null`
+   * 冲突（exactOptionalPropertyTypes 下二者不可互赋）。
+   */
   baseURL?: string;
   apiKeyEnv?: string;
   headers?: Record<string, string>;
@@ -89,7 +96,7 @@ declare const Config: z<LlmPiConfigInput, LlmPiConfig>;
 //#endregion
 //#region src/index.d.ts
 declare const name = "dsh-plus-llm-pi";
-declare const inject: readonly ["credentials", "llm"];
+declare const inject: readonly ['credentials', 'llm'];
 declare function apply(ctx: Context, config: LlmPiConfig): Promise<void>;
 //#endregion
 export { Config, type LlmPiConfig, type ModelEntryConfig, type ProviderProfileConfig, SETTINGS_NS, apply, inject, name };