@dsh-plus/image-studio 0.1.14 → 0.1.15

package/lib/client.js

@@ -307,7 +307,7 @@ window.__ModuleLoader__.load({
 							className: `${p}-pending`,
 							children: props.dirtyLabel
 						}) : null,
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: `${p}-chevron${props.open ? ` ${p}-chevronOpen` : ""}` })
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular, { className: `${p}-chevron${props.open ? ` ${p}-chevronOpen` : ""}` })
 					]
 				}), props.open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: `${p}-body`,
@@ -2036,7 +2036,7 @@ ${extra}
 									className: "ims-btn ims-btnGhost",
 									onClick: () => setConfirming(true),
 									children: [
-										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, { size: 14 }),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutlineRegular, { size: 14 }),
 										" ",
 										t("common.delete")
 									]
@@ -2064,7 +2064,7 @@ ${extra}
 							className: "ims-btn ims-btnGhost ims-btnSmall",
 							onClick: onRefresh,
 							children: [
-								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline16, { size: 14 }),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutlineRegular, { size: 14 }),
 								" ",
 								t("common.refresh")
 							]
@@ -2564,7 +2564,7 @@ ${extra}
 									onUploaded: selectUploaded,
 									className: "ims-btn ims-btnPrimary ims-btnSmall",
 									children: [
-										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, { size: 14 }),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutlineMedium, { size: 14 }),
 										" ",
 										t("upload.pick")
 									]
@@ -3017,7 +3017,7 @@ ${extra}
 													kind: "upload",
 													id: entry.id
 												}))].slice(0, 16)),
-												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, { size: 18 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("upload.pick") })]
+												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutlineMedium, { size: 18 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("upload.pick") })]
 											})
 										]
 									}),
@@ -3058,7 +3058,7 @@ ${extra}
 												accept: "image/png",
 												className: "ims-thumbAdd",
 												onUploaded: (entries) => setMask(uploadRef(entries)),
-												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutline16, { size: 18 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("upload.pick") })]
+												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlusOutlineMedium, { size: 18 }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: t("upload.pick") })]
 											})
 										]
 									}),
