@dsh-plus/llm-pi 0.1.13 → 0.1.14

package/lib/client.js

@@ -196,14 +196,15 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region ../shared/src/client/scope.ts
 		/**
-		* api 直连实现的命名空间 scope（官方配置页 tab 同款模式）。
+		* remote.settings 直连实现的命名空间 scope（官方配置页 tab 同款模式）。
 		* 读：describe 取命名空间视图（脱敏 value/revision + 顶层 writable）；
 		* 刷新：remote `settings/document-updated`（按命名空间过滤）与
 		* `connection/reset`；generation 防旧读覆盖新发布。任何页面 origin
 		* （loopback 或 tailnet 信任域名）下行为一致。
 		* effect 归属调用方 fiber（label 需含插件名以便诊断）。
 		*/
-		function createApiScope(api, ns, c, label) {
+		function createSettingsScope(c, ns, label) {
+			const remote = c.get("remote");
 			let state = {
 				status: "loading",
 				value: void 0,
@@ -218,36 +219,37 @@ window.__ModuleLoader__.load({
 			};
 			const load = async () => {
 				const gen = ++generation;
-				let response;
+				let view;
 				try {
-					response = await api.describe({});
+					const response = await remote.settings.describe();
+					if (!response.ok) return;
+					view = response.value;
 				} catch {
 					return;
 				}
-				if (gen !== generation || !response.result.ok) return;
-				const writable = response.result.value?.writable ?? false;
-				const view = response.result.value?.namespaces.find((candidate) => candidate.ns === ns);
-				if (view === void 0) {
+				if (gen !== generation) return;
+				const namespace = view.namespaces.find((candidate) => candidate.ns === ns);
+				if (namespace === void 0) {
 					publish({
 						status: "unavailable",
 						value: void 0,
 						revision: void 0,
-						writable
+						writable: view.writable
 					});
 					return;
 				}
 				publish({
 					status: "ready",
-					value: view.value,
-					revision: view.revision,
-					writable
+					value: namespace.value,
+					revision: namespace.revision,
+					writable: view.writable
 				});
 			};
 			const refresh = (namespace) => {
 				if (namespace !== void 0 && namespace !== ns) return;
 				load();
 			};
-			const disposers = [c.get("remote").$on("settings/document-updated", refresh), c.on("connection/reset", () => {
+			const disposers = [remote.$on("settings/document-updated", refresh), c.on("connection/reset", () => {
 				load();
 			})];
 			c.effect(() => () => {
@@ -265,6 +267,20 @@ window.__ModuleLoader__.load({
 				load
 			};
 		}
+		/** 以 remote.settings 构造命名空间绑定的 api 面。 */
+		function createNamespaceApi(remote, ns) {
+			return {
+				update: async (patch, expectedRevision) => {
+					const response = await remote.update(ns, patch, expectedRevision);
+					if (!response.ok) throw new Error(response.error.message ?? "settings update failed");
+				},
+				describe: async () => {
+					const response = await remote.describe();
+					if (!response.ok) throw new Error(response.error.message ?? "settings describe failed");
+					return response.value;
+				}
+			};
+		}
 		//#endregion
 		//#region ../shared/src/client/styles.ts
 		/**
@@ -371,7 +387,7 @@ ${extra}
 		* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
 		* 服务端经 settingsNamespace() 品牌化后使用（config.ts），浏览器半将其作为
 		* settings.plugin.item keyed 槽位的 key —— 同一字面量两处共用，防止漂移。
-		* 契约：dsh rc7 起该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
+		* 契约：0.1.2-alpha.1 起该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
 		* 官方配置页只渲染 key 命中 Host 已注册命名空间的卡片。
 		* @module llm-pi/ns
 		*/
@@ -936,13 +952,18 @@ ${extra}
 			"medium",
 			"high"
 		];
-		/** 逐协议 compat 字段表（来源：compat.ts FIELDS_BY_PROTOCOL）。 */
+		/**
+		* 逐协议 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",
@@ -950,9 +971,10 @@ ${extra}
 				requiresReasoningContentOnAssistantMessages: "boolean",
 				thinkingFormat: [
 					"openai",
-					"openrouter",
 					"deepseek",
+					"openrouter",
 					"together",
+					"baseten",
 					"zai",
 					"qwen",
 					"chat-template",
@@ -961,44 +983,25 @@ ${extra}
 					"ant-ling"
 				],
 				chatTemplateKwargs: "object",
-				openRouterRouting: "object",
-				vercelGatewayRouting: "object",
-				zaiToolStream: "boolean",
-				supportsOpenAIGrammarTools: "boolean",
+				chatTemplateArgs: "object",
+				supportsThinkingTokenBudget: "boolean",
 				supportsStrictMode: "boolean",
 				cacheControlFormat: ["anthropic"],
-				sendSessionAffinityHeaders: "boolean",
-				deferredToolsMode: ["kimi"],
-				sessionAffinityFormat: [
-					"openai",
-					"openai-nosession",
-					"openrouter"
-				],
 				supportsLongCacheRetention: "boolean"
 			},
 			"openai-responses": {
 				supportsDeveloperRole: "boolean",
-				sessionAffinityFormat: [
-					"openai",
-					"openai-nosession",
-					"openrouter"
-				],
-				supportsLongCacheRetention: "boolean",
 				supportsStrictMode: "boolean",
-				supportsOpenAIGrammarTools: "boolean",
-				supportsToolSearch: "boolean",
-				supportsExplicitPromptCacheMode: "boolean"
+				supportsLongCacheRetention: "boolean"
 			},
 			"anthropic-messages": {
 				supportsEagerToolInputStreaming: "boolean",
 				supportsLongCacheRetention: "boolean",
-				sendSessionAffinityHeaders: "boolean",
 				supportsCacheControlOnTools: "boolean",
 				supportsTemperature: "boolean",
 				forceAdaptiveThinking: "boolean",
 				allowEmptySignature: "boolean",
-				supportsStrictTools: "boolean",
-				supportsToolReferences: "boolean"
+				supportsStrictTools: "boolean"
 			}
 		};
 		/** 某协议的全部合法 compat 键（与服务端 compatFieldsOf 一致）。 */
@@ -1721,7 +1724,7 @@ ${extra}
 		/**
 		* 「LLM 路由」配置卡片：注册进 settings.plugin.item 插槽（官方插件配置页）。
 		* 顶部：enabled / catalogUrl / catalogRefreshHours / 只读状态行（kitSource、
-		* modelsDevStatus，来自模型目录端点）+ 保存（settings.replace 全量）与
+		* modelsDevStatus，来自模型目录端点）+ 保存（settings.update 全量深合并）与
 		* 错误/成功提示；下方为 providers 路由列表（新增/删除/字段编辑/compat/模型
 		* 目录，见 views/）。外壳与基础控件走 @dsh-plus/shared/client 套件。
 		* @module llm-pi/client/card
@@ -1807,12 +1810,7 @@ ${extra}
 			const onSave = () => {
 				setSaving(true);
 				const revision = scope.getSnapshot().revision;
-				api.replace({
-					ns: SETTINGS_NS,
-					section: toPatch(draft),
-					...revision !== void 0 ? { expectedRevision: revision } : {}
-				}).then(async (response) => {
-					if (!response.result.ok) throw new Error(response.result.error?.message ?? t("saveFailed"));
+				api.update(toPatch(draft), revision).then(async () => {
 					await scope.load();
 					const next = scope.getSnapshot().value;
 					if (next !== void 0) setDraft(draftFromValue(next));
@@ -2218,8 +2216,8 @@ ${extra}
 		const inject = [
 			"slots",
 			"locale",
-			"connection",
-			"remote"
+			"remote",
+			"remote.settings"
 		];
 		function apply(ctx) {
 			const c = ctx;
@@ -2231,8 +2229,8 @@ ${extra}
 				zh,
 				en
 			}), "llm-pi: locale");
-			const api = c.get("connection").api.settings;
-			const scope = createApiScope(api, SETTINGS_NS, c, "llm-pi: settings scope");
+			const scope = createSettingsScope(c, SETTINGS_NS, "llm-pi: settings scope");
+			const api = createNamespaceApi(c.get("remote").settings, SETTINGS_NS);
 			c.slots.inject("settings.plugin.item", () => c.slots.register({
 				name: "settings.plugin.item",
 				key: SETTINGS_NS,

package/lib/index.d.ts

@@ -2,7 +2,7 @@ import z from "@deepseek-ai/schemastery";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/config.d.ts
 /** settings 命名空间；webui 配置卡片与插件运行期读取同一份（字面量见 ./ns.ts）。 */
-declare const SETTINGS_NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+declare const SETTINGS_NS: Branded<"SettingsNamespace">;
 /** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
 declare const PROTOCOL_IDS: readonly ["openai-completions", "openai-responses", "anthropic-messages"];
 type ProtocolId = (typeof PROTOCOL_IDS)[number];
@@ -28,7 +28,6 @@ interface ModelEntryConfig {
   /** 以下仅 adapter: deepseek 的 route 有效（官方 llm-deepseek 目录字段）。 */
   imagePixelBudget?: number;
   imageMaxBytes?: number;
-  imageDetail?: 'auto' | 'low';
 }
 /** 单个 provider route 配置（providers 字典的值）。 */
 interface ProviderProfileConfig {
@@ -56,6 +55,8 @@ interface ProviderProfileConfig {
   websocketConnectTimeoutMs?: number;
   streamIdleTimeoutMs?: number;
   maxRequestImageBytes?: number;
+  requestImagePixelBudget?: number;
+  requestImageMaxBytes?: number;
   retryPolicy?: unknown;
   models?: ModelEntryConfig[];
   /** 以下仅 adapter: deepseek 的 route 有效（透传官方 llm-deepseek 同名策略）。 */