@dickpy/dsh-imagegen 1.2.2 → 1.3.0

package/lib/index.js

@@ -16,7 +16,7 @@ import { defineTool } from "@deepseek-ai/dsh-tools";
 /** 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.2.2";
+const PLUGIN_VERSION = "1.3.0";
 /** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
 const SETTINGS_API = {
 	describe: "/api/dsh-imagegen/settings/describe",
@@ -31,6 +31,16 @@ const PROMPT_ENHANCE_API = {
 };
 /** Host-mediated candidate discovery for the configured image API. */
 const IMAGE_MODEL_API = { models: "/api/dsh-imagegen/image-models" };
+/** Host-served built-in provider catalog (channels the user can instantiate). */
+const PRESETS_API = "/api/dsh-imagegen/presets";
+/** Loopback-only image reader for Agent tool-result previews. */
+const AGENT_IMAGE_API = "/api/dsh-imagegen/agent-image";
+/**
+* Host-computed per-channel usage counters (generation-count badges in the
+* settings card): entries are tallied from the persisted history and gallery
+* by channel + model alias.
+*/
+const USAGE_API = "/api/dsh-imagegen/usage";
 /** Host-resident generation queue endpoints. */
 const TASK_API = {
 	submit: "/api/dsh-imagegen/tasks/submit",
@@ -140,7 +150,14 @@ async function enhancePrompt(config, prompt) {
 * `/models` exposes candidates only: the configured list is the explicit
 * allow-list because OpenAI-compatible gateways rarely advertise modalities.
 */
-const DEFAULT_IMAGE_MODELS = ["gpt-image-2", "grok-imagine-image"];
+const DEFAULT_IMAGE_MODELS = [
+	"gpt-image-2",
+	"grok-imagine-image",
+	"nanobanana2",
+	"nanobanana2-lite",
+	"nanobanana-pro",
+	"seedream-5.0-pro"
+];
 /** Normalize user-entered model identifiers and retain a usable legacy default. */
 function normalizeImageModels(value) {
 	const candidates = Array.isArray(value) ? value : [];
@@ -153,6 +170,113 @@ function normalizeImageModels(value) {
 	return unique.size > 0 ? [...unique] : [...DEFAULT_IMAGE_MODELS];
 }
 //#endregion
+//#region src/image-format.ts
+function detectImageMime(data) {
+	const startsWith = (...bytes) => bytes.every((value, index) => data[index] === value);
+	if (startsWith(137, 80, 78, 71, 13, 10, 26, 10)) return "image/png";
+	if (startsWith(255, 216, 255)) return "image/jpeg";
+	if (startsWith(71, 73, 70, 56, 55, 97) || startsWith(71, 73, 70, 56, 57, 97)) return "image/gif";
+	if (startsWith(82, 73, 70, 70) && data[8] === 87 && data[9] === 69 && data[10] === 66 && data[11] === 80) return "image/webp";
+}
+//#endregion
+//#region src/model-catalog.ts
+const ENTRIES = {
+	"gpt-image": {
+		label: "gpt-image",
+		labelZh: "GPT 图像",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: false,
+		qualityTiers: [
+			"1K",
+			"2K",
+			"4K"
+		]
+	},
+	"dall-e": {
+		label: "DALL·E",
+		labelZh: "DALL·E",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: false,
+		qualityTiers: ["auto"]
+	},
+	grok: {
+		label: "grok",
+		labelZh: "Grok",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: ["1K", "2K"]
+	},
+	nanobanana: {
+		label: "nanobanana",
+		labelZh: "Nano Banana",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: [
+			"1K",
+			"2K",
+			"4K"
+		]
+	},
+	seedream: {
+		label: "seedream",
+		labelZh: "Seedream",
+		known: true,
+		supportsEdit: true,
+		supportsAspectRatio: true,
+		qualityTiers: ["1K", "2K"]
+	}
+};
+/** Official Gemini image ids served by Nano Banana gateways. */
+const NANOBANANA_GEMINI_IDS = /* @__PURE__ */ new Set([
+	"gemini-3-pro-image",
+	"gemini-3-pro-image-preview",
+	"gemini-3.1-flash-image",
+	"gemini-3.1-flash-image-preview",
+	"gemini-3.1-flash-lite-image",
+	"gemini-2.5-flash-image"
+]);
+/** Classify one upstream model id into its request-shaping family. */
+function describeModel(model) {
+	const id = model.trim();
+	if (/^gpt-image/i.test(id)) return {
+		family: "gpt-image",
+		...ENTRIES["gpt-image"]
+	};
+	if (/^dall-e/i.test(id)) return {
+		family: "dall-e",
+		...ENTRIES["dall-e"]
+	};
+	if (/^grok-imagine(?:-|$)/.test(id)) return {
+		family: "grok",
+		...ENTRIES.grok
+	};
+	if (/^nanobanana/i.test(id) || NANOBANANA_GEMINI_IDS.has(id)) return {
+		family: "nanobanana",
+		...ENTRIES.nanobanana
+	};
+	if (/^(?:doubao-)?seedream/i.test(id)) return {
+		family: "seedream",
+		...ENTRIES.seedream
+	};
+	return {
+		family: "unknown",
+		label: "unknown",
+		labelZh: "未知协议",
+		known: false,
+		supportsEdit: true,
+		supportsAspectRatio: false,
+		qualityTiers: []
+	};
+}
+/** The family a model id routes its request through. */
+function modelFamily(model) {
+	return describeModel(model).family;
+}
+//#endregion
 //#region src/engine.ts
 /** A generation failure with a user-presentable message. */
 var ImageGenError = class extends Error {
@@ -176,12 +300,45 @@ const DALLE3_SIZES = /* @__PURE__ */ new Set([
 	"1792x1024",
 	"1024x1792"
 ]);
+/** The wire model id for a request: `upstream` (host-filled alias mapping)
+*  wins, then the alias, then the family default. */
+function wireModel(request) {
+	const upstream = request.upstream?.trim();
+	if (upstream !== void 0 && upstream !== "") return upstream;
+	const alias = request.model.trim();
+	return alias === "" ? "gpt-image-2" : alias;
+}
 /** Whether the model is an xAI Grok Imagine model (grok-imagine-image,
 *  grok-imagine-image-2.0, …). Grok Imagine speaks JSON on both endpoints
 *  and exposes its own aspect-ratio / response-format knobs instead of the
 *  OpenAI size/quality/detail passthrough. */
 function isGrokImagine(model) {
-	return /^grok-imagine(?:-|$)/.test(model);
+	return modelFamily(model) === "grok";
+}
+/** Whether the model belongs to the Google Nano Banana family (nanobanana2 /
+*  nanobanana2-lite / nanobanana-pro, plus the official Gemini image IDs the
+*  gateways expose). OpenAI-compatible gateways serve these with their own
+*  aspect_ratio / image_size vocabulary instead of the OpenAI size/quality
+*  passthrough. */
+function isNanoBanana(model) {
+	return modelFamily(model) === "nanobanana";
+}
+/** Whether the model belongs to the ByteDance Seedream family (seedream-5.0-pro,
+*  seedream-5.0, seedream-4.x, doubao-seedream-…). OpenAI-compatible gateways
+*  serve Seedream through a unified generate-and-edit architecture:
+*  generation AND editing both go to /images/generations and reference images
+*  are a JSON URL / data-URL array. */
+function isSeedream(model) {
+	return modelFamily(model) === "seedream";
+}
+/** Whether this is the official Volcengine Ark model naming convention. */
+function isVolcSeedream(model) {
+	return /^doubao-seedream(?:-|$)/i.test(model.trim());
+}
+/** Volcengine uses `size` for the output tier, not the panel's aspect ratio. */
+function seedreamSize(quality) {
+	if (quality === "1k") return "1K";
+	return "2K";
 }
 /** The panel's aspect ratios mapped to the closest OpenAI pixel size
 *  (gpt-image-2 / generic OpenAI-compatible endpoints). */
@@ -259,7 +416,7 @@ function clampCount(n) {
 *  batch parameter is rejected by Responses-API-based gateways (tools[0].n),
 *  so the count is satisfied by parallel single-image requests instead. */
 function effectiveParams(request) {
-	const model = request.model.trim() === "" ? "gpt-image-2" : request.model.trim();
+	const model = wireModel(request);
 	if (model === "dall-e-3") {
 		const pixel = OPENAI_SIZE_BY_RATIO[request.size];
 		return {
@@ -273,6 +430,17 @@ function effectiveParams(request) {
 		...request.quality !== "" && request.quality !== "auto" ? { resolution: request.quality === "4k" ? "2k" : request.quality } : {},
 		response_format: "b64_json"
 	};
+	if (isNanoBanana(model)) return {
+		model,
+		...request.size !== "" && request.size !== "auto" ? { aspect_ratio: request.size } : {},
+		...request.quality !== "" && request.quality !== "auto" ? { image_size: request.quality.toUpperCase() } : {},
+		response_format: "b64_json"
+	};
+	if (isSeedream(model)) return {
+		model,
+		size: seedreamSize(request.quality),
+		response_format: isVolcSeedream(model) ? "url" : "b64_json"
+	};
 	return {
 		model,
 		...request.size !== "" && request.size !== "auto" && OPENAI_SIZE_BY_RATIO[request.size] !== void 0 ? { size: OPENAI_SIZE_BY_RATIO[request.size] } : {},
@@ -284,17 +452,20 @@ function effectiveParams(request) {
 }
 /** How many single-image requests to issue for the requested image count. */
 function effectiveCount(request) {
-	if ((request.model.trim() === "" ? "gpt-image-2" : request.model.trim()) === "dall-e-3") return 1;
+	if (wireModel(request) === "dall-e-3") return 1;
 	return clampCount(request.n);
 }
 /** Normalize one upstream data item into a base64 image. */
 async function normalizeItem(item, upstream) {
 	const revisedPrompt = typeof item.revised_prompt === "string" ? item.revised_prompt : void 0;
-	if (typeof item.b64_json === "string") return {
-		b64: bareBase64(item.b64_json),
-		mime: "image/png",
-		revisedPrompt
-	};
+	if (typeof item.b64_json === "string") {
+		const b64 = bareBase64(item.b64_json);
+		return {
+			b64,
+			mime: detectImageMime(Buffer.from(b64, "base64")) ?? "image/png",
+			revisedPrompt
+		};
+	}
 	if (typeof item.url !== "string" || item.url === "") throw new ImageGenError("upstream image item has neither b64_json nor url");
 	const url = item.url;
 	if (url.startsWith("data:")) {
@@ -302,7 +473,7 @@ async function normalizeItem(item, upstream) {
 		if (parsed === void 0) throw new ImageGenError("upstream returned a malformed data: url");
 		return {
 			b64: parsed.base64,
-			mime: parsed.mime,
+			mime: detectImageMime(Buffer.from(parsed.base64, "base64")) ?? parsed.mime,
 			revisedPrompt
 		};
 	}
@@ -321,7 +492,7 @@ async function normalizeItem(item, upstream) {
 	if (!response.ok) throw new ImageGenError(`failed to fetch the generated image url: HTTP ${response.status}`);
 	const buffer = Buffer.from(await response.arrayBuffer());
 	const contentType = response.headers.get("content-type");
-	const mime = contentType !== null && contentType !== "" ? contentType.split(";")[0].trim() : mimeOfExtension(url) ?? "image/png";
+	const mime = detectImageMime(buffer) ?? (contentType !== null && contentType !== "" ? contentType.split(";")[0].trim() : mimeOfExtension(url) ?? "image/png");
 	return {
 		b64: buffer.toString("base64"),
 		mime,
@@ -358,6 +529,24 @@ async function requestOneImage(baseUrl, upstream, request, params, signal) {
 				...params.aspect_ratio !== void 0 ? { aspect_ratio: params.aspect_ratio } : {},
 				response_format: "b64_json"
 			});
+		} else if (isNanoBanana(params.model)) {
+			const form = new FormData();
+			form.append("image", new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf$2(parsed.mime)}`);
+			form.append("prompt", request.prompt);
+			form.append("model", params.model);
+			if (params.aspect_ratio !== void 0) form.append("aspect_ratio", params.aspect_ratio);
+			if (params.image_size !== void 0) form.append("image_size", params.image_size);
+			body = form;
+		} else if (isSeedream(params.model)) {
+			headers["content-type"] = "application/json";
+			body = JSON.stringify({
+				model: params.model,
+				prompt: request.prompt,
+				image: [request.image],
+				...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$2(parsed.mime)}`);
@@ -378,7 +567,8 @@ async function requestOneImage(baseUrl, upstream, request, params, signal) {
 	const budget = requestSignal(signal, UPSTREAM_TIMEOUT_MS);
 	let response;
 	try {
-		response = await fetch(`${baseUrl}/images/${request.mode === "edit" ? "edits" : "generations"}`, {
+		const endpoint = request.mode === "edit" && !isSeedream(params.model) ? "/images/edits" : "/images/generations";
+		response = await fetch(`${baseUrl}${endpoint}`, {
 			method: "POST",
 			headers,
 			body,
@@ -546,7 +736,9 @@ function toWire$1(entry) {
 			mime: image.mime,
 			...image.revisedPrompt === void 0 ? {} : { revisedPrompt: image.revisedPrompt }
 		})),
-		...entry.refName === void 0 ? {} : { refName: entry.refName }
+		...entry.refName === void 0 ? {} : { refName: entry.refName },
+		...entry.channel === void 0 ? {} : { channel: entry.channel },
+		...entry.channelId === void 0 ? {} : { channelId: entry.channelId }
 	};
 }
 /** List the persisted history, newest first, as wire entries. */
@@ -585,7 +777,9 @@ async function appendHistory(input) {
 			detail: input.detail,
 			n: input.n,
 			images: storedImages,
-			...input.refName === void 0 ? {} : { refName: input.refName }
+			...input.refName === void 0 ? {} : { refName: input.refName },
+			...input.channelId === void 0 ? {} : { channelId: input.channelId },
+			...input.channel === void 0 ? {} : { channel: input.channel }
 		}, ...await readIndex$1()];
 		const kept = merged.slice(0, 50);
 		for (const dropped of merged.slice(50)) await removeEntryFiles$1(dropped);
@@ -727,6 +921,11 @@ var GenerationTaskQueue = class {
 * Shared host-side generation runtime. Both the browser routes and Agent tools
 * submit to this one queue so persisted history and cancellation semantics stay
 * identical regardless of where a request originated.
+*
+* Requests carry a channel id (host-filled by the route/tool resolution); the
+* runtime picks that channel's upstream credentials, otherwise the default
+* channel, and records a channel snapshot on the history entry so usage
+* counters and filters survive channel deletion.
 */
 var ImageGenerationRuntime = class {
 	resolve;
@@ -738,7 +937,13 @@ var ImageGenerationRuntime = class {
 		this.queue = new GenerationTaskQueue((request, signal) => this.run(request, signal));
 	}
 	async run(request, signal) {
-		const result = await generateImage(this.resolve(), request, { signal });
+		const view = this.resolve();
+		const channel = view.channels.find((candidate) => candidate.id === request.channelId) ?? view.channels.find((candidate) => candidate.id === view.defaultChannelId) ?? view.channels[0];
+		if (channel === void 0) throw new ImageGenError("尚未配置任何渠道：请先在「设置 → 插件 → AI 生图」添加渠道并填写 API 地址与密钥", "no-channels");
+		const result = await generateImage({
+			apiUrl: channel.apiUrl,
+			apiKey: channel.apiKey
+		}, request, { signal });
 		try {
 			const history = await this.history.append({
 				id: randomUUID(),
@@ -751,7 +956,9 @@ var ImageGenerationRuntime = class {
 				detail: request.detail,
 				n: request.n,
 				images: result.images,
-				...request.refName === void 0 ? {} : { refName: request.refName }
+				...request.refName === void 0 ? {} : { refName: request.refName },
+				...request.channelId === void 0 ? {} : { channelId: request.channelId },
+				...request.channel === void 0 ? {} : { channel: request.channel }
 			});
 			return {
 				...result,
@@ -875,7 +1082,9 @@ function toWire(entry) {
 			...image.revisedPrompt === void 0 ? {} : { revisedPrompt: image.revisedPrompt }
 		})),
 		...entry.refName === void 0 ? {} : { refName: entry.refName },
-		...entry.tags === void 0 ? {} : { tags: entry.tags }
+		...entry.tags === void 0 ? {} : { tags: entry.tags },
+		...entry.channel === void 0 ? {} : { channel: entry.channel },
+		...entry.channelId === void 0 ? {} : { channelId: entry.channelId }
 	};
 }
 /** List the persisted gallery, newest first, as wire entries. */
@@ -925,7 +1134,9 @@ async function appendGallery(input) {
 			n: input.n,
 			images: storedImages,
 			...hash === void 0 ? {} : { hash },
-			...input.refName === void 0 ? {} : { refName: input.refName }
+			...input.refName === void 0 ? {} : { refName: input.refName },
+			...input.channelId === void 0 ? {} : { channelId: input.channelId },
+			...input.channel === void 0 ? {} : { channel: input.channel }
 		}, ...await readIndex()];
 		await writeIndex(merged);
 		return {
@@ -1347,6 +1558,57 @@ function clearUpdateCache() {
 	cached = void 0;
 }
 //#endregion
+//#region src/presets.ts
+const IMAGE_PRESETS = [
+	{
+		id: "volc-ark-seedream",
+		name: "字节 · 火山方舟（Seedream）",
+		apiUrl: "https://ark.cn-beijing.volces.com/api/v3",
+		hint: "字节跳动官方 Seedream 文生图/图生图入口",
+		models: [
+			{
+				alias: "seedream-5.0-pro",
+				id: "seedream-5.0-pro"
+			},
+			{
+				alias: "seedream-5.0",
+				id: "seedream-5.0"
+			},
+			{
+				alias: "seedream-4.0",
+				id: "seedream-4.0"
+			}
+		]
+	},
+	{
+		id: "openai-official",
+		name: "OpenAI 官方",
+		apiUrl: "https://api.openai.com/v1",
+		hint: "OpenAI 官方接口：gpt-image-2 / dall-e-3",
+		models: [{
+			alias: "gpt-image-2",
+			id: "gpt-image-2"
+		}, {
+			alias: "dall-e-3",
+			id: "dall-e-3"
+		}]
+	},
+	{
+		id: "xai-grok",
+		name: "xAI（Grok）",
+		apiUrl: "https://api.x.ai/v1",
+		hint: "xAI 官方接口：Grok Imagine 系列",
+		models: [{
+			alias: "grok-imagine-image",
+			id: "grok-imagine-image"
+		}]
+	}
+];
+/** Look up one built-in provider by id. */
+function presetById(id) {
+	return IMAGE_PRESETS.find((preset) => preset.id === id);
+}
+//#endregion
 //#region src/routes.ts
 /** Cap on JSON request bodies (settings ops and generate payloads are small). */
 const MAX_JSON_BODY_BYTES = 24 * 1024 * 1024;
@@ -1416,7 +1678,8 @@ 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 } : {},
-		...typeof body.refName === "string" && body.refName !== "" ? { refName: body.refName } : {}
+		...typeof body.refName === "string" && body.refName !== "" ? { refName: body.refName } : {},
+		...typeof body.channelId === "string" && body.channelId !== "" ? { channelId: body.channelId } : {}
 	};
 }
 /** Validate a submitted history entry (images carry base64). */
@@ -1452,7 +1715,9 @@ function parseHistoryEntryInput(body) {
 		detail: entry.detail,
 		n: entry.n,
 		images,
-		...typeof entry.refName === "string" ? { refName: entry.refName } : {}
+		...typeof entry.refName === "string" ? { refName: entry.refName } : {},
+		...typeof entry.channelId === "string" ? { channelId: entry.channelId } : {},
+		...typeof entry.channel === "string" ? { channel: entry.channel } : {}
 	};
 }
 /** Extract the image file name from a history-image request URL. */
@@ -1467,6 +1732,33 @@ function imageFileFrom(rawUrl, basePath) {
 	if (!pathname.startsWith(`${basePath}/`)) return void 0;
 	return decodeURIComponent(pathname.slice(basePath.length + 1));
 }
+/** Parse the durable image reference carried by an Agent tool-result view. */
+function agentImageRefFrom(rawUrl) {
+	if (rawUrl === void 0) return void 0;
+	let url;
+	try {
+		url = new URL(rawUrl, "http://localhost");
+	} catch {
+		return;
+	}
+	if (url.pathname !== "/api/dsh-imagegen/agent-image") return void 0;
+	const attachmentId = url.searchParams.get("attachment_id") ?? "";
+	const mediaType = url.searchParams.get("media_type") ?? "";
+	const bytes = Number(url.searchParams.get("bytes"));
+	const width = Number(url.searchParams.get("width"));
+	const height = Number(url.searchParams.get("height"));
+	if (attachmentId === "" || !isImageMediaType(mediaType) || !Number.isSafeInteger(bytes) || bytes < 1 || !Number.isSafeInteger(width) || width < 1 || !Number.isSafeInteger(height) || height < 1) return void 0;
+	return {
+		attachmentId,
+		mediaType,
+		bytes,
+		width,
+		height
+	};
+}
+function isImageMediaType(value) {
+	return value === "image/png" || value === "image/jpeg" || value === "image/webp" || value === "image/gif";
+}
 /** Project one settings descriptor onto the bridge wire view. */
 function toView(descriptor) {
 	return {
@@ -1527,18 +1819,85 @@ function makeRoutes(deps) {
 		model: ""
 	}));
 	const resolveImageModels = deps.resolveImageModels ?? (() => normalizeImageModels(void 0));
-	const parseConfiguredRequest = (body) => {
-		const request = parseGenerateRequest(body);
-		if (request === void 0) return void 0;
-		const models = normalizeImageModels(resolveImageModels());
-		const model = request.model.trim() === "" ? models[0] : request.model.trim();
-		if (!models.includes(model)) throw new Error(`image model "${model}" is not configured; choose one of: ${models.join(", ")}`);
+	/** The current channel view: the channel-aware resolver, or a synthesized
+	*  single default channel from the legacy flat upstream config (tests and
+	*  older hosts). */
+	const channelViewOf = () => {
+		if (deps.resolveChannels !== void 0) return deps.resolveChannels();
+		const upstream = deps.resolve();
+		const models = normalizeImageModels(resolveImageModels()).map((id) => ({
+			alias: id,
+			id
+		}));
+		if (upstream.apiUrl.trim() === "" && models.length === 0) return {
+			channels: [],
+			defaultChannelId: ""
+		};
 		return {
-			...request,
-			model
+			channels: [{
+				id: "default",
+				preset: "",
+				name: "默认渠道",
+				apiUrl: upstream.apiUrl,
+				apiKey: upstream.apiKey,
+				models
+			}],
+			defaultChannelId: "default"
+		};
+	};
+	const runtime = deps.runtime ?? new ImageGenerationRuntime(channelViewOf, history);
+	/** Resolve an alias (or the channel fallback) into a concrete generation
+	*  request: picks the channel (explicit then default), maps alias → upstream
+	*  id, and fills the channel snapshot kept on history entries. */
+	const resolveChannelRequest = (request) => {
+		const view = channelViewOf();
+		if (view.channels.length === 0) return {
+			ok: false,
+			code: "no-channels",
+			message: "尚未配置任何渠道：请先在「设置 → 插件 → AI 生图」添加渠道并填写 API 地址与密钥"
+		};
+		const explicit = view.channels.find((candidate) => candidate.id === request.channelId);
+		const defaults = view.channels.find((candidate) => candidate.id === view.defaultChannelId) ?? view.channels[0];
+		const target = explicit ?? defaults;
+		const asked = request.model.trim();
+		if (asked === "") {
+			const alias = target?.models[0]?.alias ?? "";
+			if (alias === "") return {
+				ok: false,
+				code: "no-models",
+				message: `渠道「${target?.name ?? ""}」尚未配置模型，请先在设置中添加`
+			};
+			const mapping = target.models.find((model) => model.alias === alias);
+			return {
+				ok: true,
+				request: {
+					...request,
+					model: alias,
+					upstream: mapping.id,
+					channelId: target.id,
+					channel: target.name
+				}
+			};
+		}
+		const hosting = view.channels.filter((channel) => channel.models.some((model) => model.alias === asked));
+		if (hosting.length === 0) return {
+			ok: false,
+			code: "image-model-not-configured",
+			message: `模型「${asked}」未在任一渠道配置；可用模型：${[...new Set(view.channels.flatMap((channel) => channel.models.map((model) => model.alias)))].join("、") || "（无）"}`
+		};
+		const picked = target !== void 0 && target.models.some((model) => model.alias === asked) ? target : hosting[0];
+		const mapping = picked.models.find((model) => model.alias === asked);
+		return {
+			ok: true,
+			request: {
+				...request,
+				model: asked,
+				upstream: mapping.id,
+				channelId: picked.id,
+				channel: picked.name
+			}
 		};
 	};
-	const runtime = deps.runtime ?? new ImageGenerationRuntime(deps.resolve, history);
 	const guard = (req, res, method) => {
 		if (!isLoopbackRequest(req)) {
 			writeJson(res, 403, { error: "forbidden: loopback-only" });
@@ -1551,15 +1910,52 @@ function makeRoutes(deps) {
 		return true;
 	};
 	return [
+		...deps.attachments === void 0 ? [] : [{
+			kind: "prefix",
+			path: AGENT_IMAGE_API,
+			handler: async (req, res) => {
+				if (!isLoopbackRequest(req)) {
+					writeJson(res, 403, { error: "forbidden: loopback-only" });
+					return;
+				}
+				if (req.method !== "GET") {
+					writeJson(res, 405, { error: `method not allowed: ${req.method}` });
+					return;
+				}
+				const ref = agentImageRefFrom(req.url);
+				if (ref === void 0) {
+					writeJson(res, 400, { error: "invalid image reference" });
+					return;
+				}
+				try {
+					const stored = await deps.attachments.readImage(ref);
+					res.writeHead(200, {
+						"content-type": stored.ref.mediaType,
+						"content-length": stored.data.byteLength,
+						"cache-control": "private, max-age=3600"
+					});
+					res.end(Buffer.from(stored.data));
+				} catch {
+					writeJson(res, 404, { error: "image attachment not found" });
+				}
+			}
+		}],
 		{
 			kind: "exact",
 			path: IMAGE_MODEL_API.models,
 			handler: async (req, res) => {
 				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const view = channelViewOf();
+				const stored = view.channels.find((candidate) => candidate.id === (typeof body?.channelId === "string" ? body.channelId : void 0)) ?? view.channels.find((candidate) => candidate.id === view.defaultChannelId) ?? view.channels[0];
+				const upstream = {
+					apiUrl: typeof body?.apiUrl === "string" && body.apiUrl.trim() !== "" ? body.apiUrl.trim() : stored?.apiUrl ?? "",
+					apiKey: typeof body?.apiKey === "string" && body.apiKey.trim() !== "" ? body.apiKey.trim() : stored?.apiKey ?? ""
+				};
 				try {
 					writeJson(res, 200, {
 						ok: true,
-						models: await listOpenAIModels(deps.resolve())
+						models: await listOpenAIModels(upstream)
 					});
 				} catch (error) {
 					writeJson(res, 200, {
@@ -1570,6 +1966,55 @@ function makeRoutes(deps) {
 				}
 			}
 		},
+		{
+			kind: "exact",
+			path: PRESETS_API,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				writeJson(res, 200, {
+					ok: true,
+					presets: IMAGE_PRESETS.map((preset) => ({
+						id: preset.id,
+						name: preset.name,
+						apiUrl: preset.apiUrl,
+						hint: preset.hint,
+						models: preset.models
+					}))
+				});
+			}
+		},
+		{
+			kind: "exact",
+			path: USAGE_API,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				try {
+					const entries = [...await history.list(), ...await gallery.list()];
+					const byChannel = {};
+					const totals = {};
+					for (const entry of entries) {
+						const channelKey = entry.channelId !== void 0 ? entry.channelId : entry.channel !== void 0 ? `name:${entry.channel}` : "";
+						const alias = entry.model;
+						const bucket = byChannel[channelKey] ?? (byChannel[channelKey] = {});
+						bucket[alias] = (bucket[alias] ?? 0) + 1;
+						totals[alias] = (totals[alias] ?? 0) + 1;
+					}
+					writeJson(res, 200, {
+						ok: true,
+						usage: {
+							byChannel,
+							totals
+						}
+					});
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "usage-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		},
 		{
 			kind: "exact",
 			path: PROMPT_ENHANCE_API.models,
@@ -1684,37 +2129,28 @@ function makeRoutes(deps) {
 			handler: async (req, res) => {
 				if (!guard(req, res, "POST")) return;
 				const body = await readJsonBody(req);
-				if (body === void 0) {
+				const parsed = body === void 0 ? void 0 : parseGenerateRequest(body);
+				if (parsed === void 0) {
 					writeJson(res, 200, {
 						ok: false,
 						code: "bad-request",
-						message: "unreadable JSON body"
-					});
-					return;
-				}
-				let request;
-				try {
-					request = parseConfiguredRequest(body);
-				} catch (error) {
-					writeJson(res, 200, {
-						ok: false,
-						code: "image-model-not-configured",
-						message: messageOf(error)
+						message: "prompt is required"
 					});
 					return;
 				}
-				if (request === void 0) {
+				const resolved = resolveChannelRequest(parsed);
+				if (!resolved.ok) {
 					writeJson(res, 200, {
 						ok: false,
-						code: "bad-request",
-						message: "prompt is required"
+						code: resolved.code,
+						message: resolved.message
 					});
 					return;
 				}
 				try {
 					writeJson(res, 200, {
 						ok: true,
-						...await runtime.run(request)
+						...await runtime.run(resolved.request)
 					});
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
@@ -1732,28 +2168,27 @@ function makeRoutes(deps) {
 			handler: async (req, res) => {
 				if (!guard(req, res, "POST")) return;
 				const body = await readJsonBody(req);
-				let request;
-				try {
-					request = body === void 0 ? void 0 : parseConfiguredRequest(body);
-				} catch (error) {
+				const parsed = body === void 0 ? void 0 : parseGenerateRequest(body);
+				if (parsed === void 0) {
 					writeJson(res, 200, {
 						ok: false,
-						code: "image-model-not-configured",
-						message: messageOf(error)
+						code: "bad-request",
+						message: "prompt is required"
 					});
 					return;
 				}
-				if (request === void 0) {
+				const resolved = resolveChannelRequest(parsed);
+				if (!resolved.ok) {
 					writeJson(res, 200, {
 						ok: false,
-						code: "bad-request",
-						message: "prompt is required"
+						code: resolved.code,
+						message: resolved.message
 					});
 					return;
 				}
 				writeJson(res, 200, {
 					ok: true,
-					task: runtime.queue.submit(request)
+					task: runtime.queue.submit(resolved.request)
 				});
 			}
 		},
@@ -2330,10 +2765,54 @@ function renderTaskResult(value) {
 	return [{
 		type: "text",
 		text: JSON.stringify(value)
-	}, ...value.images.map((image) => ({
-		type: "image",
-		attachment: restoreRef(image)
-	}))];
+	}];
+}
+/** The UI-only projection that keeps generated images beside the tool call. */
+function imagePresentationMeta(value) {
+	return { images: value.images.map((image) => {
+		const ref = {
+			attachment_id: image.attachment_id,
+			media_type: image.media_type,
+			bytes: image.bytes,
+			width: image.width,
+			height: image.height
+		};
+		if (image.name !== void 0) ref.name = image.name;
+		return ref;
+	}) };
+}
+function imageBlocksFromMeta(meta) {
+	if (typeof meta !== "object" || meta === null || Array.isArray(meta)) return [];
+	const images = meta.images;
+	if (!Array.isArray(images)) return [];
+	return images.flatMap((value) => {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) return [];
+		const raw = value;
+		if (typeof raw.attachment_id !== "string" || typeof raw.media_type !== "string" || typeof raw.bytes !== "number" || typeof raw.width !== "number" || typeof raw.height !== "number") return [];
+		try {
+			return [{
+				type: "image",
+				attachment: restoreRef({
+					attachment_id: raw.attachment_id,
+					media_type: raw.media_type,
+					bytes: raw.bytes,
+					width: raw.width,
+					height: raw.height,
+					...typeof raw.name === "string" ? { name: raw.name } : {}
+				})
+			}];
+		} catch {
+			return [];
+		}
+	});
+}
+/** Rehydrate image attachments for the host-computed tool result view only. */
+function presentImageResult(_args, result) {
+	const content = result.isError ? [] : imageBlocksFromMeta(result.meta);
+	return content.length === 0 ? void 0 : {
+		card: "generic",
+		content
+	};
 }
 /** Register the global Agent tools and unregister them with the plugin lifecycle. */
 function registerAgentImageTools(ctx, runtime, resolve) {
@@ -2342,13 +2821,32 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 		const config = resolve();
 		if (!config.enabled) throw new ImageGenError("AI image generation is disabled. Open Settings > Plugins > AI Image and enable it.", "plugin-disabled");
 		if (!config.allowAgentImageGeneration) throw new ImageGenError("Agent image generation is disabled in Settings > Plugins > AI Image.", "agent-generation-disabled");
-		if (config.apiUrl.trim() === "" || config.apiKey.trim() === "") throw new ImageGenError("Image API credentials are not configured. Open Settings > Plugins > AI Image and fill in API URL and API key.", "image-api-not-configured");
+		if (!config.channels.some((channel) => channel.apiUrl.trim() !== "" && channel.apiKey.trim() !== "")) throw new ImageGenError("Image API credentials are not configured. Open Settings > Plugins > AI Image, add a channel and fill in its API URL and API key.", "image-api-not-configured");
 	};
-	const selectedModel = (requested) => {
-		const models = normalizeImageModels(resolve().imageModels);
-		const model = typeof requested === "string" && requested.trim() !== "" ? requested.trim() : models[0];
-		if (!models.includes(model)) throw new ImageGenError(`Image model "${model}" is not configured. Choose one of: ${models.join(", ")}.`, "image-model-not-configured");
-		return model;
+	/**
+	* Resolve the requested model alias onto a channel. Rules:
+	*  - a named alias must exist in some channel's catalog (several channels
+	*    may host it; the default channel wins);
+	*  - with no alias, a single configured model is used directly, while
+	*    multiple models require the Agent to ask the user first.
+	* @returns the channel plus the alias and its upstream id.
+	*/
+	const resolveModel = (requested) => {
+		const config = resolve();
+		const entries = config.channels.flatMap((channel) => channel.models.map((model) => ({
+			channel,
+			alias: model.alias,
+			upstream: model.id
+		})));
+		if (entries.length === 0) throw new ImageGenError("No image models are configured. Open Settings > Plugins > AI Image and add a channel with at least one model.", "no-models-configured");
+		const wanted = typeof requested === "string" && requested.trim() !== "" ? requested.trim() : "";
+		if (wanted === "") {
+			if (entries.length === 1) return entries[0];
+			throw new ImageGenError(`Multiple image models are available — ask the user which channel and model to use, then call this tool again with that exact model name. Options: ${config.channels.flatMap((channel) => channel.models.map((model) => `"${channel.name} · ${model.alias}"`)).join(", ")}.`, "model-choice-required");
+		}
+		const hosting = entries.filter((entry) => entry.alias === wanted);
+		if (hosting.length === 0) throw new ImageGenError(`Image model "${wanted}" is not configured in any channel. Choose one of: ${[...new Set(entries.map((entry) => entry.alias))].join(", ")}.`, "image-model-not-configured");
+		return hosting.find((entry) => entry.channel.id === config.defaultChannelId) ?? hosting[0];
 	};
 	const materializeTaskImages = (task) => {
 		if (task.status !== "completed") return Promise.resolve([]);
@@ -2366,7 +2864,7 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 		return {
 			task_id: task.id,
 			status: task.status,
-			message: task.status === "completed" ? "Generation completed. The images are attached below and can be reused as source_image in edit_image." : task.status === "failed" ? "Generation failed." : task.status === "cancelled" ? "Generation was cancelled." : "Generation is still running. Query the task again when you need its current status.",
+			message: task.status === "completed" ? "Generation completed. The images are shown beside this tool call and can be reused as source_image in edit_image." : task.status === "failed" ? "Generation failed." : task.status === "cancelled" ? "Generation was cancelled." : "Generation is still running. Query the task again when you need its current status.",
 			...task.error === void 0 ? {} : { error: task.error },
 			images
 		};
@@ -2435,7 +2933,7 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 	const disposers = [
 		ctx.tools.register(defineTool({
 			name: "generate_image",
-			description: "Generate an image. By default this tool call stays pending until the task reaches a final state, and completed images are returned directly as tool-result attachments without creating a user message. Set wait_for_completion to false for background mode, then use get_image_generation_task explicitly. Only use models configured for this plugin; omit model to use the first configured image model.",
+			description: "Generate an image. By default this tool call stays pending until the task reaches a final state; completed images are shown beside this tool call, while the model receives their attachment references, without creating a user message. Set wait_for_completion to false for background mode, then use get_image_generation_task explicitly. Only use models configured for this plugin; omit model to use the first configured image model.",
 			parameters: {
 				prompt: {
 					type: "string",
@@ -2469,13 +2967,19 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 			},
 			output: {
 				schema: taskResultSchema,
-				render: (_args, value) => renderTaskResult(value)
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
 			},
+			presentResult: presentImageResult,
 			async execute(args, exec) {
 				ensureConfigured();
+				const picked = resolveModel(args.model);
 				const task = runtime.queue.submit({
 					mode: "text",
-					model: selectedModel(args.model),
+					model: picked.alias,
+					upstream: picked.upstream,
+					channelId: picked.channel.id,
+					channel: picked.channel.name,
 					prompt: args.prompt.trim(),
 					size: args.size ?? "auto",
 					quality: args.quality ?? "auto",
@@ -2487,7 +2991,7 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 		})),
 		ctx.tools.register(defineTool({
 			name: "edit_image",
-			description: "Edit an image. By default this tool call stays pending until the task reaches a final state, and completed images are returned directly as tool-result attachments without creating a user message. Set wait_for_completion to false for background mode, then use get_image_generation_task explicitly. source_image must be an image reference returned by a completed generation or get_image_generation_task; pass that entire object unchanged. Only configured image models are allowed; omit model to use the first configured model.",
+			description: "Edit an image. By default this tool call stays pending until the task reaches a final state; completed images are shown beside this tool call, while the model receives their attachment references, without creating a user message. Set wait_for_completion to false for background mode, then use get_image_generation_task explicitly. source_image must be an image reference returned by a completed generation or get_image_generation_task; pass that entire object unchanged. Only configured image models are allowed; omit model to use the first configured model.",
 			parameters: {
 				prompt: {
 					type: "string",
@@ -2526,14 +3030,20 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 			},
 			output: {
 				schema: taskResultSchema,
-				render: (_args, value) => renderTaskResult(value)
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
 			},
+			presentResult: presentImageResult,
 			async execute(args, exec) {
 				ensureConfigured();
 				const reference = await ctx.attachments.readImage(restoreRef(args.source_image), exec.signal);
+				const picked = resolveModel(args.model);
 				const task = runtime.queue.submit({
 					mode: "edit",
-					model: selectedModel(args.model),
+					model: picked.alias,
+					upstream: picked.upstream,
+					channelId: picked.channel.id,
+					channel: picked.channel.name,
 					prompt: args.prompt.trim(),
 					size: args.size ?? "auto",
 					quality: args.quality ?? "auto",
@@ -2547,7 +3057,7 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 		})),
 		ctx.tools.register(defineTool({
 			name: "get_image_generation_task",
-			description: "Check an image-generation task status. Completed tasks return image references and image attachments for edit_image. Generation tools normally wait for completion, so use this for explicit recovery or status checks.",
+			description: "Check an image-generation task status. Completed tasks return image references; their images are shown beside this tool call and the references can be passed to edit_image. Generation tools normally wait for completion, so use this for explicit recovery or status checks.",
 			parameters: { task_id: {
 				type: "string",
 				required: true,
@@ -2555,8 +3065,10 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 			} },
 			output: {
 				schema: taskResultSchema,
-				render: (_args, value) => renderTaskResult(value)
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
 			},
+			presentResult: presentImageResult,
 			async execute(args) {
 				ensureConfigured();
 				return taskResult(findTask(args.task_id));
@@ -2572,8 +3084,10 @@ function registerAgentImageTools(ctx, runtime, resolve) {
 			} },
 			output: {
 				schema: taskResultSchema,
-				render: (_args, value) => renderTaskResult(value)
+				render: (_args, value) => renderTaskResult(value),
+				presentationMeta: (_args, value) => imagePresentationMeta(value)
 			},
+			presentResult: presentImageResult,
 			async execute(args) {
 				ensureConfigured();
 				const task = runtime.queue.cancel(args.task_id);
@@ -2590,9 +3104,11 @@ function isFinalTask(task) {
 	return task.status === "completed" || task.status === "failed" || task.status === "cancelled";
 }
 function toSaveImage(image, taskId, index) {
-	const mediaType = acceptedMediaType(image.mime) ? image.mime : "image/png";
+	const data = Buffer.from(image.b64, "base64");
+	const declaredMediaType = acceptedMediaType(image.mime) ? image.mime : "image/png";
+	const mediaType = detectImageMime(data) ?? declaredMediaType;
 	return {
-		data: Buffer.from(image.b64, "base64"),
+		data,
 		mediaType,
 		name: `imagegen-${taskId}-${index + 1}.${mediaType === "image/jpeg" ? "jpg" : mediaType.slice(6)}`
 	};
@@ -2609,12 +3125,24 @@ const Config = z.object({
 	enabled: z.boolean().default(true),
 	announceToAgent: z.boolean().default(true),
 	allowAgentImageGeneration: z.boolean().default(true),
-	apiUrl: z.string().default(""),
-	apiKey: z.string().role("secret").default(""),
-	imageModels: z.array(z.string()).default([...DEFAULT_IMAGE_MODELS]),
+	channels: z.array(z.object({
+		id: z.string(),
+		preset: z.string().default(""),
+		name: z.string().default(""),
+		apiUrl: z.string().default(""),
+		models: z.array(z.object({
+			alias: z.string(),
+			id: z.string()
+		})).default([])
+	})).default([]),
+	channelSecrets: z.dict(z.string().role("secret")).default({}),
+	defaultChannelId: z.string().default(""),
 	promptApiUrl: z.string().default(""),
 	promptApiKey: z.string().role("secret").default(""),
-	promptModel: z.string().default("")
+	promptModel: z.string().default(""),
+	apiUrl: z.string().default(""),
+	apiKey: z.string().role("secret").default(""),
+	imageModels: z.array(z.string()).default([])
 });
 /** Schema defaults, re-read for hand-built contexts (the loader applies them normally). */
 const DEFAULT_ENABLED = true;
@@ -2623,10 +3151,49 @@ 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，模型由用户在「设置 → 插件 → AI 生图」中检测或手动配置的生图模型列表决定；支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送）。API 地址与密钥在 GUI 设置中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用已配置的生图模型；模型出现在 /models 中不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片直接作为工具结果附件返回，不会额外伪造用户消息。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。";
-/** Add the live allow-list so an Agent can honor a user's model choice. */
-function guidanceFor(imageModels) {
-	return `${IMAGEGEN_GUIDANCE} 当前允许调用的生图模型：${imageModels.join("、")}。用户指定其中某个模型时，工具参数 model 必须使用该精确名称；未指定时使用列表中的第一个。`;
+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 数组发送）。API 地址与密钥在 GUI 设置中按渠道配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用用户在各渠道配置目录中的模型；模型出现在 /models 中不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片显示在工具调用对应的左侧结果区域，模型收到状态和附件引用，不会额外伪造用户消息。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。";
+/** 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 地址与密钥。`;
+	const table = channels.map((channel) => {
+		const aliases = channel.models.map((model) => model.alias).join("、");
+		const mark = channel.id === defaultChannelId ? "（默认渠道）" : "";
+		const key = channel.apiKey === "" ? "（未填密钥）" : "";
+		const models = channel.models.length === 0 ? "未配置模型" : `可用模型：${aliases}`;
+		return `渠道「${channel.name}」${mark}[${channel.apiUrl}] ${models}${key}`;
+	}).join("；");
+	return `${IMAGEGEN_GUIDANCE} 当前渠道与模型：${table}。用户指定模型名时取该模型所属渠道（多渠道同名用默认渠道）；未指定模型时若仅一个可用模型可直接生成，若有多个应先询问用户选择「渠道 + 模型」。`;
+}
+/** Normalize raw channel entries into the wire shape (schema-adjacent guard). */
+function normalizeChannels(value) {
+	if (!Array.isArray(value)) return [];
+	const out = [];
+	for (const item of value) {
+		if (item === null || typeof item !== "object") continue;
+		const raw = item;
+		const id = typeof raw.id === "string" ? raw.id.trim() : "";
+		if (id === "") continue;
+		const models = [];
+		if (Array.isArray(raw.models)) for (const entry of raw.models) {
+			if (entry === null || typeof entry !== "object") continue;
+			const record = entry;
+			const alias = typeof record.alias === "string" ? record.alias.trim() : "";
+			const upstream = typeof record.id === "string" ? record.id.trim() : "";
+			if (alias === "") continue;
+			models.push({
+				alias,
+				id: upstream === "" ? alias : upstream
+			});
+		}
+		out.push({
+			id,
+			preset: typeof raw.preset === "string" ? raw.preset : "",
+			name: typeof raw.name === "string" ? raw.name.trim() : "",
+			apiUrl: typeof raw.apiUrl === "string" ? raw.apiUrl.trim() : "",
+			models
+		});
+	}
+	return out;
 }
 /**
 * Mount the settings section, routes, and announcement.
@@ -2636,47 +3203,82 @@ function guidanceFor(imageModels) {
 function apply(ctx, config) {
 	let current = () => config ?? {};
 	const resolve = () => {
-		const value = current();
+		const value = current() ?? {};
+		let channels = normalizeChannels(value.channels);
+		const secrets = { ...value.channelSecrets ?? {} };
+		if (channels.length === 0) {
+			const legacyUrl = typeof value.apiUrl === "string" ? value.apiUrl.trim() : "";
+			const legacyModels = Array.isArray(value.imageModels) ? value.imageModels.filter((model) => typeof model === "string" && model.trim() !== "").map((model) => ({
+				alias: model.trim(),
+				id: model.trim()
+			})) : [];
+			if (legacyUrl !== "" || legacyModels.length > 0) {
+				channels = [{
+					id: "default",
+					preset: "",
+					name: "默认渠道",
+					apiUrl: legacyUrl,
+					models: legacyModels
+				}];
+				const legacyKey = typeof value.apiKey === "string" ? value.apiKey.trim() : "";
+				if (legacyKey !== "") secrets["default"] = legacyKey;
+			}
+		}
+		const named = channels.map((channel) => ({
+			...channel,
+			name: channel.name === "" ? presetById(channel.preset)?.name ?? "未命名渠道" : channel.name
+		}));
+		const defaultChannelId = typeof value.defaultChannelId === "string" && named.some((channel) => channel.id === value.defaultChannelId) ? value.defaultChannelId : named[0]?.id ?? "";
 		return {
 			enabled: value.enabled ?? DEFAULT_ENABLED,
 			announceToAgent: value.announceToAgent ?? DEFAULT_ANNOUNCE,
 			allowAgentImageGeneration: value.allowAgentImageGeneration ?? DEFAULT_ALLOW_AGENT_IMAGE_GENERATION,
-			apiUrl: value.apiUrl ?? "",
-			apiKey: value.apiKey ?? "",
-			imageModels: normalizeImageModels(value.imageModels),
-			promptApiUrl: value.promptApiUrl ?? "",
-			promptApiKey: value.promptApiKey ?? "",
-			promptModel: value.promptModel ?? ""
+			channels: named.map((channel) => ({
+				...channel,
+				apiKey: typeof secrets[channel.id] === "string" ? secrets[channel.id] : ""
+			})),
+			defaultChannelId,
+			promptApiUrl: typeof value.promptApiUrl === "string" ? value.promptApiUrl.trim() : "",
+			promptApiKey: typeof value.promptApiKey === "string" ? value.promptApiKey.trim() : "",
+			promptModel: typeof value.promptModel === "string" ? value.promptModel.trim() : ""
 		};
 	};
-	const runtime = new ImageGenerationRuntime(() => {
+	const channelsView = () => {
 		const value = resolve();
 		return {
-			apiUrl: value.apiUrl,
-			apiKey: value.apiKey
+			channels: value.channels,
+			defaultChannelId: value.defaultChannelId
 		};
-	});
-	ctx.inject(["settings"], (sctx) => {
+	};
+	const runtime = new ImageGenerationRuntime(channelsView);
+	ctx.inject(["settings", "attachments"], (sctx) => {
 		const seam = sctx.get("settings");
 		sctx.effect(() => {
 			const disposers = makeRoutes({
 				settings: seam,
 				resolve: () => {
 					const value = resolve();
+					const channel = value.channels.find((candidate) => candidate.id === value.defaultChannelId) ?? value.channels[0];
 					return {
-						apiUrl: value.apiUrl,
-						apiKey: value.apiKey
+						apiUrl: channel?.apiUrl ?? "",
+						apiKey: channel?.apiKey ?? ""
 					};
 				},
+				resolveChannels: channelsView,
 				resolvePrompt: () => {
 					const value = resolve();
+					const channel = value.channels.find((candidate) => candidate.id === value.defaultChannelId) ?? value.channels[0];
 					return {
-						apiUrl: value.promptApiUrl.trim() || value.apiUrl,
-						apiKey: value.promptApiKey.trim() || value.apiKey,
+						apiUrl: value.promptApiUrl !== "" ? value.promptApiUrl : channel?.apiUrl ?? "",
+						apiKey: value.promptApiKey !== "" ? value.promptApiKey : channel?.apiKey ?? "",
 						model: value.promptModel
 					};
 				},
-				resolveImageModels: () => resolve().imageModels,
+				resolveImageModels: () => {
+					const value = resolve();
+					return [...new Set(value.channels.flatMap((channel) => channel.models.map((model) => model.alias)))];
+				},
+				attachments: sctx.attachments,
 				runtime
 			}).map((route) => ctx.webServer.register(route));
 			return () => {
@@ -2690,9 +3292,8 @@ function apply(ctx, config) {
 			return {
 				enabled: value.enabled,
 				allowAgentImageGeneration: value.allowAgentImageGeneration,
-				apiUrl: value.apiUrl,
-				apiKey: value.apiKey,
-				imageModels: value.imageModels
+				channels: value.channels,
+				defaultChannelId: value.defaultChannelId
 			};
 		}), "dsh-imagegen: agent image tools");
 	});
@@ -2707,7 +3308,7 @@ function apply(ctx, config) {
 		disposeSection = ctx.systemPrompt.section({
 			name: "plugin:dsh-imagegen",
 			order: SECTION_ORDER,
-			text: guidanceFor(value.imageModels)
+			text: guidanceFor(value.channels, value.defaultChannelId)
 		});
 	};
 	installSettingsSection(ctx, ImageGenSettingsNamespace, Config, config ?? {}, {