@@ -3210,7 +3210,7 @@ ${extra}
 					return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 						className: `ims-task ims-task-${task.state}`,
 						children: [
-							active ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutline16, {
+							active ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconLoadingOutlineRegular, {
 								className: "ims-spin",
 								size: 14
 							}) : null,
@@ -3365,7 +3365,7 @@ ${extra}
 								className: "ims-iconBtn",
 								"aria-label": t("common.close"),
 								onClick: () => studio.setOpen(false),
-								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, { size: 16 })
+								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutlineMedium, { size: 16 })
 							})]
 						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {

package/lib/index.d.ts

@@ -1,6 +1,9 @@
-import z from "@deepseek-ai/schemastery";
 import { Context, Service } from "@deepseek-ai/cordis";
+import { UnwrapVolatile } from "@dsh-plus/shared";
+import z from "@deepseek-ai/schemastery";
 //#region src/config.d.ts
+/** settings 命名空间（字面量即合法命名空间，编译期校验）。 */
+declare const SETTINGS_NS = "dsh-plus-image-studio";
 /** 提示词预设（解析后视图）。 */
 interface PromptPresetEntry {
   id: string;
@@ -24,26 +27,29 @@ interface ProviderPresetEntry {
   credentialRef: string;
   extraHeaders: Record<string, string>;
 }
-declare const Config: z<Schemastery.ObjectS<{
-  promptPresets: z<PromptPresetEntry[], PromptPresetEntry[]>;
-  paramPresets: z<ParamPresetEntry[], ParamPresetEntry[]>;
-  providerPresets: z<ProviderPresetEntry[], ProviderPresetEntry[]>;
-  maxConcurrent: z<number, number>;
-  requestTimeoutMs: z<number, number>;
-  proxy: z<string, string>;
-  galleryMaxItems: z<number, number>;
-  uploadTtlHours: z<number, number>;
-}>, Schemastery.ObjectT<{
-  promptPresets: z<PromptPresetEntry[], PromptPresetEntry[]>;
-  paramPresets: z<ParamPresetEntry[], ParamPresetEntry[]>;
-  providerPresets: z<ProviderPresetEntry[], ProviderPresetEntry[]>;
-  maxConcurrent: z<number, number>;
-  requestTimeoutMs: z<number, number>;
-  proxy: z<string, string>;
-  galleryMaxItems: z<number, number>;
-  uploadTtlHours: z<number, number>;
-}>>;
-type ImageStudioConfig = Schemastery.TypeT<typeof Config>;
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+  promptPresets: z<NoInfer<PromptPresetEntry[]>, NoInfer<PromptPresetEntry[]>, "volatile-defined">;
+  paramPresets: z<NoInfer<ParamPresetEntry[]>, NoInfer<ParamPresetEntry[]>, "volatile-defined">;
+  providerPresets: z<NoInfer<ProviderPresetEntry[]>, NoInfer<ProviderPresetEntry[]>, "volatile-defined">;
+  maxConcurrent: z<number, number, "volatile-defined">;
+  requestTimeoutMs: z<number, number, "volatile-defined">;
+  proxy: z<string, string, "volatile-defined">;
+  galleryMaxItems: z<number, number, "volatile-defined">;
+  uploadTtlHours: z<number, number, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  promptPresets: z<NoInfer<PromptPresetEntry[]>, NoInfer<PromptPresetEntry[]>, "volatile-defined">;
+  paramPresets: z<NoInfer<ParamPresetEntry[]>, NoInfer<ParamPresetEntry[]>, "volatile-defined">;
+  providerPresets: z<NoInfer<ProviderPresetEntry[]>, NoInfer<ProviderPresetEntry[]>, "volatile-defined">;
+  maxConcurrent: z<number, number, "volatile-defined">;
+  requestTimeoutMs: z<number, number, "volatile-defined">;
+  proxy: z<string, string, "volatile-defined">;
+  galleryMaxItems: z<number, number, "volatile-defined">;
+  uploadTtlHours: z<number, number, "volatile-defined">;
+}>>, "plain">;
+/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+type ImageStudioConfigFields = Schemastery.TypeT<typeof Config>;
+/** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
+type ImageStudioConfig = UnwrapVolatile<ImageStudioConfigFields>;
 //#endregion
 //#region src/provider/types.d.ts
 /**
@@ -204,8 +210,7 @@ declare class ImageStudioService extends Service {
   private readonly log;
   /** 进行中的孤儿回收（串行化：索引重写不能并发）。 */
   private pruning;
-  private settingsRef;
-  constructor(ctx: Context, config: ImageStudioConfig);
+  constructor(ctx: Context, config: ImageStudioConfig | ImageStudioConfigFields);
   /** 配置热更：并发上限即时生效（进行中任务不受影响）。 */
   private applyConfig;
   private promptPresets;
@@ -480,6 +485,6 @@ declare module '@deepseek-ai/cordis' {
     imageStudio: ImageStudioService;
   }
 }
-declare function apply(ctx: Context, config: ImageStudioConfig): void;
+declare function apply(ctx: Context, config: ImageStudioConfig | ImageStudioConfigFields): void;
 //#endregion
-export { Config, type CredentialStatusWire, type ErrorCode, type GalleryItem, type GalleryListWire, type GenerateRequest, IMAGE_SIZE_RULE, ImageStudioError, ImageStudioService, MAX_SOURCE_IMAGES, PARAM_CATALOG, type ParamEntry, type ParamSpec, type ParamSpecMap, ParamValidationError, type PresetsWire, type ProvidersWire, SIZE_PRESETS, type SourceRef, type TaskWire, UPLOAD_MAX_BYTES, type UploadEntry, apply, checkImageSize, credentialRefNameOf, detectImageMime, extOfMime, inject, isImageId, isValidPresetId, mimeOfExt, name, normalizeParamSpecs, paramEntryOf, paramKeysFor, statusOfCode, validateParamSpecs };
+export { Config, type CredentialStatusWire, type ErrorCode, type GalleryItem, type GalleryListWire, type GenerateRequest, IMAGE_SIZE_RULE, ImageStudioError, ImageStudioService, MAX_SOURCE_IMAGES, PARAM_CATALOG, type ParamEntry, type ParamSpec, type ParamSpecMap, ParamValidationError, type PresetsWire, type ProvidersWire, SETTINGS_NS, SIZE_PRESETS, type SourceRef, type TaskWire, UPLOAD_MAX_BYTES, type UploadEntry, apply, checkImageSize, credentialRefNameOf, detectImageMime, extOfMime, inject, isImageId, isValidPresetId, mimeOfExt, name, normalizeParamSpecs, paramEntryOf, paramKeysFor, statusOfCode, validateParamSpecs };

