@dsh-plus/image-studio 0.1.11 → 0.1.12

package/lib/client.js

@@ -337,6 +337,35 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
+		//#region ../shared/src/client/config-slots.ts
+		/** dsh-plus 聚合 bundle 的包名（各插件 row 均经其补丁层插入 profile）。 */
+		const DSH_PLUS_BUNDLE = "@dsh-plus/bundle-main";
+		/**
+		* 把一张配置卡片同时注册进 legacy 与新版三个槽位。
+		* 任一槽位在当前 dsh 版本未声明时对应 inject 挂起等待，版本不命中即 no-op。
+		*/
+		function injectPluginConfigCard(slots, reg) {
+			const base = {
+				locale: reg.ns,
+				inject: reg.inject
+			};
+			slots.inject("settings.plugin.item", () => slots.register({
+				name: "settings.plugin.item",
+				key: reg.ns,
+				...base
+			}, reg.component));
+			slots.inject("plugins.row.config", () => slots.register({
+				name: "plugins.row.config",
+				key: `${DSH_PLUS_BUNDLE}#${reg.rowId}`,
+				...base
+			}, reg.component));
+			slots.inject("plugins.bundle.config", () => slots.register({
+				name: "plugins.bundle.config",
+				key: reg.pkg,
+				...base
+			}, reg.component));
+		}
+		//#endregion
 		//#region ../shared/src/client/fetch.ts
 		async function parse(res, guard) {
 			const body = await res.json();
@@ -586,8 +615,11 @@ ${extra}
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-		* 服务端直接以字面量注册（settings 编译期校验命名空间语法，见 config.ts），
-		* 浏览器半将其作为 settings.plugin.item keyed 槽位的 key（配置卡片）。
+		* 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+		* 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
+		* （legacy settings.plugin.item keyed 槽位按「卡片编辑的 settings 命名空间」
+		* 分发；0.1.6-alpha.2 起改挂插件页 row/bundle config，见 shared/config-slots），
+		* 同一字面量两处共用，防止漂移。
 		* @module image-studio/ns
 		*/
 		const SETTINGS_NS = "dsh-plus-image-studio";
@@ -992,7 +1024,8 @@ ${extra}
 		//#endregion
 		//#region src/client/card.tsx
 		/**
-		* 配置卡片（settings.plugin.item，key = settings 命名空间）：
+		* 配置卡片（injectPluginConfigCard 三槽位，legacy key = settings 命名空间，
+		* 0.1.6-alpha.2 起为插件页 row/bundle config，view 分发 summary/page）：
 		* 三组预设（提供商/参数/提示词）+ 高级项（并发/超时/代理/画廊上限）的
 		* staged draft 编辑；提供商预设逐条附 API Key 管理（凭据端点，值不回显）。
 		* JSON 字段（extraHeaders/paramSpecs）以文本镜像编辑，保存时解析 +
@@ -1131,7 +1164,7 @@ ${extra}
 			const { t, scope, api } = props;
 			const snapshot = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot());
 			const value = snapshot.value;
-			const [open, setOpen] = (0, react.useState)(false);
+			const [open, setOpen] = (0, react.useState)(props.view === "page");
 			const [draft, setDraft] = (0, react.useState)(null);
 			const [baseline, setBaseline] = (0, react.useState)("");
 			const [saving, setSaving] = (0, react.useState)(false);
@@ -1150,6 +1183,7 @@ ${extra}
 				setBaseline(JSON.stringify(initial));
 			}, [value, draft]);
 			const dirty = (0, react.useMemo)(() => draft !== null && JSON.stringify(draft) !== baseline, [draft, baseline]);
+			if (props.view === "summary") return t("card.summary");
 			if (value === void 0 || draft === null) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("li", {
 				className: "imsc-card",
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
@@ -1610,6 +1644,7 @@ ${extra}
 			"gallery.edit": "二次编辑",
 			"card.title": "图像工作室",
 			"card.description": "文生图/图生图：提供商与 API Key、参数/提示词预设",
+			"card.summary": "文生图/图生图：提供商与 API Key、参数/提示词预设。",
 			"card.providers": "提供商预设",
 			"card.prompts": "提示词预设",
 			"card.params": "参数预设",
@@ -1726,6 +1761,7 @@ ${extra}
 			"gallery.edit": "Edit again",
 			"card.title": "Image Studio",
 			"card.description": "Text/Image-to-image: providers & API keys, param/prompt presets",
+			"card.summary": "Text/Image-to-image: providers & API keys, param/prompt presets.",
 			"card.providers": "Provider presets",
 			"card.prompts": "Prompt presets",
 			"card.params": "Parameter presets",
@@ -4079,16 +4115,17 @@ ${extra}
 					api
 				})
 			}, StudioPanel)), "image-studio: overlay slot");
-			c.slots.inject("settings.plugin.item", () => c.slots.register({
-				name: "settings.plugin.item",
-				key: SETTINGS_NS,
-				locale: NS,
+			injectPluginConfigCard(c.slots, {
+				ns: SETTINGS_NS,
+				rowId: "dsh-plus-image-studio",
+				pkg: PLUGIN_ID,
+				component: StudioConfigCard,
 				inject: () => ({
 					t,
 					scope,
 					api
 				})
-			}, StudioConfigCard));
+			});
 			c.effect(() => () => {
 				panelTag?.remove();
 				cardTag?.remove();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/image-studio",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "dsh-plus service+ui plugin: 图像工作室——OpenAI Images 协议文生图/图生图，全参数开关化，双预设体系，并发生图任务与可二次编辑画廊",
   "type": "module",
   "main": "lib/index.js",
@@ -20,7 +20,7 @@
   ],
   "dependencies": {
     "https-proxy-agent": "^9.1.0",
-    "@dsh-plus/shared": "0.1.18"
+    "@dsh-plus/shared": "0.1.19"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",

package/src/client/card.tsx

@@ -1,5 +1,6 @@
 /**
- * 配置卡片（settings.plugin.item，key = settings 命名空间）：
+ * 配置卡片（injectPluginConfigCard 三槽位，legacy key = settings 命名空间，
+ * 0.1.6-alpha.2 起为插件页 row/bundle config，view 分发 summary/page）：
  * 三组预设（提供商/参数/提示词）+ 高级项（并发/超时/代理/画廊上限）的
  * staged draft 编辑；提供商预设逐条附 API Key 管理（凭据端点，值不回显）。
  * JSON 字段（extraHeaders/paramSpecs）以文本镜像编辑，保存时解析 +
@@ -11,6 +12,7 @@ import {
   type CardStatusState,
   IDLE_STATUS,
   type NamespaceSettingsApi,
+  type PluginConfigViewProps,
   type Scope,
   TextField,
 } from '@dsh-plus/shared/client'
@@ -22,7 +24,7 @@ import { validateParamSpecs } from '../params/spec.ts'
 import { fetchCredentialStatus, fetchProviders, setCredential, unsetCredential } from './api.ts'
 import type { Translate } from './i18n.ts'
 
-export interface CardProps {
+export interface CardProps extends PluginConfigViewProps {
   t: Translate
   scope: Scope
   api: NamespaceSettingsApi
@@ -197,14 +199,15 @@ function CredentialRow(props: { t: Translate; presetId: string; disabled: boolea
   )
 }
 
-export function StudioConfigCard(props: CardProps): ReactElement | null {
+export function StudioConfigCard(props: CardProps): ReactElement | string | null {
   const { t, scope, api } = props
   const snapshot = useSyncExternalStore(
     (listener: () => void) => scope.subscribe(listener),
     () => scope.getSnapshot(),
   )
   const value = snapshot.value as ImageStudioConfig | undefined
-  const [open, setOpen] = useState(false)
+  // 0.1.6-alpha.2 插件页 page 视图为表单落地页，默认展开；旧槽位无 view，保持折叠。
+  const [open, setOpen] = useState(props.view === 'page')
   const [draft, setDraft] = useState<Draft | null>(null)
   const [baseline, setBaseline] = useState('')
   const [saving, setSaving] = useState(false)
@@ -229,6 +232,9 @@ export function StudioConfigCard(props: CardProps): ReactElement | null {
     [draft, baseline],
   )
 
+  // 插件页 summary 视图只出一行简介（hooks 已全部落定，可安全提前返回）。
+  if (props.view === 'summary') return t('card.summary')
+
   if (value === undefined || draft === null) {
     return (
       <li className="imsc-card">

package/src/client/client.ts

@@ -2,7 +2,8 @@
  * 浏览器半入口：
  * - sidebar.footer.action：侧栏底部入口按钮（与文件/终端入口 flex 等分行宽）；
  * - shell.overlay：图像工作室面板（文生图/图生图/画廊 + 任务条）；
- * - settings.plugin.item：配置卡片（三组预设 + 凭据 + 高级项，key = settings 命名空间）。
+ * - 配置卡片：injectPluginConfigCard 三槽位（三组预设 + 凭据 + 高级项；
+ *   legacy settings.plugin.item 与 0.1.6-alpha.2 插件页 row/bundle config）。
  * 模式与 web-files/web-terminal 一致：CJS factory 产物、data-plugin-css 样式
  * 约定、slot 失配静默降级；配置读写经 ctx.remote.settings 直连（远程域名可用）。
  * @module @dsh-plus/image-studio/client
@@ -13,6 +14,7 @@ import {
   createNamespaceApi,
   createSettingsScope,
   injectCardStyle,
+  injectPluginConfigCard,
   type ScopeHostContext,
 } from '@dsh-plus/shared/client'
 
@@ -88,17 +90,13 @@ export function apply(ctx: Context): void {
       ),
     'image-studio: overlay slot',
   )
-  c.slots.inject('settings.plugin.item', () =>
-    c.slots.register(
-      {
-        name: 'settings.plugin.item',
-        key: SETTINGS_NS,
-        locale: NS,
-        inject: () => ({ t, scope, api }),
-      },
-      StudioConfigCard,
-    ),
-  )
+  injectPluginConfigCard(c.slots, {
+    ns: SETTINGS_NS,
+    rowId: 'dsh-plus-image-studio',
+    pkg: PLUGIN_ID,
+    component: StudioConfigCard,
+    inject: () => ({ t, scope, api }),
+  })
   c.effect(
     () => () => {
       panelTag?.remove()

package/src/client/i18n.ts

@@ -96,6 +96,7 @@ export const zh = {
   // 配置卡片
   'card.title': '图像工作室',
   'card.description': '文生图/图生图：提供商与 API Key、参数/提示词预设',
+  'card.summary': '文生图/图生图：提供商与 API Key、参数/提示词预设。',
   'card.providers': '提供商预设',
   'card.prompts': '提示词预设',
   'card.params': '参数预设',
@@ -219,6 +220,7 @@ export const en: Record<DictKey, string> = {
   'gallery.edit': 'Edit again',
   'card.title': 'Image Studio',
   'card.description': 'Text/Image-to-image: providers & API keys, param/prompt presets',
+  'card.summary': 'Text/Image-to-image: providers & API keys, param/prompt presets.',
   'card.providers': 'Provider presets',
   'card.prompts': 'Prompt presets',
   'card.params': 'Parameter presets',

package/src/ns.ts

@@ -1,7 +1,10 @@
 /**
  * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
- * 服务端直接以字面量注册（settings 编译期校验命名空间语法，见 config.ts），
- * 浏览器半将其作为 settings.plugin.item keyed 槽位的 key（配置卡片）。
+ * 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+ * 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
+ * （legacy settings.plugin.item keyed 槽位按「卡片编辑的 settings 命名空间」
+ * 分发；0.1.6-alpha.2 起改挂插件页 row/bundle config，见 shared/config-slots），
+ * 同一字面量两处共用，防止漂移。
  * @module image-studio/ns
  */
 export const SETTINGS_NS = 'dsh-plus-image-studio'