dsh-image-gen 0.8.5 → 0.8.6

package/README.en.md

@@ -401,8 +401,13 @@ pnpm run typecheck
 pnpm test
 pnpm run build
 pnpm run pack:check
+pnpm run test:package
 ```
 
+Saving settings on modern DSH requires the actually loaded `@deepseek-ai/schemastery >=3.18.4 <4`. The card distinguishes loading, missing host forms, remote connections that cannot persist, and incompatible schemas. Legacy DSH settings interfaces are retained. Check the dependencies resolved in the plugin profile when updating, as well as those in the source checkout.
+
+`test:package` requires network access. It installs the current build's tarball and pinned published DSH 0.2 settings services in a temporary directory, then uses real React rendering to verify card state, the bundled save handler, profile file persistence, a fresh form, host restart, and actionable refusal with old schemastery. Image APIs, browser DOM, and RPC transport are outside this test. CI runs it on Windows and Linux.
+
 Feedback is welcome through [Issues](https://github.com/shanliuling/dsh-image-gen/issues). Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a Pull Request.
 
 ## License

package/README.md

@@ -401,8 +401,13 @@ pnpm run typecheck
 pnpm test
 pnpm run build
 pnpm run pack:check
+pnpm run test:package
 ```
 
+新 DSH 的设置保存需要实际加载的 `@deepseek-ai/schemastery >=3.18.4 <4`。设置卡会区分加载中、宿主未提供设置、远程连接不可保存及依赖不兼容；旧 DSH 的设置接口仍保留。更新依赖时应检查插件所在 profile 的实际依赖，而不只检查源码目录。
+
+`test:package` 需要网络，会在临时目录安装当前构建的插件 tarball 和指定版本的 DSH 0.2 设置服务，通过真实 React 渲染验证卡片状态和保存处理、配置文件写入、重新打开表单和宿主重启后的读取，并验证旧 schemastery 的明确拒绝提示。图片 API、浏览器 DOM 和 RPC 传输不属于此测试；CI 同时在 Windows 和 Linux 执行。
+
 欢迎通过 [Issues](https://github.com/shanliuling/dsh-image-gen/issues) 反馈问题，或阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 后提交 Pull Request。
 
 ## License

package/lib/client.js

@@ -87,6 +87,8 @@ window.__ModuleLoader__.load({
 		const SAVE_WORKSPACE_ROUTE = "/plugins/dsh-image-gen/save-workspace";
 		/** Browser route the settings card probes provider connectivity through. */
 		const TEST_CONNECTION_ROUTE = "/plugins/dsh-image-gen/test";
+		/** Non-secret settings capability probe, available even when the host cannot serve a form. */
+		const SETTINGS_HEALTH_ROUTE = "/plugins/dsh-image-gen/settings-health";
 		/** Browser route the workbench infinite canvas pushes live state through. */
 		const CANVAS_STATE_ROUTE = "/plugins/dsh-image-gen/canvas-state";
 		/** Upload a selected canvas original to the host attachment store. */
@@ -246,6 +248,38 @@ window.__ModuleLoader__.load({
 			"google-sub": ""
 		};
 		//#endregion
+		//#region lib/types/client/settings-state.js
+		/** Preserve modern form states while accepting legacy scopes without status/mode. */
+		function settingsState(snapshot, health) {
+			if (snapshot.mode === "memory") return "remote";
+			if (health?.settings === "live" && !health.liveSchema) return "incompatible";
+			if (snapshot.status === "loading") return "loading";
+			if (snapshot.status === "unavailable") return "unavailable";
+			return snapshot.writable ? "ready" : "readOnly";
+		}
+		/** A failed probe cannot identify the cause; keep the host's own form state. */
+		async function fetchSettingsHealth(signal) {
+			try {
+				const response = await fetch(SETTINGS_HEALTH_ROUTE, {
+					cache: "no-store",
+					signal
+				});
+				if (!response.ok) return void 0;
+				const health = await response.json();
+				if (health === null || typeof health.liveSchema !== "boolean" || ![
+					"live",
+					"legacy",
+					"unavailable"
+				].includes(health.settings ?? "")) return void 0;
+				return {
+					settings: health.settings,
+					liveSchema: health.liveSchema
+				};
+			} catch {
+				return;
+			}
+		}
+		//#endregion
 		//#region lib/types/comfyui-workflow.js
 		/** Pure ComfyUI API-workflow validation and placeholder injection. */
 		const COMFYUI_PROMPT_PLACEHOLDER = "{{prompt}}";
@@ -124783,7 +124817,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 `;
 		//#endregion
 		//#region lib/types/client/index.js
-		console.info(`[dsh-image-gen] canvas bundle 2026-09-30T06:41:54.565Z`);
+		console.info(`[dsh-image-gen] canvas bundle 2026-10-08T04:58:18.947Z`);
 		/** Right-sidebar tab-type registration id (DSH 0.1.5 `sidebarRightTabs`). */
 		const SIDEBAR_STUDIO_TAB_ID = "dsh-image-gen/studio";
 		/** The tab kind: a page type opened by kind, recognizing no resource address. */
@@ -124795,6 +124829,10 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 				defaultProvider: "默认 Provider",
 				defaultProviderHint: "Agent 生图默认使用；Studio 与工具调用可临时指定其他 Provider。",
 				settingsReadOnly: "设置由配置文件提供，只读；如需修改请编辑对应的配置来源。",
+				settingsLoading: "正在加载图像生成设置，请稍候。",
+				settingsRemote: "当前连接不支持保存到宿主，请在 DSH 本机页面修改设置。",
+				settingsUnavailable: "宿主尚未提供图像生成设置，请检查插件是否已启用及其加载日志。",
+				settingsIncompatible: "当前加载的设置库不支持保存。请将插件所在环境的 @deepseek-ai/schemastery 更新到 3.18.4 或兼容的 3.x 版本，并重启 DSH。",
 				providerGoogle: "Google Gemini",
 				providerOpenAI: "OpenAI",
 				providerOpenAICompat: "OpenAI 兼容（中转站）",
@@ -124944,6 +124982,10 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 				defaultProvider: "Default provider",
 				defaultProviderHint: "Used by the Agent by default; the Studio and tool calls can switch per call.",
 				settingsReadOnly: "Settings come from a profile file and are read-only; edit that source to change them.",
+				settingsLoading: "Settings are loading; please wait.",
+				settingsRemote: "This connection cannot save settings to the host. Edit them from the local DSH page.",
+				settingsUnavailable: "The host has not provided image generation settings. Check that the plugin is enabled and review its load logs.",
+				settingsIncompatible: "The loaded settings library cannot save these settings. Update @deepseek-ai/schemastery in the plugin environment to 3.18.4 or a compatible 3.x version, then restart DSH.",
 				providerGoogle: "Google Gemini",
 				providerOpenAI: "OpenAI",
 				providerOpenAICompat: "OpenAI-compatible (relay)",
@@ -125397,7 +125439,8 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 			return {
 				getSnapshot: () => ({
 					value: void 0,
-					writable: false
+					writable: false,
+					status: "unavailable"
 				}),
 				subscribe: () => () => {},
 				set: async () => false
@@ -125737,6 +125780,9 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 		function ImageGenerationSettingsCard(props) {
 			const [open, setOpen] = (0, react.useState)(false);
 			const [snapshot, setSnapshot] = (0, react.useState)(() => props.scope.getSnapshot());
+			const [health, setHealth] = (0, react.useState)();
+			const state = settingsState(snapshot, health);
+			const settingsWritable = state === "ready";
 			const [lang, setLang] = (0, react.useState)(() => props.locale?.getSnapshot?.()?.active?.startsWith("en") ? "en" : "zh");
 			const [defaultProvider, setDefaultProvider] = (0, react.useState)(() => props.scope.getSnapshot().value?.provider ?? "google");
 			const [providerMessage, setProviderMessage] = (0, react.useState)("");
@@ -125758,9 +125804,28 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 			const [subTick, setSubTick] = (0, react.useState)(0);
 			const [subBusy, setSubBusy] = (0, react.useState)({});
 			const [subPending, setSubPending] = (0, react.useState)([]);
-			(0, react.useEffect)(() => props.scope.subscribe(() => {
-				setSnapshot(props.scope.getSnapshot());
-			}), [props.scope]);
+			(0, react.useEffect)(() => {
+				const sync = () => {
+					setSnapshot(props.scope.getSnapshot());
+				};
+				const unsubscribe = props.scope.subscribe(sync);
+				sync();
+				return unsubscribe;
+			}, [props.scope]);
+			(0, react.useEffect)(() => {
+				if (!open || snapshot.mode === "memory") return void 0;
+				const controller = new AbortController();
+				fetchSettingsHealth(controller.signal).then((value) => {
+					if (!controller.signal.aborted) setHealth(value);
+				});
+				return () => {
+					controller.abort();
+				};
+			}, [
+				open,
+				snapshot.status,
+				snapshot.mode
+			]);
 			(0, react.useEffect)(() => {
 				return props.locale?.subscribe?.(() => {
 					setLang(props.locale?.getSnapshot?.()?.active?.startsWith("en") ? "en" : "zh");
@@ -125912,7 +125977,17 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 				if (params) for (const [k, v] of Object.entries(params)) text = text.replace(`{${k}}`, v);
 				return text;
 			};
-			const saveSetting = (field, value) => writeSetting(props.scope, field, value, t("settingsWriteRejected"));
+			const settingsMessage = state === "ready" ? void 0 : t({
+				loading: "settingsLoading",
+				remote: "settingsRemote",
+				unavailable: "settingsUnavailable",
+				readOnly: "settingsReadOnly",
+				incompatible: "settingsIncompatible"
+			}[state]);
+			const saveSetting = async (field, value) => {
+				if (settingsMessage !== void 0) throw new Error(settingsMessage);
+				await writeSetting(props.scope, field, value, t("settingsWriteRejected"));
+			};
 			const providerLabels = {
 				google: t("providerGoogle"),
 				openai: t("providerOpenAI"),
@@ -126445,7 +126520,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											updateRow(provider, { keyInput: event.target.value });
 										},
 										placeholder: row.keyStatus === "configured" ? t("apiKeyPlaceholder") : "",
-										disabled: !snapshot.writable || keyReadOnly || keyUnavailable
+										disabled: !settingsWritable || keyReadOnly || keyUnavailable
 									}),
 									(0, react_jsx_runtime.jsx)("span", {
 										className: "dsh-ig-hint",
@@ -126470,7 +126545,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 												updateRow(provider, { baseURL: event.target.value });
 											},
 											required: true,
-											disabled: !snapshot.writable
+											disabled: !settingsWritable
 										}), provider !== "openai-compat" ? (0, react_jsx_runtime.jsx)("button", {
 											type: "button",
 											className: "dsh-ig-btn-reset",
@@ -126478,7 +126553,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onClick: () => {
 												updateRow(provider, { baseURL: DEFAULT_BASE_URLS[provider] });
 											},
-											disabled: !snapshot.writable,
+											disabled: !settingsWritable,
 											children: t("reset")
 										}) : null]
 									}),
@@ -126506,7 +126581,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 												},
 												list: `dsh-ig-${provider}-model-options`,
 												required: provider !== "openai-compat",
-												disabled: !snapshot.writable
+												disabled: !settingsWritable
 											}),
 											(0, react_jsx_runtime.jsx)("datalist", {
 												id: `dsh-ig-${provider}-model-options`,
@@ -126515,7 +126590,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											(0, react_jsx_runtime.jsx)("button", {
 												type: "button",
 												className: "dsh-ig-btn-secondary",
-												disabled: row.fetchingModels || row.saving || !snapshot.writable,
+												disabled: row.fetchingModels || row.saving || !settingsWritable,
 												onClick: () => {
 													fetchProviderModels(provider);
 												},
@@ -126529,7 +126604,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											updateRow(provider, { model: event.target.value });
 										},
 										required: true,
-										disabled: !snapshot.writable
+										disabled: !settingsWritable
 									}),
 									modelPullSupported(provider) ? row.modelFetchMessage.length > 0 ? (0, react_jsx_runtime.jsx)("span", {
 										className: `dsh-ig-hint${row.modelFetchIsError ? " dsh-ig-hint-error" : ""}`,
@@ -126554,7 +126629,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 										onChange: (event) => {
 											updateRow(provider, { editFormat: parseEditFormat(event.target.value) });
 										},
-										disabled: !snapshot.writable,
+										disabled: !settingsWritable,
 										children: [
 											(0, react_jsx_runtime.jsx)("option", {
 												value: "multipart",
@@ -126590,7 +126665,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onChange: (event) => {
 												updateRow(provider, { outputFormat: event.target.value === "png" ? "png" : "jpeg" });
 											},
-											disabled: !snapshot.writable,
+											disabled: !settingsWritable,
 											children: [(0, react_jsx_runtime.jsx)("option", {
 												value: "jpeg",
 												children: t("arkOutputFormatJpeg")
@@ -126618,7 +126693,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onChange: (event) => {
 												updateRow(provider, { watermark: event.target.value === "on" });
 											},
-											disabled: !snapshot.writable,
+											disabled: !settingsWritable,
 											children: [(0, react_jsx_runtime.jsx)("option", {
 												value: "on",
 												children: t("arkWatermarkOn")
@@ -126646,7 +126721,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onChange: (event) => {
 												updateRow(provider, { background: event.target.value === "transparent" ? "transparent" : "opaque" });
 											},
-											disabled: !snapshot.writable,
+											disabled: !settingsWritable,
 											children: [(0, react_jsx_runtime.jsx)("option", {
 												value: "opaque",
 												children: t("arkBackgroundOpaque")
@@ -126677,7 +126752,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 										},
 										placeholder: t("editExtraPlaceholder"),
 										rows: 2,
-										disabled: !snapshot.writable
+										disabled: !settingsWritable
 									}),
 									(0, react_jsx_runtime.jsx)("span", {
 										className: "dsh-ig-hint",
@@ -126715,7 +126790,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 										(0, react_jsx_runtime.jsx)("button", {
 											className: "dsh-ig-save",
 											type: "submit",
-											disabled: row.saving || row.testing || row.fetchingModels || !snapshot.writable,
+											disabled: row.saving || row.testing || row.fetchingModels || !settingsWritable,
 											children: row.saving ? t("saving") : t("save")
 										})
 									]
@@ -126752,7 +126827,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 												updateRow("comfyui", { baseURL: event.target.value });
 											},
 											required: true,
-											disabled: !snapshot.writable
+											disabled: !settingsWritable
 										}), (0, react_jsx_runtime.jsx)("button", {
 											type: "button",
 											className: "dsh-ig-btn-reset",
@@ -126760,7 +126835,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onClick: () => {
 												updateRow("comfyui", { baseURL: DEFAULT_BASE_URLS.comfyui });
 											},
-											disabled: !snapshot.writable,
+											disabled: !settingsWritable,
 											children: t("reset")
 										})]
 									}),
@@ -126866,7 +126941,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											updateRow("comfyui", { timeoutSeconds: Number(event.target.value) });
 										},
 										required: true,
-										disabled: !snapshot.writable
+										disabled: !settingsWritable
 									}),
 									(0, react_jsx_runtime.jsx)("span", {
 										className: "dsh-ig-hint",
@@ -126893,7 +126968,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 									}), (0, react_jsx_runtime.jsx)("button", {
 										className: "dsh-ig-save",
 										type: "submit",
-										disabled: row.saving || !snapshot.writable || row.workflows.length === 0,
+										disabled: row.saving || !settingsWritable || row.workflows.length === 0,
 										children: row.saving ? t("saving") : t("save")
 									})]
 								})]
@@ -127014,7 +127089,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 									}), (0, react_jsx_runtime.jsx)("button", {
 										className: "dsh-ig-save",
 										type: "submit",
-										disabled: row.saving || !snapshot.writable,
+										disabled: row.saving || !settingsWritable,
 										children: row.saving ? t("saving") : t("save")
 									})]
 								})]
@@ -127103,10 +127178,10 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 				}), open ? (0, react_jsx_runtime.jsxs)("div", {
 					className: "dsh-ig-body",
 					children: [
-						!snapshot.writable ? (0, react_jsx_runtime.jsx)("p", {
+						settingsMessage !== void 0 ? (0, react_jsx_runtime.jsx)("p", {
 							className: "dsh-ig-status dsh-ig-status-readonly",
 							role: "note",
-							children: t("settingsReadOnly")
+							children: settingsMessage
 						}) : null,
 						(0, react_jsx_runtime.jsxs)("div", {
 							className: "dsh-ig-field",
@@ -127128,7 +127203,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onChange: () => {
 												selectDefaultProvider(provider);
 											},
-											disabled: !snapshot.writable
+											disabled: !settingsWritable
 										}), providerLabels[provider]]
 									}, provider))
 								}),
@@ -127164,7 +127239,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onChange: (event) => {
 												toggleSaveToWorkspace(event.target.checked);
 											},
-											disabled: !snapshot.writable
+											disabled: !settingsWritable
 										}), (0, react_jsx_runtime.jsx)("span", {
 											className: "dsh-ig-label",
 											children: t("saveToWorkspace")
@@ -127194,7 +127269,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 												if (event.key === "Enter") commitWorkspaceFolder();
 											},
 											placeholder: "dsh-image-gen",
-											disabled: !snapshot.writable
+											disabled: !settingsWritable
 										}),
 										(0, react_jsx_runtime.jsx)("span", {
 											className: "dsh-ig-hint",
@@ -127225,7 +127300,7 @@ body[data-ds-dark-theme] .dsh-ig-workbench{--ig-danger:#f08c8c;--ig-warn:#e5b76a
 											onChange: (event) => {
 												toggleShowPill(event.target.checked);
 											},
-											disabled: !snapshot.writable
+											disabled: !settingsWritable
 										}), (0, react_jsx_runtime.jsx)("span", {
 											className: "dsh-ig-label",
 											children: t("showPill")

package/lib/index.js

@@ -5596,6 +5596,8 @@ const INSPIRATION_ROUTE = "/plugins/dsh-image-gen/inspiration";
 const SAVE_WORKSPACE_ROUTE = "/plugins/dsh-image-gen/save-workspace";
 /** Browser route the settings card probes provider connectivity through. */
 const TEST_CONNECTION_ROUTE = "/plugins/dsh-image-gen/test";
+/** Non-secret settings capability probe, available even when the host cannot serve a form. */
+const SETTINGS_HEALTH_ROUTE = "/plugins/dsh-image-gen/settings-health";
 /** Browser route the workbench infinite canvas pushes live state through. */
 const CANVAS_STATE_ROUTE = "/plugins/dsh-image-gen/canvas-state";
 /** Upload a selected canvas original to the host attachment store. */
@@ -28245,6 +28247,27 @@ function jsonError(res, status, code) {
 	json(res, status, { error: code });
 }
 //#endregion
+//#region lib/types/settings-health.js
+function describeSettingsHealth(settings, schema) {
+	const service = settings;
+	const fields = Object.values(schema.dict ?? {});
+	return {
+		settings: typeof service?.installSection === "function" ? "legacy" : typeof service?.describe === "function" ? "live" : "unavailable",
+		liveSchema: fields.length > 0 && fields.every((field) => field.meta.volatile === true)
+	};
+}
+function serveSettingsHealth(req, res, health) {
+	res.setHeader("cache-control", "no-store");
+	if (req.method !== "GET") {
+		res.statusCode = 405;
+		res.setHeader("allow", "GET");
+		res.end();
+		return;
+	}
+	res.setHeader("content-type", "application/json; charset=utf-8");
+	res.end(JSON.stringify(health));
+}
+//#endregion
 //#region lib/types/index.js
 const name = "dsh-image-gen";
 const inject = [
@@ -28270,12 +28293,17 @@ function apply(ctx, config = {}) {
 	const canvasMirror = new CanvasMirror();
 	const subscriptionManager = new SubscriptionManager(ctx);
 	registerSubscriptionRoutes(ctx, subscriptionManager);
-	installImageSettings(ctx, current(), {
+	const settingsHealth = installImageSettings(ctx, current(), {
 		setSource: (source) => {
 			current = () => migrateOpenAICompatConfig(plainConfig(source()));
 		},
 		onChange: () => {}
 	});
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: SETTINGS_HEALTH_ROUTE,
+		handler: (req, res) => serveSettingsHealth(req, res, settingsHealth())
+	}), "dsh-image-gen: settings health");
 	ctx.effect(() => ctx.webServer.register({
 		kind: "exact",
 		path: IMAGE_ROUTE,
@@ -29240,14 +29268,22 @@ function imagePresentation(result) {
 * on the service, so the namespace registers through it; DSH 0.1.7 replaced it
 * with schema-derived forms served by the loader itself (keyed by entry id),
 * so its service carries no installer and a host without any settings service
-* simply never runs the callback — both stay silent instead of warning.
+* simply never runs the callback. A modern host with an unmarked schema is
+* incompatible and must be diagnosed, while old hosts keep their installer.
 */
 function installImageSettings(ctx, config, hooks) {
+	let service;
 	ctx.inject(["settings"], (settingsCtx) => {
 		const settings = settingsCtx.settings;
-		if (typeof settings.installSection !== "function") return;
-		settings.installSection(ctx, IMAGE_GENERATION_NAMESPACE, Config, config, hooks);
+		service = settings;
+		const health = describeSettingsHealth(settings, Config);
+		if (health.settings === "live" && !health.liveSchema) ctx.logger.warn("dsh-image-gen: the loaded schema lacks volatile fields required by this DSH settings service. Install @deepseek-ai/schemastery >=3.18.4 <4 in the plugin profile and check which copy the plugin resolves; settings cannot be saved with this schema.");
+		if (typeof settings.installSection === "function") settings.installSection(ctx, IMAGE_GENERATION_NAMESPACE, Config, config, hooks);
+		return () => {
+			service = void 0;
+		};
 	});
+	return () => describeSettingsHealth(service, Config);
 }
 //#endregion
 export { CANVAS_STATE_ROUTE, Config, DELETE_ROUTE, IMAGE_ROUTE, IMPORT_ROUTE, INSPIRATION_ROUTE, SAVE_WORKSPACE_ROUTE, STUDIO_ROUTE, TEST_CONNECTION_ROUTE, apply, imageAttachmentFromMeta, inject, name };

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

@@ -1,9 +1,7 @@
 import './tl/css-supports-shim.js';
 import type { Context } from '@deepseek-ai/cordis';
-export interface SettingsScopeSnapshot<T> {
-    value: T | undefined;
-    writable: boolean;
-}
+import { type SettingsScopeSnapshot } from './settings-state.js';
+export type { SettingsScopeSnapshot } from './settings-state.js';
 export interface SettingsScope<T> {
     getSnapshot(): SettingsScopeSnapshot<T>;
     subscribe(listener: () => void): () => void;
@@ -116,4 +114,3 @@ export declare function GeneratedImageCard(props: ImageCardProps): import("react
 export declare function GeneratedImagesCard(props: ImageCardProps): import("react").JSX.Element;
 /** Render modern image artifacts as final conversation output instead of Tool process content. */
 export declare function PromotedImageResultNode(props: ImageResultNodeProps): import("react").JSX.Element;
-export {};

package/lib/types/client/settings-state.d.ts

@@ -0,0 +1,12 @@
+/** Preserve modern form states while accepting legacy scopes without status/mode. */
+import { type SettingsHealth } from '../shared.js';
+export interface SettingsScopeSnapshot<T> {
+    value: T | undefined;
+    writable: boolean;
+    status?: 'loading' | 'ready' | 'unavailable';
+    mode?: 'host' | 'memory';
+}
+export type SettingsState = 'ready' | 'loading' | 'remote' | 'unavailable' | 'readOnly' | 'incompatible';
+export declare function settingsState(snapshot: SettingsScopeSnapshot<unknown>, health?: SettingsHealth): SettingsState;
+/** A failed probe cannot identify the cause; keep the host's own form state. */
+export declare function fetchSettingsHealth(signal: AbortSignal): Promise<SettingsHealth | undefined>;

package/lib/types/settings-health.d.ts

@@ -0,0 +1,6 @@
+/** Diagnose the actual host service and schema without reading any settings values. */
+import type z from '@deepseek-ai/schemastery';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { SettingsHealth } from './shared.js';
+export declare function describeSettingsHealth(settings: unknown, schema: z): SettingsHealth;
+export declare function serveSettingsHealth(req: IncomingMessage, res: ServerResponse, health: SettingsHealth): void;

package/lib/types/shared.d.ts

@@ -14,6 +14,12 @@ export declare const INSPIRATION_ROUTE = "/plugins/dsh-image-gen/inspiration";
 export declare const SAVE_WORKSPACE_ROUTE = "/plugins/dsh-image-gen/save-workspace";
 /** Browser route the settings card probes provider connectivity through. */
 export declare const TEST_CONNECTION_ROUTE = "/plugins/dsh-image-gen/test";
+/** Non-secret settings capability probe, available even when the host cannot serve a form. */
+export declare const SETTINGS_HEALTH_ROUTE = "/plugins/dsh-image-gen/settings-health";
+export interface SettingsHealth {
+    settings: 'unavailable' | 'legacy' | 'live';
+    liveSchema: boolean;
+}
 /** Browser route the workbench infinite canvas pushes live state through. */
 export declare const CANVAS_STATE_ROUTE = "/plugins/dsh-image-gen/canvas-state";
 /** Upload a selected canvas original to the host attachment store. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-image-gen",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",
@@ -60,6 +60,7 @@
     "build": "tsc && tsdown",
     "prepare": "pnpm run build",
     "test": "vitest run",
+    "test:package": "node scripts/check-package.mjs",
     "pack:check": "pnpm pack --dry-run"
   },
   "engines": {
@@ -90,7 +91,7 @@
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0 <5",
-    "@deepseek-ai/schemastery": ">=3.18.0 <4",
+    "@deepseek-ai/schemastery": ">=3.18.4 <4",
     "react": ">=18.2.0 <19"
   },
   "peerDependenciesMeta": {