@dickpy/dsh-imagegen 1.5.5 → 1.5.7

package/lib/index.js

@@ -41,7 +41,7 @@ function installSettingsSectionCompat(ctx, ns, schema, entry, hooks) {
 /** Settings namespace this plugin owns (host settings seam + bridge). */
 const IMAGEGEN_SETTINGS_NAMESPACE = "dsh-imagegen";
 /** Published package version shared by the host updater and the client UI. */
-const PLUGIN_VERSION = "1.5.5";
+const PLUGIN_VERSION = "1.5.7";
 /** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
 const SETTINGS_API = {
 	describe: "/api/dsh-imagegen/settings/describe",
@@ -230,8 +230,27 @@ const ENTRIES = {
 		supportsEdit: true,
 		supportsAspectRatio: true,
 		qualityTiers: ["auto"]
+	},
+	minimax: {
+		label: "MiniMax",
+		labelZh: "MiniMax 图像",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: ["auto"]
 	}
 };
+/** Documented upstream prompt hard limits (UTF-16 code units). The engine
+*  fast-fails on these before any network call and the panel counter shows
+*  them live; families absent here have no documented limit. */
+const PROMPT_CHAR_LIMITS = { minimax: 1500 };
+/** The documented prompt character limit for a model id, or null when the
+*  family has no known limit. Single source of truth for engine enforcement
+*  and the panel's live counter. */
+function promptCharLimit(model) {
+	const { family } = describeModel(model);
+	return (family !== "unknown" ? PROMPT_CHAR_LIMITS[family] : void 0) ?? null;
+}
 /** Official Gemini image ids served by Nano Banana gateways. */
 const NANOBANANA_GEMINI_IDS = /* @__PURE__ */ new Set([
 	"gemini-3-pro-image",
@@ -272,6 +291,10 @@ function describeModel(model) {
 		family: "qwen",
 		...ENTRIES.qwen
 	};
+	if (/^(?:minimax[-_/])?image-\d+/i.test(id)) return {
+		family: "minimax",
+		...ENTRIES.minimax
+	};
 	return {
 		family: "unknown",
 		label: "unknown",
@@ -381,6 +404,17 @@ async function listImageModels(config) {
 async function listPromptModels(config) {
 	return listOpenAIModels(config);
 }
+/** Remove reasoning-model artifacts from a chat model's visible content:
+*  complete `<think>…</think>` blocks first, then anything from a dangling
+*  unclosed `<think>` to the end of the text. Reasoning models served through
+*  OpenAI-compatible endpoints (MiniMax M3, DeepSeek R1, Qwen QVQ, …) inline
+*  these blocks in `message.content`; leaking them into the prompt box both
+*  pollutes the prompt and can push it past image models' length limits. */
+function stripReasoning(text) {
+	const withoutClosed = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
+	const dangling = /<think>/i.exec(withoutClosed);
+	return (dangling === null ? withoutClosed : withoutClosed.slice(0, dangling.index)).trim();
+}
 /** Expand a concise image request into a production-ready image prompt. */
 async function enhancePrompt(config, prompt) {
 	if (config.apiUrl.trim() === "" || config.model.trim() === "") throw new Error("prompt enhancement model is not configured");
@@ -402,7 +436,9 @@ async function enhancePrompt(config, prompt) {
 	const choices = Array.isArray(body.choices) ? body.choices : [];
 	const content = choices[0] !== null && typeof choices[0] === "object" ? choices[0].message?.content : void 0;
 	if (typeof content !== "string" || content.trim() === "") throw new Error("chat model returned an empty prompt");
-	return content.trim();
+	const enhanced = stripReasoning(content);
+	if (enhanced === "") throw new Error("chat model returned only reasoning content (empty <think> payload)");
+	return enhanced;
 }
 //#endregion
 //#region src/image-models.ts
@@ -505,6 +541,28 @@ function isZhipuImage(model) {
 function isQwenImage(model) {
 	return modelFamily(model) === "qwen";
 }
+/** Whether the model is MiniMax image-01, which speaks MiniMax's native
+*  `/image_generation` contract (NOT OpenAI-compatible): `aspect_ratio`,
+*  `subject_reference` for image-to-image, `data.image_base64[]` results, and
+*  errors reported as HTTP 200 + non-zero `base_resp.status_code`. */
+function isMiniMaxImage(model) {
+	return modelFamily(model) === "minimax";
+}
+/** Aspect ratios MiniMax image-01 documents (the panel vocabulary is a superset). */
+const MINIMAX_RATIOS = /* @__PURE__ */ new Set([
+	"1:1",
+	"16:9",
+	"4:3",
+	"3:2",
+	"2:3",
+	"3:4",
+	"9:16",
+	"21:9"
+]);
+/** MiniMax caps one request at 9 images. */
+const MINIMAX_MAX_N = 9;
+/** MiniMax image-01 rejects prompts of 1500+ characters; the exact number
+*  lives in model-catalog.ts so the panel counter and this guard agree. */
 function isGlmImage(model) {
 	return /^glm-image(?:-|$)/i.test(model.trim());
 }
@@ -634,6 +692,19 @@ function isPresignedUrl(value) {
 	if (params.has("x-amz-signature") || params.has("x-amz-credential")) return true;
 	return params.has("signature") && (params.has("expires") || params.has("googleaccessid") || params.has("awsaccesskeyid"));
 }
+/**
+* Whether a result URL lives on the same origin as the configured API base.
+* The upstream Bearer key is only ever forwarded to this origin: a provider
+* (or a compromised relay) that hands back an image URL on a foreign host
+* must not be able to harvest the key through that download.
+*/
+function isSameOriginAsApi(value, apiUrl) {
+	try {
+		return new URL(value).origin === new URL(apiUrl).origin;
+	} catch {
+		return false;
+	}
+}
 /** Clamp the requested image count into the API-accepted range. */
 function clampCount(n) {
 	if (!Number.isFinite(n)) return 1;
@@ -713,8 +784,9 @@ async function normalizeItem(item, upstream, signal) {
 	try {
 		let response;
 		try {
+			const forwardKey = upstream.apiKey !== "" && !isPresignedUrl(url) && isSameOriginAsApi(url, upstream.apiUrl);
 			response = await fetch(url, {
-				...isPresignedUrl(url) || upstream.apiKey === "" ? {} : { headers: { authorization: `Bearer ${upstream.apiKey}` } },
+				...forwardKey ? { headers: { authorization: `Bearer ${upstream.apiKey}` } } : {},
 				signal: budget.signal
 			});
 		} catch (error) {
@@ -881,15 +953,24 @@ async function requestOneImage(baseUrl, upstream, request, params, signal) {
 	let body;
 	if (request.mode === "edit") {
 		if (typeof request.image !== "string" || request.image === "") throw new ImageGenError("图生图需要上传参考图片", "edit-image-missing");
-		const parsed = parseDataUrl(request.image);
-		if (parsed === void 0) throw new ImageGenError("参考图片格式无效", "edit-image-invalid");
-		let bytes;
-		try {
-			bytes = Buffer.from(parsed.base64, "base64");
-		} catch {
-			throw new ImageGenError("参考图片数据无法解码", "edit-image-invalid");
-		}
-		if (bytes.byteLength > MAX_EDIT_IMAGE_BYTES) throw new ImageGenError("参考图片超过 10MB 上限", "edit-image-too-large");
+		const decodeReference = (dataUrl) => {
+			const parsed = parseDataUrl(dataUrl);
+			if (parsed === void 0) throw new ImageGenError("参考图片格式无效", "edit-image-invalid");
+			let bytes;
+			try {
+				bytes = Buffer.from(parsed.base64, "base64");
+			} catch {
+				throw new ImageGenError("参考图片数据无法解码", "edit-image-invalid");
+			}
+			if (bytes.byteLength > MAX_EDIT_IMAGE_BYTES) throw new ImageGenError("参考图片超过 10MB 上限", "edit-image-too-large");
+			return {
+				bytes,
+				mime: parsed.mime,
+				filename: `reference.${extensionOf$3(parsed.mime)}`
+			};
+		};
+		const primary = decodeReference(request.image);
+		const extras = (request.images ?? []).filter((img) => typeof img === "string" && img !== "").slice(0, 4).map(decodeReference);
 		if (isGrokImagine(params.model)) {
 			headers["content-type"] = "application/json";
 			body = JSON.stringify({
@@ -904,7 +985,7 @@ async function requestOneImage(baseUrl, upstream, request, params, signal) {
 			});
 		} else if (isNanoBanana(params.model)) {
 			const form = new FormData();
-			form.append("image", new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf$3(parsed.mime)}`);
+			form.append("image", new Blob([primary.bytes], { type: primary.mime }), primary.filename);
 			form.append("prompt", request.prompt);
 			form.append("model", params.model);
 			if (params.aspect_ratio !== void 0) form.append("aspect_ratio", params.aspect_ratio);
@@ -915,14 +996,15 @@ async function requestOneImage(baseUrl, upstream, request, params, signal) {
 			body = JSON.stringify({
 				model: params.model,
 				prompt: request.prompt,
-				image: [request.image],
+				image: [request.image, ...(request.images ?? []).filter((img) => typeof img === "string" && img !== "").slice(0, 4)],
 				...params.size !== void 0 ? { size: params.size } : {},
 				...params.resolution !== void 0 ? { resolution: params.resolution } : {},
 				response_format: isVolcSeedream(params.model) ? "url" : "b64_json"
 			});
 		} else {
 			const form = new FormData();
-			form.append("image", new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf$3(parsed.mime)}`);
+			if (extras.length > 0) for (const [index, reference] of [primary, ...extras].entries()) form.append("image[]", new Blob([reference.bytes], { type: reference.mime }), `reference-${index}.${extensionOf$3(reference.mime)}`);
+			else form.append("image", new Blob([primary.bytes], { type: primary.mime }), primary.filename);
 			form.append("prompt", request.prompt);
 			form.append("model", params.model);
 			if (params.size !== void 0) form.append("size", params.size);
@@ -1058,6 +1140,99 @@ async function generateQwenImage(baseUrl, upstream, request, options) {
 	}
 }
 /**
+* MiniMax image-01 (native `/image_generation`): one JSON request that batches
+* up to 9 images and returns them inline as base64. Image-to-image rides the
+* `subject_reference` array (a character reference, data URL accepted). The
+* endpoint answers HTTP 200 even on failure, so `base_resp.status_code` is the
+* real verdict.
+*/
+async function generateMiniMaxImage(baseUrl, upstream, request, options) {
+	const model = wireModel(request);
+	const promptLimit = promptCharLimit(model);
+	if (promptLimit !== null && request.prompt.length >= promptLimit) throw new ImageGenError(`MiniMax image-01 要求提示词少于 ${promptLimit} 字符（当前 ${request.prompt.length}），请精简后重试`, "prompt-too-long");
+	const body = {
+		model,
+		prompt: request.prompt,
+		response_format: "base64"
+	};
+	const ratio = request.size.trim();
+	if (ratio !== "" && ratio !== "auto") {
+		if (!MINIMAX_RATIOS.has(ratio)) throw new ImageGenError(`MiniMax image-01 不支持 ${ratio} 宽高比，可选：${Array.from(MINIMAX_RATIOS).join(" / ")}`, "size-unsupported");
+		body.aspect_ratio = ratio;
+	}
+	const count = Math.min(MINIMAX_MAX_N, clampCount(request.n));
+	if (count > 1) body.n = count;
+	if (request.mode === "edit") {
+		if (typeof request.image !== "string" || request.image === "") throw new ImageGenError("图生图需要上传参考图片", "edit-image-missing");
+		const parsed = parseDataUrl(request.image);
+		if (parsed === void 0) throw new ImageGenError("参考图片格式无效", "edit-image-invalid");
+		if (Buffer.from(parsed.base64, "base64").byteLength > MAX_EDIT_IMAGE_BYTES) throw new ImageGenError("参考图片超过 10MB 上限", "edit-image-too-large");
+		body.subject_reference = [{
+			type: "character",
+			image_file: request.image
+		}];
+	}
+	const budget = requestSignal(options.signal, UPSTREAM_TIMEOUT_MS);
+	try {
+		let response;
+		try {
+			response = await fetch(`${baseUrl}/image_generation`, {
+				method: "POST",
+				headers: {
+					authorization: `Bearer ${upstream.apiKey.trim()}`,
+					"content-type": "application/json"
+				},
+				body: JSON.stringify(body),
+				signal: budget.signal
+			});
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (options.signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`无法连接上游接口：${error instanceof Error ? error.message : String(error)}`, "upstream-unreachable");
+		}
+		let payload;
+		try {
+			payload = await response.json();
+		} catch (error) {
+			if (isBudgetTimeout(error)) throw new ImageGenError("上游接口响应超时（240 秒）", "upstream-timeout");
+			if (options.signal?.aborted === true) throw new ImageGenError("任务已取消", "cancelled");
+			throw new ImageGenError(`上游接口返回了非 JSON 响应（HTTP ${response.status}）`, "upstream-invalid");
+		}
+		if (payload === null || typeof payload !== "object") throw new ImageGenError(upstreamMessage(payload, response.status), "upstream-rejected");
+		const record = payload;
+		const baseResp = record.base_resp;
+		if (baseResp !== null && typeof baseResp === "object") {
+			const status = baseResp.status_code;
+			if (typeof status === "number" && status !== 0) {
+				const msg = baseResp.status_msg;
+				throw new ImageGenError(`MiniMax 拒绝请求（${status}）：${typeof msg === "string" && msg !== "" ? msg : "unknown error"}`, status === 1004 || status === 2049 ? "upstream-unauthorized" : "upstream-rejected");
+			}
+		}
+		if (!response.ok) throw new ImageGenError(upstreamMessage(payload, response.status), "upstream-rejected");
+		const data = record.data;
+		const b64s = data !== null && typeof data === "object" && Array.isArray(data.image_base64) ? data.image_base64.filter((item) => typeof item === "string" && item.trim() !== "") : [];
+		const urls = data !== null && typeof data === "object" && Array.isArray(data.image_urls) ? data.image_urls.filter((item) => typeof item === "string" && item !== "") : [];
+		if (b64s.length === 0 && urls.length === 0) throw new ImageGenError("上游响应缺少图片内容", "upstream-empty");
+		const images = b64s.map((raw) => {
+			const b64 = bareBase64(raw);
+			return {
+				b64,
+				mime: detectImageMime(Buffer.from(b64, "base64")) ?? "image/jpeg"
+			};
+		});
+		for (const url of urls) {
+			const normalized = await normalizeItem({ url }, upstream, options.signal);
+			images.push({
+				b64: normalized.b64,
+				mime: normalized.mime
+			});
+		}
+		return { images };
+	} finally {
+		budget.dispose();
+	}
+}
+/**
 * Forward one generate request to the configured endpoint. The requested image
 * count is satisfied with N parallel single-image requests (the `n` batch
 * parameter is never sent, because Responses-API-based gateways reject it as
@@ -1068,6 +1243,7 @@ async function generateImage(upstream, request, options = {}) {
 	if (baseUrl === "") throw new ImageGenError("api_url 未配置：请先在「设置 → 插件 → 可配置」中填写", "config-missing");
 	if (upstream.apiKey.trim() === "") throw new ImageGenError("api_key 未配置：请先在「设置 → 插件 → 可配置」中填写", "config-missing");
 	if (isQwenImage(wireModel(request))) return generateQwenImage(baseUrl, upstream, request, options);
+	if (isMiniMaxImage(wireModel(request))) return generateMiniMaxImage(baseUrl, upstream, request, options);
 	if (request.mode === "edit" && isZhipuImage(wireModel(request))) throw new ImageGenError("智谱 GLM-Image 当前仅支持文生图，请切换到文生图模式或选择支持图生图的模型", "edit-unsupported");
 	const params = effectiveParams(request);
 	const count = effectiveCount(request);
@@ -1178,6 +1354,17 @@ async function testStorage(config) {
 	};
 }
 //#endregion
+//#region src/image-storage-path.ts
+const DEFAULT_ROOT = path.join(process.env.DSH_HOME?.trim() || path.join(homedir(), ".dsh"), "dsh-imagegen");
+let root = DEFAULT_ROOT;
+function imageDataRoot() {
+	return root;
+}
+function setImageDataRoot(value) {
+	const trimmed = value?.trim();
+	root = trimmed === void 0 || trimmed === "" ? DEFAULT_ROOT : path.resolve(trimmed);
+}
+//#endregion
 //#region src/history-store.ts
 /**
 * Host-persisted generation history: images are stored as individual files
@@ -1188,9 +1375,15 @@ async function testStorage(config) {
 *
 * Framework-free (node:fs only) so the route layer can drive it directly.
 */
-const HISTORY_DIR$1 = path.join(homedir(), ".dsh", "dsh-imagegen");
-const INDEX_PATH$1 = path.join(HISTORY_DIR$1, "index.json");
-const IMAGES_DIR$1 = path.join(HISTORY_DIR$1, "images");
+function historyDir() {
+	return imageDataRoot();
+}
+function indexPath$1() {
+	return path.join(historyDir(), "index.json");
+}
+function imagesDir$1() {
+	return path.join(historyDir(), "images");
+}
 let pendingMutation$1 = Promise.resolve();
 function mutateHistory(operation) {
 	const next = pendingMutation$1.then(operation, operation);
@@ -1223,12 +1416,12 @@ function safeId$2(id) {
 }
 /** Ensure the storage directories exist. */
 async function ensureDirs$1() {
-	await promises.mkdir(IMAGES_DIR$1, { recursive: true });
+	await promises.mkdir(imagesDir$1(), { recursive: true });
 }
 /** Read the index, tolerating a missing/corrupt file. */
 async function readIndex$1() {
 	try {
-		const raw = await promises.readFile(INDEX_PATH$1, "utf8");
+		const raw = await promises.readFile(indexPath$1(), "utf8");
 		const parsed = JSON.parse(raw);
 		if (parsed === null || typeof parsed !== "object") return [];
 		const entries = parsed.entries;
@@ -1242,9 +1435,9 @@ async function readIndex$1() {
 async function writeIndex$1(entries) {
 	await ensureDirs$1();
 	const payload = { entries };
-	const tmp = `${INDEX_PATH$1}.tmp-${process.pid}`;
+	const tmp = `${indexPath$1()}.tmp-${process.pid}`;
 	await promises.writeFile(tmp, JSON.stringify(payload), "utf8");
-	await promises.rename(tmp, INDEX_PATH$1);
+	await promises.rename(tmp, indexPath$1());
 }
 /** Structural guard for a stored entry. */
 function isStoredEntry$1(value) {
@@ -1259,7 +1452,7 @@ function isStoredEntry$1(value) {
 /** Remove one entry's image files (best effort). */
 async function removeEntryFiles$1(entry) {
 	for (const image of entry.images) try {
-		await promises.rm(path.join(IMAGES_DIR$1, image.file), { force: true });
+		await promises.rm(path.join(imagesDir$1(), image.file), { force: true });
 	} catch {}
 }
 /** Project a stored entry onto the wire shape (image URLs). */
@@ -1306,8 +1499,8 @@ async function appendHistory(input) {
 			for (let index = 0; index < input.images.length; index++) {
 				const image = input.images[index];
 				const file = `${prefix}-${index}.${extensionOf$2(image.mime)}`;
-				await promises.writeFile(path.join(IMAGES_DIR$1, file), Buffer.from(image.b64, "base64"));
-				notifyImageSaved("history", path.join(IMAGES_DIR$1, file));
+				await promises.writeFile(path.join(imagesDir$1(), file), Buffer.from(image.b64, "base64"));
+				notifyImageSaved("history", path.join(imagesDir$1(), file));
 				storedImages.push({
 					file,
 					mime: image.mime,
@@ -1372,7 +1565,7 @@ async function readHistoryImage(file) {
 	if (!/^[a-zA-Z0-9][a-zA-Z0-9-]*-[0-9]+\.(png|jpg|jpeg|webp|gif)$/.test(file)) return void 0;
 	try {
 		return {
-			data: await promises.readFile(path.join(IMAGES_DIR$1, file)),
+			data: await promises.readFile(path.join(imagesDir$1(), file)),
 			mime: mimeOfFile$2(file)
 		};
 	} catch {
@@ -1389,7 +1582,6 @@ var GenerationTaskQueue = class {
 	controllers = /* @__PURE__ */ new Map();
 	listeners = /* @__PURE__ */ new Set();
 	running = 0;
-	serialRunning = false;
 	constructor(run, concurrency = 1) {
 		this.run = run;
 		this.concurrency = concurrency;
@@ -1430,15 +1622,16 @@ var GenerationTaskQueue = class {
 		const previous = this.tasks.find((item) => item.id === id);
 		return previous === void 0 ? void 0 : this.submit(previous.request);
 	}
+	/** Start queued tasks while capacity remains. Plain submissions and
+	* comparison batches alike run in parallel up to the host-wide limit, so one
+	* slow upstream can no longer hold back unrelated generations. */
 	drain() {
 		while (this.running < Math.max(1, this.concurrency)) {
-			const task = this.tasks.find((item) => item.status === "queued" && (this.running === 0 || item.request.comparisonId !== void 0 && !this.serialRunning));
+			const task = this.tasks.find((item) => item.status === "queued");
 			if (task === void 0) return;
 			this.running += 1;
-			if (task.request.comparisonId === void 0) this.serialRunning = true;
 			this.runTask(task).finally(() => {
 				this.running -= 1;
-				if (task.request.comparisonId === void 0) this.serialRunning = false;
 				this.drain();
 			});
 		}
@@ -1558,10 +1751,15 @@ var ImageGenerationRuntime = class {
 * Framework-free (node:fs + node:crypto only) so the route layer can drive it
 * directly.
 */
-const HISTORY_DIR = path.join(homedir(), ".dsh", "dsh-imagegen");
-const GALLERY_DIR = path.join(HISTORY_DIR, "gallery");
-const INDEX_PATH = path.join(GALLERY_DIR, "index.json");
-const IMAGES_DIR = path.join(GALLERY_DIR, "images");
+function galleryDir() {
+	return path.join(imageDataRoot(), "gallery");
+}
+function indexPath() {
+	return path.join(galleryDir(), "index.json");
+}
+function imagesDir() {
+	return path.join(galleryDir(), "images");
+}
 let pendingMutation = Promise.resolve();
 function mutateGallery(operation) {
 	const next = pendingMutation.then(operation, operation);
@@ -1600,12 +1798,12 @@ function fingerprint(input) {
 }
 /** Ensure the storage directories exist. */
 async function ensureDirs() {
-	await promises.mkdir(IMAGES_DIR, { recursive: true });
+	await promises.mkdir(imagesDir(), { recursive: true });
 }
 /** Read the index, tolerating a missing/corrupt file. */
 async function readIndex() {
 	try {
-		const raw = await promises.readFile(INDEX_PATH, "utf8");
+		const raw = await promises.readFile(indexPath(), "utf8");
 		const parsed = JSON.parse(raw);
 		if (parsed === null || typeof parsed !== "object") return [];
 		const entries = parsed.entries;
@@ -1619,9 +1817,9 @@ async function readIndex() {
 async function writeIndex(entries) {
 	await ensureDirs();
 	const payload = { entries };
-	const tmp = `${INDEX_PATH}.tmp-${process.pid}`;
+	const tmp = `${indexPath()}.tmp-${process.pid}`;
 	await promises.writeFile(tmp, JSON.stringify(payload), "utf8");
-	await promises.rename(tmp, INDEX_PATH);
+	await promises.rename(tmp, indexPath());
 }
 /** Structural guard for a stored entry. */
 function isStoredEntry(value) {
@@ -1636,7 +1834,7 @@ function isStoredEntry(value) {
 /** Remove one entry's image files (best effort). */
 async function removeEntryFiles(entry) {
 	for (const image of entry.images) try {
-		await promises.rm(path.join(IMAGES_DIR, image.file), { force: true });
+		await promises.rm(path.join(imagesDir(), image.file), { force: true });
 	} catch {}
 }
 /** Project a stored entry onto the wire shape (image URLs). */
@@ -1692,8 +1890,8 @@ async function appendGallery(input) {
 			for (let index = 0; index < input.images.length; index++) {
 				const image = input.images[index];
 				const file = `${prefix}-${index}.${extensionOf$1(image.mime)}`;
-				await promises.writeFile(path.join(IMAGES_DIR, file), Buffer.from(image.b64, "base64"));
-				notifyImageSaved("gallery", path.join(IMAGES_DIR, file));
+				await promises.writeFile(path.join(imagesDir(), file), Buffer.from(image.b64, "base64"));
+				notifyImageSaved("gallery", path.join(imagesDir(), file));
 				storedImages.push({
 					file,
 					mime: image.mime,
@@ -1769,7 +1967,7 @@ async function readGalleryImage(file) {
 	if (!/^[a-zA-Z0-9][a-zA-Z0-9-]*-[0-9]+\.(png|jpg|jpeg|webp|gif)$/.test(file)) return void 0;
 	try {
 		return {
-			data: await promises.readFile(path.join(IMAGES_DIR, file)),
+			data: await promises.readFile(path.join(imagesDir(), file)),
 			mime: mimeOfFile$1(file)
 		};
 	} catch {
@@ -1779,11 +1977,6 @@ async function readGalleryImage(file) {
 //#endregion
 //#region src/canvas-store.ts
 /** Host-persisted infinite canvas documents and content-addressed assets. */
-const DATA_ROOT = process.env.DSH_HOME?.trim() || path.join(homedir(), ".dsh");
-const CANVAS_ROOT = path.join(DATA_ROOT, "dsh-imagegen", "canvas");
-path.join(CANVAS_ROOT, "pages");
-path.join(CANVAS_ROOT, "assets");
-path.join(CANVAS_ROOT, "index.json");
 var CanvasConflictError = class extends Error {
 	code = "canvas-conflict";
 	constructor(message = "画布已在其他窗口更新，请重新加载后再保存。") {
@@ -1867,7 +2060,7 @@ function isNode(value) {
 function isDocument(value) {
 	if (value === null || typeof value !== "object") return false;
 	const document = value;
-	return document.version === 2 && typeof document.id === "string" && typeof document.title === "string" && typeof document.revision === "number" && document.viewport !== null && typeof document.viewport === "object" && typeof document.viewport.x === "number" && typeof document.viewport.y === "number" && typeof document.viewport.k === "number" && (document.background === "dots" || document.background === "lines" || document.background === "blank") && Array.isArray(document.nodes) && document.nodes.every(isNode) && Array.isArray(document.connections);
+	return document.version === 2 && typeof document.id === "string" && typeof document.title === "string" && typeof document.revision === "number" && document.viewport !== null && typeof document.viewport === "object" && typeof document.viewport.x === "number" && typeof document.viewport.y === "number" && typeof document.viewport.k === "number" && (document.background === "dots" || document.background === "lines" || document.background === "diagonal" || document.background === "checker" || document.background === "blank" || document.background === "image") && (document.backgroundImage === void 0 || typeof document.backgroundImage === "string") && Array.isArray(document.nodes) && document.nodes.every(isNode) && Array.isArray(document.connections);
 }
 /** Upgrade a v1 (image/text/annotation + edges) document to the v2 node-graph model.
 * Images and text notes keep their geometry; annotation prompt cards become plain
@@ -1987,17 +2180,17 @@ function serialize(operation) {
 }
 var CanvasStore = class {
 	root;
-	constructor(root = CANVAS_ROOT) {
+	constructor(root) {
 		this.root = root;
 	}
 	pagesDir() {
-		return path.join(this.root, "pages");
+		return path.join(this.root ?? path.join(imageDataRoot(), "canvas"), "pages");
 	}
 	assetsDir() {
-		return path.join(this.root, "assets");
+		return path.join(this.root ?? path.join(imageDataRoot(), "canvas"), "assets");
 	}
 	indexPath() {
-		return path.join(this.root, "index.json");
+		return path.join(this.root ?? path.join(imageDataRoot(), "canvas"), "index.json");
 	}
 	async ensure() {
 		await promises.mkdir(this.pagesDir(), { recursive: true });
@@ -2768,6 +2961,16 @@ const IMAGE_PRESETS = [
 			}
 		]
 	},
+	{
+		id: "minimax-official",
+		name: "MiniMax 官方（国际站）",
+		apiUrl: "https://api.minimax.io/v1",
+		hint: "MiniMax 原生 /image_generation 接口：image-01（国内站请把地址改为 https://api.minimaxi.com/v1；/models 不列出图片模型，请直接使用预填目录）",
+		models: [{
+			alias: "image-01",
+			id: "image-01"
+		}]
+	},
 	{
 		id: "xai-grok",
 		name: "xAI（Grok）",
@@ -2861,6 +3064,7 @@ function parseGenerateRequest(body) {
 		n: typeof body.n === "number" ? body.n : 1,
 		detail: typeof body.detail === "string" ? body.detail : "",
 		...typeof body.image === "string" && body.image !== "" ? { image: body.image } : {},
+		...Array.isArray(body.images) ? { images: body.images.filter((item) => typeof item === "string" && item !== "").slice(0, 4) } : {},
 		...typeof body.refName === "string" && body.refName !== "" ? { refName: body.refName } : {},
 		...typeof body.channelId === "string" && body.channelId !== "" ? { channelId: body.channelId } : {},
 		...typeof body.comparisonId === "string" && body.comparisonId !== "" ? { comparisonId: body.comparisonId } : {},
@@ -4976,6 +5180,7 @@ const Config = z.object({
 	promptApiUrl: z.string().default(""),
 	promptApiKey: z.string().role("secret").default(""),
 	promptModel: z.string().default(""),
+	localStoragePath: z.string().default(""),
 	storageEnabled: z.boolean().default(false),
 	storageEndpoint: z.string().default(""),
 	storageRegion: z.string().default(""),
@@ -4995,7 +5200,7 @@ const DEFAULT_ALLOW_AGENT_IMAGE_GENERATION = true;
 /** Order of the announcement section within the tool-guidance band. */
 const SECTION_ORDER = 150;
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-const IMAGEGEN_GUIDANCE = "本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：通过「渠道」对接 OpenAI 兼容图像生成 API（每个渠道 = 一个 API 端点 + 各自的模型目录），支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送，nanobanana 系列按 aspect_ratio / image_size 参数协议发送；seedream 系列统一走 /images/generations，参考图以 JSON image 数组发送；智谱 `glm-image` 使用官方 `/api/paas/v4/images/generations`，当前仅支持文生图；qwen-image 系列使用阿里云 DashScope 原生接口（api_url 填 https://dashscope.aliyuncs.com/api/v1，不支持 OpenAI 兼容模式，该渠道不可复用于提示词增强，尺寸自动映射为宽*高）。API 地址与密钥在 GUI 设置中按渠道配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用用户在各渠道配置目录中的模型；检测模型时会过滤聊天、Embedding 等非图片模型，但模型出现在 /models 中仍不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：多来源标签页（精选案例库 / 沧河案例库，后续可扩展），打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选、收藏（星标，宿主持久化）与复用；各来源列表独立刷新，宿主每 12 小时后台自动同步一次。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片显示在工具调用对应的左侧结果区域，模型收到状态和附件引用，不会额外伪造用户消息。用户也可以使用 `/edit_image <修改描述>`，命令会直接读取当前对话最近图片并调用插件图片模型，不经过对话模型的图片能力检查。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问对应来源站点（vibeui.top / gpt-image2.canghe.ai）。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。";
+const IMAGEGEN_GUIDANCE = "本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：通过「渠道」对接 OpenAI 兼容图像生成 API（每个渠道 = 一个 API 端点 + 各自的模型目录），支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送，nanobanana 系列按 aspect_ratio / image_size 参数协议发送；seedream 系列统一走 /images/generations，参考图以 JSON image 数组发送；智谱 `glm-image` 使用官方 `/api/paas/v4/images/generations`，当前仅支持文生图；qwen-image 系列使用阿里云 DashScope 原生接口（api_url 填 https://dashscope.aliyuncs.com/api/v1，不支持 OpenAI 兼容模式，该渠道不可复用于提示词增强，尺寸自动映射为宽*高）。MiniMax `image-01` 使用 MiniMax 原生 `/image_generation` 接口（api_url 填 https://api.minimax.io/v1 或国内站 https://api.minimaxi.com/v1，支持 1:1/16:9/4:3/3:2/2:3/3:4/9:16/21:9 宽高比，一次最多 9 张；图生图为单张 subject_reference 主体参考（保持人物/主体一致，非像素级局部编辑）；其 /models 只列聊天模型，图片模型需用预设目录）。API 地址与密钥在 GUI 设置中按渠道配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用用户在各渠道配置目录中的模型；检测模型时会过滤聊天、Embedding 等非图片模型，但模型出现在 /models 中仍不等于其网关原生支持生图协议，遇到 Qwen、MiniMax、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：多来源标签页（精选案例库 / 沧河案例库，后续可扩展），打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选、收藏（星标，宿主持久化）与复用；各来源列表独立刷新，宿主每 12 小时后台自动同步一次。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片显示在工具调用对应的左侧结果区域，模型收到状态和附件引用，不会额外伪造用户消息。用户也可以使用 `/edit_image <修改描述>`，命令会直接读取当前对话最近图片并调用插件图片模型，不经过对话模型的图片能力检查。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问对应来源站点（vibeui.top / gpt-image2.canghe.ai）。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。";
 /** Append the live channel × model table so an Agent can honor user choices. */
 function guidanceFor(channels, defaultChannelId) {
 	if (channels.length === 0) return `${IMAGEGEN_GUIDANCE} 尚未配置任何渠道：请先在「设置 → 插件 → AI 生图」添加渠道并填写 API 地址与密钥。`;
@@ -5048,6 +5253,7 @@ function apply(ctx, config) {
 	let current = () => config ?? {};
 	const resolve = () => {
 		const value = current() ?? {};
+		setImageDataRoot(value.localStoragePath);
 		let channels = normalizeChannels(value.channels);
 		const secrets = { ...value.channelSecrets ?? {} };
 		if (channels.length === 0) {
@@ -5217,4 +5423,4 @@ function apply(ctx, config) {
 	};
 }
 //#endregion
-export { CURRENT_VERSION, Config, IMAGEGEN_GUIDANCE, ImageGenError, ImageGenSettingsNamespace, ImageGenerationRuntime, addTemplateFavorite, appendGallery, apply, checkForUpdate, clearGallery, clearTemplateFavoritesMemo, clearTemplateMemo, clearUpdateCache, compareVersions, generateImage, inject, installUpdate, latestSessionImage, listGallery, listTemplateFavorites, listTemplates, makeRoutes, name, profileFromProcess, putObject, readGalleryImage, readTemplateImage, refreshTemplates, registerAgentImageTools, registerEditImageCommand, removeGallery, removeTemplateFavorite, sampleTemplates, setStorageSyncHandler, syncAllTemplates, testStorage, updateGalleryTags };
+export { CURRENT_VERSION, Config, IMAGEGEN_GUIDANCE, ImageGenError, ImageGenSettingsNamespace, ImageGenerationRuntime, addTemplateFavorite, appendGallery, apply, checkForUpdate, clearGallery, clearTemplateFavoritesMemo, clearTemplateMemo, clearUpdateCache, compareVersions, generateImage, inject, installUpdate, latestSessionImage, listGallery, listTemplateFavorites, listTemplates, makeRoutes, name, profileFromProcess, promptCharLimit, putObject, readGalleryImage, readTemplateImage, refreshTemplates, registerAgentImageTools, registerEditImageCommand, removeGallery, removeTemplateFavorite, sampleTemplates, setStorageSyncHandler, syncAllTemplates, testStorage, updateGalleryTags };