@dsh-plus/image-studio 0.1.34 → 0.1.36

package/lib/index.d.ts

@@ -306,8 +306,8 @@ declare class ImageStudioService extends Service {
 //#region src/credentials.d.ts
 /**
  * 凭据引用名派生与校验：提供商预设 id → IMAGE_STUDIO_PRESET_<ID>。
- * 规则对齐《插件存储规范》：大写下划线、全大写、前缀属主。
- * 纯函数，零依赖。
+ * 命名与归一走 `@dsh-plus/shared` 的公共助手，本模块只补预设 id 的形态校验。
+ * 纯函数，零依赖（浏览器半亦可安全 import）。
  * @module image-studio/credentials
  */
 /** 预设 id 是否合法（kebab-case，用于引用名派生）。 */

package/lib/index.js

@@ -1,6 +1,6 @@
 import { Service } from "@deepseek-ai/cordis";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
-import { atomicWriteFile, commitTmpFile, pluginDataPath, unwrapVolatile } from "@dsh-plus/shared";
+import { atomicWriteFile, commitTmpFile, credentialRefName, pluginCachePath, 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";
@@ -959,12 +959,14 @@ function registerImageStudioApi(ctx, service) {
 //#region src/credentials.ts
 /**
 * 凭据引用名派生与校验：提供商预设 id → IMAGE_STUDIO_PRESET_<ID>。
-* 规则对齐《插件存储规范》：大写下划线、全大写、前缀属主。
-* 纯函数，零依赖。
+* 命名与归一走 `@dsh-plus/shared` 的公共助手，本模块只补预设 id 的形态校验。
+* 纯函数，零依赖（浏览器半亦可安全 import）。
 * @module image-studio/credentials
 */
-/** 引用名前缀（属主段）。 */
-const REF_PREFIX = "IMAGE_STUDIO_PRESET_";
+/** 属主段（插件 id）。 */
+const REF_OWNER = "image-studio";
+/** 业务段前缀（与属主一起构成 IMAGE_STUDIO_PRESET_<ID>）。 */
+const REF_KIND = "preset";
 /** 预设 id 是否合法（kebab-case，用于引用名派生）。 */
 function isValidPresetId(id) {
 	return /^[a-z][a-z0-9-]*$/.test(id) && id.length <= 64;
@@ -972,7 +974,7 @@ function isValidPresetId(id) {
 /** 预设 id → 凭据引用名（kebab → SNAKE 大写）。 */
 function credentialRefNameOf(presetId) {
 	if (!isValidPresetId(presetId)) throw new Error(`非法提供商预设 id：${JSON.stringify(presetId)}`);
-	return `${REF_PREFIX}${presetId.replaceAll("-", "_").toUpperCase()}`;
+	return credentialRefName(REF_OWNER, REF_KIND, presetId);
 }
 //#endregion
 //#region src/images/id.ts
@@ -1243,9 +1245,12 @@ function defaultIdCounter() {
 * 落点 $DSH_HOME/dsh-plus/image-studio/uploads/{index.jsonl, blobs/}
 * @module image-studio/uploads/store
 */
-/** 存储层根路径（惰性解析：DSH_HOME 可能在模块加载后才被测试环境设置）。 */
+/**
+* 存储层根路径（惰性解析：DSH_HOME 可能在模块加载后才被测试环境设置）。
+* 上传是带 TTL 的暂存派生物（`uploadTtlHours` 回收），故落缓存目录。
+*/
 function uploadsRoot() {
-	return pluginDataPath("image-studio", "uploads");
+	return pluginCachePath("image-studio", "uploads");
 }
 function indexFile() {
 	return join(uploadsRoot(), "index.jsonl");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/image-studio",
-  "version": "0.1.34",
+  "version": "0.1.36",
   "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.42"
+    "@dsh-plus/shared": "0.1.44"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.5-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.1-alpha.4",
-    "@deepseek-ai/dsh-credentials": "^0.2.1-alpha.4",
-    "@deepseek-ai/dsh-host-webserver": "^0.2.1-alpha.4",
-    "@deepseek-ai/dsh-settings": "^0.2.1-alpha.4",
-    "@deepseek-ai/schemastery": "^3.18.5-alpha.2"
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-credentials": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.2.1-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.5"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.5-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-credentials": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-host-webserver": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.4",
-    "@deepseek-ai/dsh-settings": "0.2.1-alpha.4",
-    "@deepseek-ai/schemastery": "3.18.5-alpha.2",
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.1",
+    "@deepseek-ai/dsh-credentials": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.1-rc.2",
+    "@deepseek-ai/schemastery": "3.18.5",
     "@types/node": "26.4.0",
     "@types/react": "~18.3.31",
     "react": "^18.2.0"

package/src/client/card.tsx

@@ -10,13 +10,16 @@
  */
 import {
   type CardAction,
-  CardChrome,
   CardLoading,
   type CardStatusState,
+  ConfigShell,
+  FieldGrid,
   IDLE_STATUS,
   type NamespaceSettingsApi,
+  NumberField,
   type PluginConfigViewProps,
   type Scope,
+  Section,
   TextField,
 } from '@dsh-plus/shared/client'
 import { type ReactElement, useEffect, useMemo, useState, useSyncExternalStore } from 'react'
@@ -91,29 +94,24 @@ function AdvancedFields(props: {
 }): ReactElement {
   const { t, draft, disabled, onPatch } = props
   return (
-    <>
-      <h4 className="imsc-groupTitle">{t('card.advanced')}</h4>
-      <div className="imsc-grid2">
-        <TextField
+    <Section prefix="imsc" title={t('card.advanced')} description={t('card.advancedHint')}>
+      <FieldGrid prefix="imsc" columns={2}>
+        <NumberField
           prefix="imsc"
           id="imsc-conc"
           label={t('card.maxConcurrent')}
-          numeric
           value={draft.maxConcurrent}
           disabled={disabled}
           onEdit={(v) => onPatch({ maxConcurrent: v })}
         />
-        <TextField
+        <NumberField
           prefix="imsc"
           id="imsc-timeout"
           label={t('card.requestTimeoutMs')}
-          numeric
           value={draft.requestTimeoutMs}
           disabled={disabled}
           onEdit={(v) => onPatch({ requestTimeoutMs: v })}
         />
-      </div>
-      <div className="imsc-grid2">
         <TextField
           prefix="imsc"
           id="imsc-proxy"
@@ -122,26 +120,24 @@ function AdvancedFields(props: {
           disabled={disabled}
           onEdit={(v) => onPatch({ proxy: v })}
         />
-        <TextField
+        <NumberField
           prefix="imsc"
           id="imsc-gmax"
           label={t('card.galleryMaxItems')}
-          numeric
           value={draft.galleryMaxItems}
           disabled={disabled}
           onEdit={(v) => onPatch({ galleryMaxItems: v })}
         />
-      </div>
-      <TextField
-        prefix="imsc"
-        id="imsc-upload-ttl"
-        label={t('card.uploadTtlHours')}
-        numeric
-        value={draft.uploadTtlHours}
-        disabled={disabled}
-        onEdit={(v) => onPatch({ uploadTtlHours: v })}
-      />
-    </>
+        <NumberField
+          prefix="imsc"
+          id="imsc-upload-ttl"
+          label={t('card.uploadTtlHours')}
+          value={draft.uploadTtlHours}
+          disabled={disabled}
+          onEdit={(v) => onPatch({ uploadTtlHours: v })}
+        />
+      </FieldGrid>
+    </Section>
   )
 }
 
@@ -226,7 +222,7 @@ export function StudioConfigCard(props: CardProps): ReactElement | string | null
   }
 
   return (
-    <CardChrome
+    <ConfigShell
       prefix="imsc"
       title={t('card.title')}
       description={t('card.description')}
@@ -259,6 +255,6 @@ export function StudioConfigCard(props: CardProps): ReactElement | string | null
       <PromptPresetSection {...sectionProps} />
       <ParamPresetSection {...sectionProps} />
       <AdvancedFields t={t} draft={draft} disabled={disabled} onPatch={patch} />
-    </CardChrome>
+    </ConfigShell>
   )
 }

package/src/client/i18n.ts

@@ -1,13 +1,17 @@
 /**
  * i18n 字典（zh 为键域事实源，en 全量对译）；NS 与 settings 命名空间分离，
  * 仅承载前端文案 key。面板 / 入口 / 配置卡片共用同一命名空间。
+ *
+ * 公共键（卡片套件的 save/unsaved/code* 等）来自 shared 的 common 字典并在此合并，
+ * 本文件只维护业务键。
  * @module image-studio/client/i18n
  */
+import { commonEn, commonZh, mergeDict } from '@dsh-plus/shared/client'
 
 /** locale 命名空间。 */
 export const NS = 'dsh-plus-image-studio'
 
-export const zh = {
+const ownZh = {
   // 入口与面板骨架
   'entry.label': '图像',
   'panel.title': '图像工作室',
@@ -98,9 +102,16 @@ export const zh = {
   'card.description': '文生图/图生图：提供商与 API Key、参数/提示词预设',
   'card.summary': '文生图/图生图：提供商与 API Key、参数/提示词预设。',
   'card.providers': '提供商预设',
+  'card.providersHint':
+    '按序尝试的提供商预设：条目内 API Key 走官方 credentials（引用名由预设 ID 派生），保存后不回显。',
   'card.prompts': '提示词预设',
+  'card.promptsHint': '提示词模板列表：生成/编辑面板按名称选用，{prompt} 等占位符由面板注入。',
   'card.params': '参数预设',
+  'card.paramsHint':
+    '参数预设列表：适用端点决定出现在「文生图」还是「图生图」，参数表为 JSON（如 {"size": {"enabled": true, "value": "1024x1024"}}）。',
   'card.advanced': '高级设置',
+  'card.advancedHint':
+    '并发、超时、代理与本地画廊保留策略；留空/0 表示沿用内置默认（并发 2、超时 60000ms、画廊 200 张、上传保留 168 小时）。',
   'card.add': '添加',
   'card.field.id': 'ID',
   'card.field.name': '名称',
@@ -134,12 +145,10 @@ export const zh = {
   'card.badgeOff': '未配置',
 }
 
-export type DictKey = keyof typeof zh
-
 /** 面板/卡片共用的翻译函数类型（slot 注入的 bind 结果按此消费）。 */
 export type Translate = (key: DictKey) => string
 
-export const en: Record<DictKey, string> = {
+const ownEn: Record<keyof typeof ownZh, string> = {
   'entry.label': 'Image',
   'panel.title': 'Image Studio',
   'tab.generation': 'Text to Image',
@@ -222,9 +231,17 @@ export const en: Record<DictKey, string> = {
   '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.providersHint':
+    'Providers tried in order; each entry keeps its API key in official credentials (reference derived from the preset id) and never echoes it back.',
   'card.prompts': 'Prompt presets',
+  'card.promptsHint':
+    'Prompt templates; the generation/edit panels pick them by name and fill placeholders such as {prompt}.',
   'card.params': 'Parameter presets',
+  'card.paramsHint':
+    'Parameter presets; the endpoint decides whether it shows up in Text to Image or Image to Image, and the spec is JSON such as {"size": {"enabled": true, "value": "1024x1024"}}.',
   'card.advanced': 'Advanced',
+  'card.advancedHint':
+    'Concurrency, timeout, proxy and local gallery retention; empty/0 keeps the built-in defaults (concurrency 2, timeout 60000ms, gallery 200, uploads 168h).',
   'card.add': 'Add',
   'card.field.id': 'ID',
   'card.field.name': 'Name',
@@ -258,3 +275,9 @@ export const en: Record<DictKey, string> = {
   'card.badgeOn': '{n} providers',
   'card.badgeOff': 'Not configured',
 }
+
+/** 卡片公共文案 + 本插件文案（own 覆盖同键）：配置卡片经共享套件渲染，公共键只维护一份。 */
+export const zh = mergeDict(commonZh, ownZh)
+export const en: Record<keyof typeof zh, string> = mergeDict(commonEn, ownEn)
+
+export type DictKey = keyof typeof zh