@dickpy/dsh-imagegen 1.0.0 → 1.0.2

package/lib/index.js

@@ -1,8 +1,10 @@
 import { SettingsConflictError, installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "schemastery";
+import { randomUUID } from "node:crypto";
 import { promises } from "node:fs";
 import { homedir } from "node:os";
 import path from "node:path";
+import { spawn } from "node:child_process";
 //#region src/protocol.ts
 /**
 * Wire contract shared by the host and client halves of dsh-imagegen: the
@@ -18,6 +20,11 @@ const SETTINGS_API = {
 };
 /** The image-generation proxy route. */
 const GENERATE_API = "/api/dsh-imagegen/generate";
+/** Host-mediated GitHub Release update routes. */
+const UPDATE_API = {
+	check: "/api/dsh-imagegen/update/check",
+	apply: "/api/dsh-imagegen/update/apply"
+};
 /**
 * Same-origin route family for the host-persisted generation history. Images
 * live as files under ~/.dsh/dsh-imagegen/images/ and are served back through
@@ -260,6 +267,12 @@ function extensionOf$1(mime) {
 const HISTORY_DIR = path.join(homedir(), ".dsh", "dsh-imagegen");
 const INDEX_PATH = path.join(HISTORY_DIR, "index.json");
 const IMAGES_DIR = path.join(HISTORY_DIR, "images");
+let pendingMutation = Promise.resolve();
+function mutateHistory(operation) {
+	const next = pendingMutation.then(operation, operation);
+	pendingMutation = next.then(() => void 0, () => void 0);
+	return next;
+}
 /** File extension for a MIME type (image file names). */
 function extensionOf(mime) {
 	switch (mime.split(";")[0].trim()) {
@@ -351,52 +364,63 @@ async function listHistory() {
 }
 /** Append one generation, evicting the oldest beyond HISTORY_MAX. */
 async function appendHistory(input) {
-	await ensureDirs();
-	const prefix = safeId(input.id);
-	const storedImages = [];
-	for (let index = 0; index < input.images.length; index++) {
-		const image = input.images[index];
-		const file = `${prefix}-${index}.${extensionOf(image.mime)}`;
-		await promises.writeFile(path.join(IMAGES_DIR, file), Buffer.from(image.b64, "base64"));
-		storedImages.push({
-			file,
-			mime: image.mime,
-			...image.revisedPrompt === void 0 ? {} : { revisedPrompt: image.revisedPrompt }
-		});
-	}
-	const merged = [{
-		id: input.id,
-		createdAt: input.createdAt,
-		mode: input.mode,
-		model: input.model,
-		prompt: input.prompt,
-		size: input.size,
-		quality: input.quality,
-		detail: input.detail,
-		n: input.n,
-		images: storedImages,
-		...input.refName === void 0 ? {} : { refName: input.refName }
-	}, ...await readIndex()];
-	const kept = merged.slice(0, 50);
-	for (const dropped of merged.slice(50)) await removeEntryFiles(dropped);
-	await writeIndex(kept);
-	return kept.map(toWire);
+	return mutateHistory(async () => {
+		await ensureDirs();
+		const prefix = safeId(input.id);
+		const storedImages = [];
+		try {
+			for (let index = 0; index < input.images.length; index++) {
+				const image = input.images[index];
+				const file = `${prefix}-${index}.${extensionOf(image.mime)}`;
+				await promises.writeFile(path.join(IMAGES_DIR, file), Buffer.from(image.b64, "base64"));
+				storedImages.push({
+					file,
+					mime: image.mime,
+					...image.revisedPrompt === void 0 ? {} : { revisedPrompt: image.revisedPrompt }
+				});
+			}
+		} catch (error) {
+			await removeEntryFiles({ images: storedImages });
+			throw error;
+		}
+		const merged = [{
+			id: input.id,
+			createdAt: input.createdAt,
+			mode: input.mode,
+			model: input.model,
+			prompt: input.prompt,
+			size: input.size,
+			quality: input.quality,
+			detail: input.detail,
+			n: input.n,
+			images: storedImages,
+			...input.refName === void 0 ? {} : { refName: input.refName }
+		}, ...await readIndex()];
+		const kept = merged.slice(0, 50);
+		for (const dropped of merged.slice(50)) await removeEntryFiles(dropped);
+		await writeIndex(kept);
+		return kept.map(toWire);
+	});
 }
 /** Remove one entry (and its image files). */
 async function removeHistory(id) {
-	const previous = await readIndex();
-	const target = previous.find((entry) => entry.id === id);
-	if (target !== void 0) await removeEntryFiles(target);
-	const kept = previous.filter((entry) => entry.id !== id);
-	await writeIndex(kept);
-	return kept.map(toWire);
+	return mutateHistory(async () => {
+		const previous = await readIndex();
+		const target = previous.find((entry) => entry.id === id);
+		if (target !== void 0) await removeEntryFiles(target);
+		const kept = previous.filter((entry) => entry.id !== id);
+		await writeIndex(kept);
+		return kept.map(toWire);
+	});
 }
 /** Remove every entry (and all image files). */
 async function clearHistory() {
-	const previous = await readIndex();
-	for (const entry of previous) await removeEntryFiles(entry);
-	await writeIndex([]);
-	return [];
+	return mutateHistory(async () => {
+		const previous = await readIndex();
+		for (const entry of previous) await removeEntryFiles(entry);
+		await writeIndex([]);
+		return [];
+	});
 }
 /** Read one stored image file by its (validated) file name. */
 async function readHistoryImage(file) {
@@ -411,6 +435,106 @@ async function readHistoryImage(file) {
 	}
 }
 //#endregion
+//#region src/updater.ts
+/** GitHub Release discovery and explicit, user-triggered plugin updates. */
+/** Keep this in sync with package.json for each published release. */
+const CURRENT_VERSION = "1.0.2";
+const PACKAGE_NAME = "@dickpy/dsh-imagegen";
+const RELEASES_URL = "https://api.github.com/repos/dickpy/dsh-imagegen/releases/latest";
+const CHECK_TIMEOUT_MS = 1e4;
+const CACHE_TTL_MS = 15 * 6e4;
+let cached;
+/** Compare stable semver triples; returns positive when `left` is newer. */
+function compareVersions(left, right) {
+	const parse = (value) => {
+		const match = /^v?(\d+)\.(\d+)\.(\d+)/.exec(value.trim());
+		if (match === null) return [
+			0,
+			0,
+			0
+		];
+		return [
+			Number(match[1]),
+			Number(match[2]),
+			Number(match[3])
+		];
+	};
+	const a = parse(left);
+	const b = parse(right);
+	return a[0] - b[0] || a[1] - b[1] || a[2] - b[2];
+}
+function normalizedReleaseVersion(tag) {
+	if (typeof tag !== "string" || !/^v?\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(tag.trim())) return void 0;
+	return tag.trim().replace(/^v/, "");
+}
+/** Read the latest stable GitHub Release, with a short host-side cache. */
+async function checkForUpdate(fetchFn = fetch, now = Date.now()) {
+	if (cached !== void 0 && cached.expiresAt > now) return cached.value;
+	const response = await fetchFn(RELEASES_URL, {
+		headers: {
+			accept: "application/vnd.github+json",
+			"user-agent": "dsh-imagegen-update-check"
+		},
+		signal: AbortSignal.timeout(CHECK_TIMEOUT_MS)
+	});
+	if (!response.ok) throw new Error(`GitHub Releases returned HTTP ${response.status}`);
+	const payload = await response.json();
+	if (payload === null || typeof payload !== "object") throw new Error("GitHub Releases returned malformed JSON");
+	const release = payload;
+	if (release.draft === true || release.prerelease === true) throw new Error("latest GitHub Release is not stable");
+	const latestVersion = normalizedReleaseVersion(release.tag_name);
+	if (latestVersion === void 0) throw new Error("latest GitHub Release has an invalid version tag");
+	const releaseUrl = typeof release.html_url === "string" ? release.html_url : "https://github.com/dickpy/dsh-imagegen/releases";
+	const value = {
+		currentVersion: CURRENT_VERSION,
+		latestVersion,
+		updateAvailable: compareVersions(latestVersion, CURRENT_VERSION) > 0,
+		releaseUrl,
+		...typeof release.published_at === "string" ? { publishedAt: release.published_at } : {}
+	};
+	cached = {
+		expiresAt: now + CACHE_TTL_MS,
+		value
+	};
+	return value;
+}
+/** Resolve the profile that launched the current DSH process. */
+function profileFromProcess(argv = process.argv, env = process.env) {
+	const envProfile = env.DSH_PROFILE?.trim();
+	if (envProfile !== void 0 && /^[a-zA-Z0-9_-]+$/.test(envProfile)) return envProfile;
+	const profileIndex = argv.indexOf("--profile");
+	const explicit = profileIndex >= 0 ? argv[profileIndex + 1]?.trim() : void 0;
+	if (explicit !== void 0 && /^[a-zA-Z0-9_-]+$/.test(explicit)) return explicit;
+	if (argv.includes("web")) return "web";
+	return "web";
+}
+/** Run the same official command documented for plugin installation. */
+function installUpdate(version, spawnFn = spawn, argv = process.argv, env = process.env) {
+	if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(version)) return Promise.reject(/* @__PURE__ */ new Error("invalid update version"));
+	const profile = profileFromProcess(argv, env);
+	const child = spawnFn(process.platform === "win32" ? "dsh.cmd" : "dsh", [
+		"plugin",
+		"--profile",
+		profile,
+		"add",
+		`${PACKAGE_NAME}@${version}`
+	], {
+		shell: process.platform === "win32",
+		stdio: "ignore"
+	});
+	return new Promise((resolve, reject) => {
+		child.once("error", reject);
+		child.once("exit", (code, signal) => {
+			if (code === 0) resolve();
+			else reject(/* @__PURE__ */ new Error(signal === null ? `plugin update exited with code ${code ?? "unknown"}` : `plugin update terminated by ${signal}`));
+		});
+	});
+}
+/** Test helper: clear the host-side Release cache. */
+function clearUpdateCache() {
+	cached = void 0;
+}
+//#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;
@@ -550,6 +674,13 @@ function failureOf(error) {
 * @returns the route registrations.
 */
 function makeRoutes(deps) {
+	const history = deps.history ?? {
+		list: listHistory,
+		append: appendHistory,
+		remove: removeHistory,
+		clear: clearHistory,
+		readImage: readHistoryImage
+	};
 	const guard = (req, res, method) => {
 		if (!isLoopbackRequest(req)) {
 			writeJson(res, 403, { error: "forbidden: loopback-only" });
@@ -661,13 +792,37 @@ function makeRoutes(deps) {
 					quality: typeof body.quality === "string" ? body.quality : "auto",
 					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.image === "string" && body.image !== "" ? { image: body.image } : {},
+					...typeof body.refName === "string" && body.refName !== "" ? { refName: body.refName } : {}
 				};
 				try {
-					writeJson(res, 200, {
-						ok: true,
-						...await generateImage(deps.resolve(), request)
-					});
+					const result = await generateImage(deps.resolve(), request);
+					try {
+						const entries = await history.append({
+							id: randomUUID(),
+							createdAt: Date.now(),
+							mode: request.mode,
+							model: request.model,
+							prompt: request.prompt,
+							size: request.size,
+							quality: request.quality,
+							detail: request.detail,
+							n: request.n,
+							images: result.images,
+							...request.refName === void 0 ? {} : { refName: request.refName }
+						});
+						writeJson(res, 200, {
+							ok: true,
+							...result,
+							history: entries
+						});
+					} catch (error) {
+						writeJson(res, 200, {
+							ok: true,
+							...result,
+							historyError: messageOf(error)
+						});
+					}
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
 					writeJson(res, 200, {
@@ -678,6 +833,66 @@ function makeRoutes(deps) {
 				}
 			}
 		},
+		{
+			kind: "exact",
+			path: UPDATE_API.check,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				try {
+					writeJson(res, 200, {
+						ok: true,
+						update: await checkForUpdate()
+					});
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "update-check-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		},
+		{
+			kind: "exact",
+			path: UPDATE_API.apply,
+			handler: async (req, res) => {
+				if (!guard(req, res, "POST")) return;
+				const body = await readJsonBody(req);
+				const version = body !== void 0 && typeof body.version === "string" ? body.version.trim() : "";
+				if (version === "") {
+					writeJson(res, 200, {
+						ok: false,
+						code: "bad-request",
+						message: "update version is required"
+					});
+					return;
+				}
+				try {
+					const latest = await checkForUpdate();
+					if (!latest.updateAvailable || latest.latestVersion !== version) {
+						writeJson(res, 200, {
+							ok: false,
+							code: "update-not-available",
+							message: `version ${version} is not the latest available release`
+						});
+						return;
+					}
+					await installUpdate(version);
+					writeJson(res, 200, {
+						ok: true,
+						currentVersion: CURRENT_VERSION,
+						updatedVersion: version,
+						restartRequired: true
+					});
+				} catch (error) {
+					writeJson(res, 200, {
+						ok: false,
+						code: "update-failed",
+						message: messageOf(error)
+					});
+				}
+			}
+		},
 		{
 			kind: "exact",
 			path: HISTORY_API.list,
@@ -686,7 +901,7 @@ function makeRoutes(deps) {
 				try {
 					writeJson(res, 200, {
 						ok: true,
-						entries: await listHistory()
+						entries: await history.list()
 					});
 				} catch (error) {
 					writeJson(res, 200, {
@@ -723,7 +938,7 @@ function makeRoutes(deps) {
 				try {
 					writeJson(res, 200, {
 						ok: true,
-						entries: await appendHistory(entry)
+						entries: await history.append(entry)
 					});
 				} catch (error) {
 					writeJson(res, 200, {
@@ -752,7 +967,7 @@ function makeRoutes(deps) {
 				try {
 					writeJson(res, 200, {
 						ok: true,
-						entries: await removeHistory(id)
+						entries: await history.remove(id)
 					});
 				} catch (error) {
 					writeJson(res, 200, {
@@ -771,7 +986,7 @@ function makeRoutes(deps) {
 				try {
 					writeJson(res, 200, {
 						ok: true,
-						entries: await clearHistory()
+						entries: await history.clear()
 					});
 				} catch (error) {
 					writeJson(res, 200, {
@@ -799,7 +1014,7 @@ function makeRoutes(deps) {
 					writeJson(res, 404, { error: "not found" });
 					return;
 				}
-				const found = await readHistoryImage(file);
+				const found = await history.readImage(file);
 				if (found === void 0) {
 					writeJson(res, 404, { error: "not found" });
 					return;
@@ -834,7 +1049,7 @@ const DEFAULT_ANNOUNCE = 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 生图」入口；本地插件（源码位于 E:\\dsh-plugin，独立于 dsh-web-ui 插件全家桶）。能力：对接 OpenAI 兼容图像生成 API（模型 gpt-image-2），支持文生图（/images/generations）与图生图（/images/edits，上传参考图）；API 地址与密钥在 GUI「设置 → 插件 → 可配置」中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务。用户提到「生图 / 绘画 / 生成图片 / gpt-image-2 / 文生图 / 图生图」时即指本插件，请据此协作。";
+const IMAGEGEN_GUIDANCE = "本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：对接 OpenAI 兼容图像生成 API（模型 gpt-image-2），支持文生图（/images/generations）与图生图（/images/edits，上传参考图）；API 地址与密钥在 GUI「设置 → 插件 → 可配置」中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务。用户提到「生图 / 绘画 / 生成图片 / gpt-image-2 / 文生图 / 图生图」时即指本插件，请据此协作。";
 /**
 * Mount the settings section, routes, and announcement.
 * @param ctx - host plugin context carrying webServer/systemPrompt.
@@ -893,4 +1108,4 @@ function apply(ctx, config) {
 	sync();
 }
 //#endregion
-export { Config, IMAGEGEN_GUIDANCE, ImageGenError, ImageGenSettingsNamespace, apply, generateImage, inject, makeRoutes, name };
+export { CURRENT_VERSION, Config, IMAGEGEN_GUIDANCE, ImageGenError, ImageGenSettingsNamespace, apply, checkForUpdate, clearUpdateCache, compareVersions, generateImage, inject, installUpdate, makeRoutes, name, profileFromProcess };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dickpy/dsh-imagegen",
   "description": "AI 生图 (image generation) plugin for the dsh web GUI: text-to-image and image-to-image through a configurable OpenAI-compatible endpoint (gpt-image-2 / gpt-image-1 / dall-e-3), with a settings card for api_url / api_key and a sidebar entry opening a split-pane generation studio.",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -51,6 +51,7 @@
     "lib",
     "src",
     "cordis.patch.yml",
+    "docs",
     "README.md"
   ],
   "license": "Apache-2.0",
@@ -63,4 +64,4 @@
     "watch": "tsdown --watch",
     "typecheck": "tsc --noEmit"
   }
-}
+}

package/src/client/ImageGenPanel.tsx

@@ -13,7 +13,7 @@ import { createPortal } from 'react-dom'
 import { Button, Pill } from '@deepseek-ai/dsh-client-ui-primitives'
 import type { ImageGenApi } from './api.ts'
 import { errorMessage, tt } from './helpers.ts'
-import type { GeneratedImage, GenerateMode, GenerateRequest, HistoryEntry, HistoryEntryInput, HistoryImageRef } from '../protocol.ts'
+import type { GeneratedImage, GenerateMode, GenerateRequest, HistoryEntry, HistoryImageRef, UpdateInfo } from '../protocol.ts'
 import type { ImageGenConfig, ImageGenScope } from './settings-scope.ts'
 import css from './panel.module.css'
 
@@ -124,6 +124,10 @@ export function ImageGenPanel(props: {
   const [history, setHistory] = useState<HistoryEntry[]>([])
   const [viewingHistoryId, setViewingHistoryId] = useState<string | null>(null)
   const [preview, setPreview] = useState<{ images: GeneratedImage[]; index: number } | null>(null)
+  const [update, setUpdate] = useState<UpdateInfo | null>(null)
+  const [updating, setUpdating] = useState(false)
+  const [updateMessage, setUpdateMessage] = useState<string | null>(null)
+  const [updateResult, setUpdateResult] = useState<'success' | 'failed' | null>(null)
   const fileInput = useRef<HTMLInputElement>(null)
   const elapsed = useElapsed(generating, startedAt)
 
@@ -137,6 +141,35 @@ export function ImageGenPanel(props: {
     return () => { disposed = true }
   }, [api])
 
+  // Release checks are host-mediated and intentionally best-effort: a GitHub
+  // outage must never make the image-generation studio unavailable.
+  useEffect(() => {
+    let disposed = false
+    api.updateCheck()
+      .then(info => {
+        if (!disposed && info.updateAvailable) setUpdate(info)
+      })
+      .catch(() => { /* update discovery is optional */ })
+    return () => { disposed = true }
+  }, [api])
+
+  const applyUpdate = async (): Promise<void> => {
+    if (update === null || updating) return
+    setUpdating(true)
+    setUpdateMessage(null)
+    setUpdateResult(null)
+    try {
+      const result = await api.updateApply(update.latestVersion)
+      setUpdateMessage(tt('update.success', { version: result.updatedVersion }))
+      setUpdateResult('success')
+    } catch {
+      setUpdateMessage(tt('update.failed'))
+      setUpdateResult('failed')
+    } finally {
+      setUpdating(false)
+    }
+  }
+
   /** Read an uploaded reference image into a data URL. */
   const acceptFile = (file: File | undefined): void => {
     if (file === undefined) return
@@ -177,6 +210,7 @@ export function ImageGenPanel(props: {
       n: count,
       detail,
       ...mode === 'edit' && refImage !== null ? { image: refImage.dataUrl } : {},
+      ...mode === 'edit' && refImage !== null ? { refName: refImage.name } : {},
     }
     setGenerating(true)
     setError(null)
@@ -186,24 +220,8 @@ export function ImageGenPanel(props: {
       const result = await api.generate(request)
       setImages(result.images)
       setViewingHistoryId(null)
-      const entry: HistoryEntryInput = {
-        id: `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
-        createdAt: Date.now(),
-        mode,
-        model,
-        prompt: promptText,
-        size,
-        quality,
-        detail,
-        n: count,
-        images: result.images,
-        ...mode === 'edit' && refImage !== null ? { refName: refImage.name } : {},
-      }
-      try {
-        setHistory(await api.historyAppend(entry))
-      } catch {
-        // Persisting history is best-effort; the images stay on the canvas.
-      }
+      if (result.history !== undefined) setHistory(result.history)
+      if (result.historyError !== undefined) setError(result.historyError)
     } catch (caught) {
       setError(errorMessage(caught))
     } finally {
@@ -308,6 +326,20 @@ export function ImageGenPanel(props: {
           ? <div className={css.banner} data-kind="warn">{tt('config.missing')}</div>
           : <div className={css.banner} data-kind="ok">{tt('config.configured', { url: apiUrl })}</div>}
 
+      {update !== null ? (
+        <div className={css.updateBanner} data-kind={updateResult === 'success' ? 'ok' : 'warn'}>
+          <span className={css.updateText}>
+            {updateMessage ?? tt('update.available', { version: update.latestVersion })}
+          </span>
+          <span className={css.updateActions}>
+            <a className={css.updateRelease} href={update.releaseUrl} target="_blank" rel="noreferrer">{tt('update.release')}</a>
+            <Button variant="primary" size="sm" disabled={updating || updateMessage !== null} onClick={() => { void applyUpdate() }}>
+              {updating ? tt('update.installing') : tt('update.install')}
+            </Button>
+          </span>
+        </div>
+      ) : null}
+
       <div className={css.studio}>
         {/* ---------------------------------------------------- config sidebar */}
         <aside className={css.config}>

package/src/client/api.ts

@@ -3,7 +3,7 @@
  * data access path the panel uses — plain fetch, same origin.
  */
 
-import { GENERATE_API, HISTORY_API, type GenerateRequest, type GenerateResult, type HistoryEntry, type HistoryEntryInput } from '../protocol.ts'
+import { GENERATE_API, HISTORY_API, UPDATE_API, type GenerateRequest, type GenerateResult, type HistoryEntry, type UpdateInfo } from '../protocol.ts'
 
 /** Error carrying the route's JSON error message. */
 export class ImageGenApiError extends Error {
@@ -40,6 +40,24 @@ async function readEnvelope<T>(response: Response): Promise<T> {
 
 /** The browser half's data entry point. */
 export class ImageGenApi {
+  /** Ask the host to check the latest stable GitHub Release. */
+  async updateCheck(): Promise<UpdateInfo> {
+    const response = await fetch(UPDATE_API.check, { method: 'POST' })
+    const body = await readEnvelope<{ ok: true; update: UpdateInfo }>(response)
+    return body.update
+  }
+
+  /** Ask the host to install a previously discovered Release. */
+  async updateApply(version: string): Promise<{ updatedVersion: string; restartRequired: boolean }> {
+    const response = await fetch(UPDATE_API.apply, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ version }),
+    })
+    const body = await readEnvelope<{ ok: true; updatedVersion: string; restartRequired: boolean }>(response)
+    return { updatedVersion: body.updatedVersion, restartRequired: body.restartRequired }
+  }
+
   /** Forward one generate request to the host proxy. */
   async generate(request: GenerateRequest): Promise<GenerateResult> {
     const response = await fetch(GENERATE_API, {
@@ -47,8 +65,12 @@ export class ImageGenApi {
       headers: { 'content-type': 'application/json' },
       body: JSON.stringify(request),
     })
-    const body = await readEnvelope<{ ok: true; images: GenerateResult['images'] }>(response)
-    return { images: body.images }
+    const body = await readEnvelope<{ ok: true; images: GenerateResult['images']; history?: HistoryEntry[]; historyError?: string }>(response)
+    return {
+      images: body.images,
+      ...body.history === undefined ? {} : { history: body.history },
+      ...body.historyError === undefined ? {} : { historyError: body.historyError },
+    }
   }
 
   /** List the host-persisted history (newest first). */
@@ -58,17 +80,6 @@ export class ImageGenApi {
     return body.entries
   }
 
-  /** Append one generation to the host-persisted history. */
-  async historyAppend(entry: HistoryEntryInput): Promise<HistoryEntry[]> {
-    const response = await fetch(HISTORY_API.append, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ entry }),
-    })
-    const body = await readEnvelope<{ ok: true; entries: HistoryEntry[] }>(response)
-    return body.entries
-  }
-
   /** Remove one history entry by id. */
   async historyRemove(id: string): Promise<HistoryEntry[]> {
     const response = await fetch(HISTORY_API.remove, {

package/src/client/locales.ts

@@ -76,6 +76,13 @@ export const zh = {
   'config.missing': '尚未配置 API：请前往「设置 → 插件 → 可配置」为 AI 生图填写 api_url 与 api_key。',
   'config.configured': '已连接 {url}',
   'config.disabled': '插件已停用，请在设置中重新启用。',
+  // plugin update
+  'update.available': '检测到新版本：{version}',
+  'update.install': '在线更新',
+  'update.installing': '更新中…',
+  'update.success': '已更新到 {version}，请重启 DSH',
+  'update.failed': '更新失败，请重试',
+  'update.release': '查看 Release',
   // settings card
   'settings.title': 'AI 生图（dsh-imagegen）',
   'settings.description': '配置图像生成 API 地址与密钥',
@@ -168,9 +175,15 @@ export const en: Record<keyof typeof zh, string> = {
   'preview.prev': 'Previous',
   'preview.next': 'Next',
   'preview.index': '{index} / {total}',
-  'config.missing': 'API not configured: open "Settings → Web UI Plugins" and fill in api_url and api_key for AI Image.',
+  'config.missing': 'API not configured: open "Settings → Plugins → Configurable" and fill in api_url and api_key for AI Image.',
   'config.configured': 'Connected to {url}',
   'config.disabled': 'The plugin is disabled — re-enable it in Settings.',
+  'update.available': 'A new version is available: {version}',
+  'update.install': 'Update online',
+  'update.installing': 'Updating…',
+  'update.success': 'Updated to {version}; restart DSH to load it',
+  'update.failed': 'Update failed; please try again',
+  'update.release': 'View Release',
   'settings.title': 'AI Image (dsh-imagegen)',
   'settings.description': 'Configure the image generation API endpoint and key',
   'settings.apiUrl': 'API URL (api_url)',