package/lib/index.js

@@ -1,56 +1,13 @@
-import z from "@deepseek-ai/schemastery";
 import { Service } from "@deepseek-ai/cordis";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
+import { pluginDataPath, unwrapVolatile } from "@dsh-plus/shared";
 import { request } from "node:http";
 import { request as request$1 } from "node:https";
 import { HttpsProxyAgent } from "https-proxy-agent";
 import { randomUUID } from "node:crypto";
 import { appendFile, mkdir, readFile, readdir, rename, rm, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { pluginDataPath } from "@dsh-plus/shared";
-//#endregion
-//#region src/config.ts
-/**
-* 配置单一事实源：cordis 行级 Config（组合默认）与 settings namespace
-* （用户层，$DSH_HOME/settings.yaml 热生效）共用同一 schemastery schema。
-* 三组纯用户配置：提示词预设 / 参数预设 / 提供商预设（API key 不在此，
-* 走 credentials，引用名由 preset id 派生）。
-* @module image-studio/config
-*/
-/** settings 命名空间（字面量即合法命名空间，编译期校验）。 */
-const SETTINGS_NS = "dsh-plus-image-studio";
-const PromptPreset = z.object({
-	id: z.string().required().description("预设 id（稳定标识，删除级联引用）"),
-	name: z.string().required().description("预设名称"),
-	text: z.string().required().description("提示词模板")
-});
-const ParamPreset = z.object({
-	id: z.string().required().description("预设 id"),
-	name: z.string().required().description("预设名称"),
-	endpoint: z.union([z.const("generation"), z.const("edit")]).required().description("适用端点：generation | edit"),
-	/** 参数表结构由 params/spec 校验，settings 层存原始 JSON。 */
-	paramSpecs: z.any().required().description("参数开关表（ParamSpecMap JSON）")
-});
-const ProviderPreset = z.object({
-	id: z.string().required().description("预设 id"),
-	name: z.string().required().description("预设名称"),
-	protocol: z.string().required().description("协议 id（如 openai-images）"),
-	baseUrl: z.string().required().description("API 基础地址（含 /v1）"),
-	model: z.string().required().description("模型 id"),
-	credentialRef: z.string().required().description("凭据引用名（IMAGE_STUDIO_PRESET_*）"),
-	extraHeaders: z.dict(z.string()).description("附加请求头（部分中转需要）").default({})
-});
-const Config = z.object({
-	promptPresets: z.array(PromptPreset).description("提示词预设").default([]),
-	paramPresets: z.array(ParamPreset).description("参数预设").default([]),
-	providerPresets: z.array(ProviderPreset).description("提供商预设").default([]),
-	maxConcurrent: z.number().min(0).max(16).description("生图任务并发上限（0 = 不限）").default(3),
-	requestTimeoutMs: z.number().min(1e4).max(6e5).description("单请求超时（毫秒；生图长耗时，默认 5 分钟）").default(3e5),
-	proxy: z.string().description("上游请求代理（空 = 直连）").default(""),
-	galleryMaxItems: z.number().min(0).max(1e4).description("画廊保留上限（条，0 = 不清理；超限按最旧删除）").default(500),
-	uploadTtlHours: z.number().min(1).max(720).description("上传原图保留时长（小时；未被画廊条目引用的超期即回收）").default(24)
-});
-//#endregion
+import z from "@deepseek-ai/schemastery";
 //#region src/errors.ts
 var ImageStudioError = class extends Error {
 	code;
@@ -1398,7 +1355,6 @@ async function pruneUploads(options) {
 }
 //#endregion
 //#region src/service.ts
-/** 静态 schema 引用（installSection 用；避免循环 import config → service）。 */
 var ImageStudioService = class extends Service {
 	static inject = ["credentials"];
 	current;
@@ -1408,21 +1364,12 @@ var ImageStudioService = class extends Service {
 	pruning;
 	constructor(ctx, config) {
 		super(ctx, "imageStudio");
-		this.current = () => config;
+		this.current = () => unwrapVolatile(config);
 		this.log = (message) => ctx.logger("image-studio").warn(message);
 		this.pruning = null;
-		this.runner = new TaskRunner({ maxConcurrent: config.maxConcurrent });
+		this.runner = new TaskRunner({ maxConcurrent: this.current().maxConcurrent });
 		this.schedulePrune();
-		ctx.inject(["settings"], (settingsCtx) => {
-			this.settingsRef = settingsCtx.settings;
-			settingsCtx.settings.installSection(ctx, SETTINGS_NS, Config, config, {
-				setSource: (source) => {
-					this.current = source;
-					this.applyConfig();
-				},
-				onChange: () => {}
-			});
-		});
+		ctx.events.on("loader/volatile-update", () => this.applyConfig());
 		ctx.inject(["webServer"], (webCtx) => {
 			registerImageStudioApi(webCtx, this);
 		});
@@ -1788,6 +1735,48 @@ function stripHostParams(params) {
 	return rest;
 }
 //#endregion
+//#region src/config.ts
+/**
+* 配置单一事实源：cordis 行级 Config（组合默认）与 settings namespace
+* （用户层，$DSH_HOME/settings.yaml 热生效）共用同一 schemastery schema。
+* 三组纯用户配置：提示词预设 / 参数预设 / 提供商预设（API key 不在此，
+* 走 credentials，引用名由 preset id 派生）。
+* @module image-studio/config
+*/
+/** settings 命名空间（字面量即合法命名空间，编译期校验）。 */
+const SETTINGS_NS = "dsh-plus-image-studio";
+const PromptPreset = z.object({
+	id: z.string().required().description("预设 id（稳定标识，删除级联引用）"),
+	name: z.string().required().description("预设名称"),
+	text: z.string().required().description("提示词模板")
+});
+const ParamPreset = z.object({
+	id: z.string().required().description("预设 id"),
+	name: z.string().required().description("预设名称"),
+	endpoint: z.union([z.const("generation"), z.const("edit")]).required().description("适用端点：generation | edit"),
+	/** 参数表结构由 params/spec 校验，settings 层存原始 JSON。 */
+	paramSpecs: z.any().required().description("参数开关表（ParamSpecMap JSON）")
+});
+const ProviderPreset = z.object({
+	id: z.string().required().description("预设 id"),
+	name: z.string().required().description("预设名称"),
+	protocol: z.string().required().description("协议 id（如 openai-images）"),
+	baseUrl: z.string().required().description("API 基础地址（含 /v1）"),
+	model: z.string().required().description("模型 id"),
+	credentialRef: z.string().required().description("凭据引用名（IMAGE_STUDIO_PRESET_*）"),
+	extraHeaders: z.dict(z.string()).description("附加请求头（部分中转需要）").default({})
+});
+const Config = z.object({
+	promptPresets: z.array(PromptPreset).description("提示词预设").default([]).volatile(),
+	paramPresets: z.array(ParamPreset).description("参数预设").default([]).volatile(),
+	providerPresets: z.array(ProviderPreset).description("提供商预设").default([]).volatile(),
+	maxConcurrent: z.number().min(0).max(16).description("生图任务并发上限（0 = 不限）").default(3).volatile(),
+	requestTimeoutMs: z.number().min(1e4).max(6e5).description("单请求超时（毫秒；生图长耗时，默认 5 分钟）").default(3e5).volatile(),
+	proxy: z.string().description("上游请求代理（空 = 直连）").default("").volatile(),
+	galleryMaxItems: z.number().min(0).max(1e4).description("画廊保留上限（条，0 = 不清理；超限按最旧删除）").default(500).volatile(),
+	uploadTtlHours: z.number().min(1).max(720).description("上传原图保留时长（小时；未被画廊条目引用的超期即回收）").default(24).volatile()
+});
+//#endregion
 //#region src/index.ts
 const name = "dsh-plus-image-studio";
 const inject = ["credentials"];
@@ -1795,4 +1784,4 @@ function apply(ctx, config) {
 	ctx.plugin(ImageStudioService, config);
 }
 //#endregion
-export { Config, IMAGE_SIZE_RULE, ImageStudioError, ImageStudioService, MAX_SOURCE_IMAGES, PARAM_CATALOG, ParamValidationError, SIZE_PRESETS, UPLOAD_MAX_BYTES, apply, checkImageSize, credentialRefNameOf, detectImageMime, extOfMime, inject, isImageId, isValidPresetId, mimeOfExt, name, normalizeParamSpecs, paramEntryOf, paramKeysFor, statusOfCode, validateParamSpecs };
+export { Config, IMAGE_SIZE_RULE, ImageStudioError, ImageStudioService, MAX_SOURCE_IMAGES, PARAM_CATALOG, ParamValidationError, SETTINGS_NS, SIZE_PRESETS, UPLOAD_MAX_BYTES, apply, checkImageSize, credentialRefNameOf, detectImageMime, extOfMime, inject, isImageId, isValidPresetId, mimeOfExt, name, normalizeParamSpecs, paramEntryOf, paramKeysFor, statusOfCode, validateParamSpecs };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/image-studio",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "dsh-plus service+ui plugin: 图像工作室——OpenAI Images 协议文生图/图生图，全参数开关化，双预设体系，并发生图任务与可二次编辑画廊",
   "type": "module",
   "main": "lib/index.js",
@@ -20,24 +20,24 @@
   ],
   "dependencies": {
     "https-proxy-agent": "^9.1.0",
-    "@dsh-plus/shared": "0.1.21"
+    "@dsh-plus/shared": "0.1.22"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-credentials": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-alpha.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.7-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.7-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.7-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-credentials": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-credentials": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-alpha.2",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "26.4.0",
     "@types/react": "~18.3.31",
     "react": "^18.2.0"

package/src/client/panel/gallery.tsx

@@ -4,7 +4,11 @@
  * @module image-studio/client/panel/gallery
  */
 import { Modal } from '@deepseek-ai/dsh-client-ui-primitives'
-import { IconDownload, IconRefreshOutline16, IconTrashOutline16 } from '@dsh-plus/shared/client'
+import {
+  IconDownload,
+  IconRefreshOutlineRegular,
+  IconTrashOutlineRegular,
+} from '@dsh-plus/shared/client'
 import { type ReactElement, useState } from 'react'
 import type { GalleryItem } from '../../gallery/store.ts'
 import { deleteGalleryItem, imageUrl, uploadImageUrl } from '../api.ts'
@@ -156,7 +160,7 @@ function GalleryDetail(props: {
               className="ims-btn ims-btnGhost"
               onClick={() => setConfirming(true)}
             >
-              <IconTrashOutline16 size={14} /> {t('common.delete')}
+              <IconTrashOutlineRegular size={14} /> {t('common.delete')}
             </button>
           )}
         </div>
@@ -173,7 +177,7 @@ export function GalleryView(props: GalleryViewProps): ReactElement {
       <div className="ims-galleryBar">
         <span className="ims-hint">{t('gallery.total').replace('{n}', String(items.length))}</span>
         <button type="button" className="ims-btn ims-btnGhost ims-btnSmall" onClick={onRefresh}>
-          <IconRefreshOutline16 size={14} /> {t('common.refresh')}
+          <IconRefreshOutlineRegular size={14} /> {t('common.refresh')}
         </button>
       </div>
       {failed ? (

package/src/client/panel/generator.tsx

@@ -10,7 +10,7 @@
  */
 import {
   IconLayers,
-  IconPlusOutline16,
+  IconPlusOutlineMedium,
   type NamespaceSettingsApi,
   type Scope,
 } from '@dsh-plus/shared/client'
@@ -440,7 +440,7 @@ export function GeneratorForm(props: GeneratorProps): ReactElement {
                   )
                 }
               >
-                <IconPlusOutline16 size={18} />
+                <IconPlusOutlineMedium size={18} />
                 <span>{t('upload.pick')}</span>
               </UploadButton>
             </div>
@@ -473,7 +473,7 @@ export function GeneratorForm(props: GeneratorProps): ReactElement {
                 className="ims-thumbAdd"
                 onUploaded={(entries) => setMask(uploadRef(entries))}
               >
-                <IconPlusOutline16 size={18} />
+                <IconPlusOutlineMedium size={18} />
                 <span>{t('upload.pick')}</span>
               </UploadButton>
             </div>

package/src/client/panel/panel.tsx

@@ -9,7 +9,7 @@
  */
 import { Modal } from '@deepseek-ai/dsh-client-ui-primitives'
 import type { NamespaceSettingsApi, Scope } from '@dsh-plus/shared/client'
-import { IconBrush, IconCloseOutline16, IconImage, IconSparkles } from '@dsh-plus/shared/client'
+import { IconBrush, IconCloseOutlineMedium, IconImage, IconSparkles } from '@dsh-plus/shared/client'
 import {
   type ReactElement,
   useCallback,
@@ -147,7 +147,7 @@ export function StudioPanel(props: StudioPanelProps): ReactElement | null {
             aria-label={t('common.close')}
             onClick={() => studio.setOpen(false)}
           >
-            <IconCloseOutline16 size={16} />
+            <IconCloseOutlineMedium size={16} />
           </button>
         </header>
 

package/src/client/panel/picker.tsx

@@ -5,7 +5,7 @@
  * @module image-studio/client/panel/picker
  */
 import { Modal } from '@deepseek-ai/dsh-client-ui-primitives'
-import { IconPlusOutline16 } from '@dsh-plus/shared/client'
+import { IconPlusOutlineMedium } from '@dsh-plus/shared/client'
 import { type ReactElement, useState } from 'react'
 import type { SourceRef, UploadEntry } from '../../dto.ts'
 import type { GalleryItem } from '../../gallery/store.ts'
@@ -128,7 +128,7 @@ export function ImagePicker(props: ImagePickerProps): ReactElement {
             onUploaded={selectUploaded}
             className="ims-btn ims-btnPrimary ims-btnSmall"
           >
-            <IconPlusOutline16 size={14} /> {t('upload.pick')}
+            <IconPlusOutlineMedium size={14} /> {t('upload.pick')}
           </UploadButton>
           <button type="button" className="ims-btn ims-btnGhost" onClick={onClose}>
             {t('common.close')}

package/src/client/panel/tasks.tsx

@@ -4,7 +4,7 @@
  * 轮询由面板根组件负责，本组件纯渲染。
  * @module image-studio/client/panel/tasks
  */
-import { IconLoadingOutline16 } from '@dsh-plus/shared/client'
+import { IconLoadingOutlineRegular } from '@dsh-plus/shared/client'
 import type { ReactElement } from 'react'
 import type { TaskWire } from '../../dto.ts'
 import type { Translate } from '../i18n.ts'
@@ -33,7 +33,7 @@ export function TasksBar(props: TasksBarProps): ReactElement | null {
         const active = task.state === 'queued' || task.state === 'running'
         return (
           <div key={task.id} className={`ims-task ims-task-${task.state}`}>
-            {active ? <IconLoadingOutline16 className="ims-spin" size={14} /> : null}
+            {active ? <IconLoadingOutlineRegular className="ims-spin" size={14} /> : null}
             <span className={`ims-taskState ims-taskState-${task.state}`}>
               {t(STATE_KEYS[task.state])}
             </span>

package/src/config.ts

@@ -6,6 +6,7 @@
  * @module image-studio/config
  */
 import z from '@deepseek-ai/schemastery'
+import type { UnwrapVolatile } from '@dsh-plus/shared'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
@@ -71,30 +72,44 @@ const ProviderPreset: z<ProviderPresetEntry, ProviderPresetEntry> = z.object({
   extraHeaders: z.dict(z.string()).description('附加请求头（部分中转需要）').default({}),
 })
 
+// 0.1.7：全字段 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
+// loader 原位提交活动引用，current() 现取即热。
 export const Config = z.object({
-  promptPresets: z.array(PromptPreset).description('提示词预设').default([]),
-  paramPresets: z.array(ParamPreset).description('参数预设').default([]),
-  providerPresets: z.array(ProviderPreset).description('提供商预设').default([]),
-  maxConcurrent: z.number().min(0).max(16).description('生图任务并发上限（0 = 不限）').default(3),
+  promptPresets: z.array(PromptPreset).description('提示词预设').default([]).volatile(),
+  paramPresets: z.array(ParamPreset).description('参数预设').default([]).volatile(),
+  providerPresets: z.array(ProviderPreset).description('提供商预设').default([]).volatile(),
+  maxConcurrent: z
+    .number()
+    .min(0)
+    .max(16)
+    .description('生图任务并发上限（0 = 不限）')
+    .default(3)
+    .volatile(),
   requestTimeoutMs: z
     .number()
     .min(10_000)
     .max(600_000)
     .description('单请求超时（毫秒；生图长耗时，默认 5 分钟）')
-    .default(300_000),
-  proxy: z.string().description('上游请求代理（空 = 直连）').default(''),
+    .default(300_000)
+    .volatile(),
+  proxy: z.string().description('上游请求代理（空 = 直连）').default('').volatile(),
   galleryMaxItems: z
     .number()
     .min(0)
     .max(10_000)
     .description('画廊保留上限（条，0 = 不清理；超限按最旧删除）')
-    .default(500),
+    .default(500)
+    .volatile(),
   uploadTtlHours: z
     .number()
     .min(1)
     .max(720)
     .description('上传原图保留时长（小时；未被画廊条目引用的超期即回收）')
-    .default(24),
+    .default(24)
+    .volatile(),
 })
 
-export type ImageStudioConfig = Schemastery.TypeT<typeof Config>
+/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+export type ImageStudioConfigFields = Schemastery.TypeT<typeof Config>
+/** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
+export type ImageStudioConfig = UnwrapVolatile<ImageStudioConfigFields>

package/src/index.ts

@@ -9,13 +9,14 @@
  */
 import type { Context } from '@deepseek-ai/cordis'
 
-import { Config, type ImageStudioConfig } from './config.ts'
+import type { ImageStudioConfig, ImageStudioConfigFields } from './config.ts'
 import { ImageStudioService } from './service.ts'
 
 export const name = 'dsh-plus-image-studio'
 
 export const inject = ['credentials'] as const
 
+export { Config, SETTINGS_NS } from './config.ts'
 export { credentialRefNameOf, isValidPresetId } from './credentials.ts'
 export type {
   CredentialStatusWire,
@@ -38,7 +39,6 @@ export { checkImageSize, IMAGE_SIZE_RULE, SIZE_PRESETS } from './params/size.ts'
 export type { ParamSpec, ParamSpecMap } from './params/spec.ts'
 export { normalizeParamSpecs, ParamValidationError, validateParamSpecs } from './params/spec.ts'
 export { ImageStudioService } from './service.ts'
-export { Config }
 
 declare module '@deepseek-ai/cordis' {
   interface Context {
@@ -46,6 +46,7 @@ declare module '@deepseek-ai/cordis' {
   }
 }
 
-export function apply(ctx: Context, config: ImageStudioConfig): void {
+// config 运行期为 loader 解析的 volatile 活动字段（测试可直接传平面值）。
+export function apply(ctx: Context, config: ImageStudioConfig | ImageStudioConfigFields): void {
   ctx.plugin(ImageStudioService, config)
 }

package/src/service.ts

@@ -1,6 +1,7 @@
 /**
  * image-studio 服务主体：
- * - settings installSection（三组预设 + 并发/超时/代理/画廊上限/上传保留时长）；
+ * - 配置：0.1.7 volatile 活动引用（三组预设 + 并发/超时/代理/画廊上限/
+ *   上传保留时长；loader 原位提交热生效）；
  * - TaskRunner 并发生图：提交即排队，成功自动入画廊（元数据 + 图片落盘）；
  * - 提供商预设按 id 即时 resolve credentials（不缓存）；
  * - 上传暂存区：本地文件上传的源图/遮罩，孤儿按 TTL 回收；
@@ -12,13 +13,14 @@ import type { Context as ContextT } from '@deepseek-ai/cordis'
 import { Service } from '@deepseek-ai/cordis'
 import { credentialRef } from '@deepseek-ai/dsh-credentials'
 import type {} from '@deepseek-ai/dsh-settings'
+import { unwrapVolatile } from '@dsh-plus/shared'
 import { registerImageStudioApi } from './api.ts'
-import {
-  type ImageStudioConfig,
-  type ParamPresetEntry,
-  type PromptPresetEntry,
-  type ProviderPresetEntry,
-  SETTINGS_NS,
+import type {
+  ImageStudioConfig,
+  ImageStudioConfigFields,
+  ParamPresetEntry,
+  PromptPresetEntry,
+  ProviderPresetEntry,
 } from './config.ts'
 import { credentialRefNameOf, isValidPresetId } from './credentials.ts'
 import type { GenerateRequest, SourceRef, TaskWire } from './dto.ts'
@@ -47,16 +49,6 @@ import {
   saveUpload as saveUploadEntry,
 } from './uploads/store.ts'
 
-interface SettingsLike {
-  installSection(
-    ownerCtx: ContextT,
-    ns: string,
-    schema: unknown,
-    base: unknown,
-    hooks: { setSource(source: () => unknown): void; onChange(): void },
-  ): void
-}
-
 /** credentials seam 最小面（真实服务经 inject 探测获取）。 */
 interface CredentialsFace {
   resolve(ref: unknown): Promise<{ value: string; source: string } | undefined>
@@ -87,28 +79,18 @@ export class ImageStudioService extends Service {
   private readonly log: (message: string) => void
   /** 进行中的孤儿回收（串行化：索引重写不能并发）。 */
   private pruning: Promise<void> | null
-  // settings 服务窄面（settingsCtx.inject 回调内落存）。declare：不参与类字段
-  // 初始化 emit，保持实例运行期形状与既有产物一致（不因声明而多出 undefined 字段）。
-  private declare settingsRef: SettingsLike | undefined
 
-  constructor(ctx: ContextT, config: ImageStudioConfig) {
+  constructor(ctx: ContextT, config: ImageStudioConfig | ImageStudioConfigFields) {
     super(ctx, 'imageStudio')
-    this.current = () => config
+    // 0.1.7 替代 installSection/setSource：活动引用原位提交，现取即热。
+    this.current = () => unwrapVolatile(config)
     this.log = (message) => ctx.logger('image-studio').warn(message)
     this.pruning = null
-    this.runner = new TaskRunner<TaskSnapshot>({ maxConcurrent: config.maxConcurrent })
+    this.runner = new TaskRunner<TaskSnapshot>({ maxConcurrent: this.current().maxConcurrent })
     // 启动回收一次：上次进程遗留的孤儿上传（未被画廊引用且超 TTL）。
     this.schedulePrune()
-    ctx.inject(['settings'], (settingsCtx) => {
-      this.settingsRef = settingsCtx.settings as unknown as SettingsLike
-      settingsCtx.settings.installSection(ctx, SETTINGS_NS, configSchemaRef, config, {
-        setSource: (source) => {
-          this.current = source as () => ImageStudioConfig
-          this.applyConfig()
-        },
-        onChange: () => {},
-      })
-    })
+    // volatile 提交事件（替代原 setSource→applyConfig）：并发上限热更。
+    ctx.events.on('loader/volatile-update', () => this.applyConfig())
     ctx.inject(['webServer'], (webCtx) => {
       registerImageStudioApi(webCtx as ContextT, this)
     })
@@ -585,9 +567,6 @@ export class ImageStudioService extends Service {
   }
 }
 
-/** 静态 schema 引用（installSection 用；避免循环 import config → service）。 */
-import { Config as configSchemaRef } from './config.ts'
-
 /** 剔除 host 承载参数（model 不进协议参数表——openai-images 请求体单独拼）。 */
 function stripHostParams(params: Record<string, unknown>): Record<string, unknown> {
   const { model: _model, ...rest } = params