@dsh-plus/image-studio 0.1.27 → 0.1.29

package/lib/client.js

@@ -635,7 +635,7 @@ ${extra}
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-		* 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+		* 服务端直接以字面量注册（dsh-settings 对命名空间做编译期
 		* 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
 		* （插件页配置卡片挂在 row/bundle config 槽位上，与命名空间解耦，
 		* 见 shared/config-slots），

package/lib/index.d.ts

@@ -46,7 +46,7 @@ declare const Config: z<Schemastery.ObjectS<NoInfer<{
   galleryMaxItems: z<number, number, "volatile-defined">;
   uploadTtlHours: z<number, number, "volatile-defined">;
 }>>, "plain">;
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 type ImageStudioConfigFields = Schemastery.TypeT<typeof Config>;
 /** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
 type ImageStudioConfig = UnwrapVolatile<ImageStudioConfigFields>;
@@ -147,10 +147,6 @@ interface GenerateRequest {
   sources?: SourceRef[];
   /** 可选遮罩（官方要求 PNG；与源图同一引用形态）。 */
   mask?: SourceRef;
-  /** @deprecated 旧客户端兼容：等价于 kind='gallery' 的 sources。 */
-  sourceIds?: string[];
-  /** @deprecated 旧客户端兼容：等价于 kind='gallery' 的 mask。 */
-  maskId?: string;
 }
 /** 任务记录 wire 视图。 */
 interface TaskWire {
@@ -247,9 +243,9 @@ declare class ImageStudioService extends Service {
    * 参数预设 + 覆盖 → 归一化参数表；sources/mask 引用 → 输入图字节。
    */
   private prepareTask;
-  /** 源图引用规范化（sources 优先；旧 sourceIds 等价于全部 gallery 引用）。 */
+  /** 源图引用规范化（缺省空数组；引用形态统一在 assertRef 收窄）。 */
   private sourceRefsOf;
-  /** 遮罩引用规范化（mask 优先；旧 maskId 等价于 gallery 引用）。 */
+  /** 遮罩引用规范化（缺省无遮罩）。 */
   private maskRefOf;
   /** 引用形态校验（请求体来自浏览器，kind 封闭集合 + id uuid 形态）。 */
   private assertRef;

package/lib/index.js

@@ -1487,27 +1487,16 @@ var ImageStudioService = class extends Service {
 			sourceUploads: sources.uploadIds
 		};
 	}
-	/** 源图引用规范化（sources 优先；旧 sourceIds 等价于全部 gallery 引用）。 */
+	/** 源图引用规范化（缺省空数组；引用形态统一在 assertRef 收窄）。 */
 	sourceRefsOf(request) {
-		if (request.sources !== void 0) {
-			if (!Array.isArray(request.sources)) throw new ImageStudioError("invalid-request", "sources 必须是数组");
-			return request.sources.map((ref) => this.assertRef(ref));
-		}
-		const legacy = request.sourceIds ?? [];
-		if (!Array.isArray(legacy)) throw new ImageStudioError("invalid-request", "sourceIds 必须是数组");
-		return legacy.map((id) => this.assertRef({
-			kind: "gallery",
-			id
-		}));
-	}
-	/** 遮罩引用规范化（mask 优先；旧 maskId 等价于 gallery 引用）。 */
+		if (request.sources === void 0) return [];
+		if (!Array.isArray(request.sources)) throw new ImageStudioError("invalid-request", "sources 必须是数组");
+		return request.sources.map((ref) => this.assertRef(ref));
+	}
+	/** 遮罩引用规范化（缺省无遮罩）。 */
 	maskRefOf(request) {
-		if (request.mask !== void 0) return this.assertRef(request.mask);
-		if (request.maskId === void 0) return null;
-		return this.assertRef({
-			kind: "gallery",
-			id: request.maskId
-		});
+		if (request.mask === void 0) return null;
+		return this.assertRef(request.mask);
 	}
 	/** 引用形态校验（请求体来自浏览器，kind 封闭集合 + id uuid 形态）。 */
 	assertRef(ref) {
@@ -1734,7 +1723,7 @@ function stripHostParams(params) {
 //#region src/config.ts
 /**
 * 配置单一事实源：cordis 行级 Config（组合默认）与 settings namespace
-* （用户层，$DSH_HOME/settings.yaml 热生效）共用同一 schemastery schema。
+* （用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一 schemastery schema。
 * 三组纯用户配置：提示词预设 / 参数预设 / 提供商预设（API key 不在此，
 * 走 credentials，引用名由 preset id 派生）。
 * @module image-studio/config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/image-studio",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "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.35"
+    "@dsh-plus/shared": "0.1.37"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5-alpha.1",

package/src/config.ts

@@ -1,6 +1,6 @@
 /**
  * 配置单一事实源：cordis 行级 Config（组合默认）与 settings namespace
- * （用户层，$DSH_HOME/settings.yaml 热生效）共用同一 schemastery schema。
+ * （用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一 schemastery schema。
  * 三组纯用户配置：提示词预设 / 参数预设 / 提供商预设（API key 不在此，
  * 走 credentials，引用名由 preset id 派生）。
  * @module image-studio/config
@@ -72,7 +72,7 @@ const ProviderPreset: z<ProviderPresetEntry, ProviderPresetEntry> = z.object({
   extraHeaders: z.dict(z.string()).description('附加请求头（部分中转需要）').default({}),
 })
 
-// 0.1.7：全字段 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
+// 全字段 `.volatile()`——条目进入 settings describe 视图（卡片可读写），
 // loader 原位提交活动引用，current() 现取即热。
 export const Config = z.object({
   promptPresets: z.array(PromptPreset).description('提示词预设').default([]).volatile(),
@@ -109,7 +109,7 @@ export const Config = z.object({
     .volatile(),
 })
 
-/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+/** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 export type ImageStudioConfigFields = Schemastery.TypeT<typeof Config>
 /** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
 export type ImageStudioConfig = UnwrapVolatile<ImageStudioConfigFields>

package/src/dto.ts

@@ -43,10 +43,6 @@ export interface GenerateRequest {
   sources?: SourceRef[]
   /** 可选遮罩（官方要求 PNG；与源图同一引用形态）。 */
   mask?: SourceRef
-  /** @deprecated 旧客户端兼容：等价于 kind='gallery' 的 sources。 */
-  sourceIds?: string[]
-  /** @deprecated 旧客户端兼容：等价于 kind='gallery' 的 mask。 */
-  maskId?: string
 }
 
 /** 任务记录 wire 视图。 */

package/src/ns.ts

@@ -1,6 +1,6 @@
 /**
  * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
- * 服务端直接以字面量注册（0.1.2-alpha.2 起 dsh-settings 对命名空间做编译期
+ * 服务端直接以字面量注册（dsh-settings 对命名空间做编译期
  * 语法校验，见 config.ts）；浏览器半把它作为配置卡片的注册键
  * （插件页配置卡片挂在 row/bundle config 槽位上，与命名空间解耦，
  * 见 shared/config-slots），

package/src/service.ts

@@ -1,6 +1,6 @@
 /**
  * image-studio 服务主体：
- * - 配置：0.1.7 volatile 活动引用（三组预设 + 并发/超时/代理/画廊上限/
+ * - 配置：volatile 活动引用（三组预设 + 并发/超时/代理/画廊上限/
  *   上传保留时长；loader 原位提交热生效）；
  * - TaskRunner 并发生图：提交即排队，成功自动入画廊（元数据 + 图片落盘）；
  * - 提供商预设按 id 即时 resolve credentials（不缓存）；
@@ -82,7 +82,7 @@ export class ImageStudioService extends Service {
 
   constructor(ctx: ContextT, config: ImageStudioConfig | ImageStudioConfigFields) {
     super(ctx, 'imageStudio')
-    // 0.1.7 替代 installSection/setSource：活动引用原位提交，现取即热。
+    // 替代 installSection/setSource：活动引用原位提交，现取即热。
     this.current = () => unwrapVolatile(config)
     this.log = (message) => ctx.logger('image-studio').warn(message)
     this.pruning = null
@@ -259,26 +259,19 @@ export class ImageStudioService extends Service {
     }
   }
 
-  /** 源图引用规范化（sources 优先；旧 sourceIds 等价于全部 gallery 引用）。 */
+  /** 源图引用规范化（缺省空数组；引用形态统一在 assertRef 收窄）。 */
   private sourceRefsOf(request: GenerateRequest): SourceRef[] {
-    if (request.sources !== undefined) {
-      if (!Array.isArray(request.sources)) {
-        throw new ImageStudioError('invalid-request', 'sources 必须是数组')
-      }
-      return request.sources.map((ref) => this.assertRef(ref))
-    }
-    const legacy = request.sourceIds ?? []
-    if (!Array.isArray(legacy)) {
-      throw new ImageStudioError('invalid-request', 'sourceIds 必须是数组')
+    if (request.sources === undefined) return []
+    if (!Array.isArray(request.sources)) {
+      throw new ImageStudioError('invalid-request', 'sources 必须是数组')
     }
-    return legacy.map((id) => this.assertRef({ kind: 'gallery', id }))
+    return request.sources.map((ref) => this.assertRef(ref))
   }
 
-  /** 遮罩引用规范化（mask 优先；旧 maskId 等价于 gallery 引用）。 */
+  /** 遮罩引用规范化（缺省无遮罩）。 */
   private maskRefOf(request: GenerateRequest): SourceRef | null {
-    if (request.mask !== undefined) return this.assertRef(request.mask)
-    if (request.maskId === undefined) return null
-    return this.assertRef({ kind: 'gallery', id: request.maskId })
+    if (request.mask === undefined) return null
+    return this.assertRef(request.mask)
   }
 
   /** 引用形态校验（请求体来自浏览器，kind 封闭集合 + id uuid 形态）。 */