dsh-image-gen 0.2.5 → 0.2.6

package/lib/index.js

@@ -2,13 +2,15 @@ import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import * as dshSettings from "@deepseek-ai/dsh-settings";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import z from "@deepseek-ai/schemastery";
-import { mkdir, readFile, realpath, rename, stat, unlink, writeFile } from "node:fs/promises";
+import { lstat, mkdir, readFile, realpath, rename, stat, unlink, writeFile } from "node:fs/promises";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { randomUUID } from "node:crypto";
 //#region lib/types/shared.js
 /** Values shared by the Host and browser Bundle faces. */
 /** Browser route used by the generated-image card. */
 const IMAGE_ROUTE = "/plugins/dsh-image-gen/image";
+/** Browser route used for deleting generated images and workspace files. */
+const DELETE_ROUTE = "/plugins/dsh-image-gen/delete";
 /** Namespace persisted through DSH Settings. */
 const IMAGE_GENERATION_NAMESPACE = "image-generation";
 /** Supported providers. */
@@ -929,7 +931,7 @@ function record$1(value) {
 }
 //#endregion
 //#region lib/types/image-route.js
-const MAX_BODY_BYTES = 4096;
+const MAX_BODY_BYTES = 65536;
 /** Serve one verified durable image reference to a same-origin browser request. */
 async function serveImage(req, res, deps) {
 	if (req.method !== "POST") return jsonError(res, 405, "method-not-allowed");
@@ -958,6 +960,54 @@ async function serveImage(req, res, deps) {
 		jsonError(res, 404, "image-unavailable");
 	}
 }
+/** Safely delete one or more generated image files from the workspace disk. */
+async function serveDelete(req, res, deps) {
+	if (req.method !== "POST") return jsonError(res, 405, "method-not-allowed");
+	if (!(req.headers["content-type"] ?? "").toLowerCase().startsWith("application/json")) return jsonError(res, 415, "json-required");
+	const origin = req.headers.origin;
+	const host = req.headers.host;
+	if (origin !== void 0 && host !== void 0 && origin !== `http://${host}` && origin !== `https://${host}`) return jsonError(res, 403, "origin-rejected");
+	let body;
+	try {
+		body = JSON.parse(await readBody(req));
+	} catch {
+		return jsonError(res, 400, "invalid-request");
+	}
+	const rawPaths = typeof body === "object" && body !== null && "paths" in body && Array.isArray(body.paths) ? body.paths : [];
+	const rawAttachmentIds = typeof body === "object" && body !== null && "attachmentIds" in body && Array.isArray(body.attachmentIds) ? body.attachmentIds : [];
+	const deletedFiles = [];
+	const failedFiles = [];
+	for (const p of rawPaths) if (typeof p === "string" && p.trim()) try {
+		if (await deps.deleteWorkspaceImage(p)) deletedFiles.push(p);
+		else failedFiles.push({
+			path: p,
+			error: "File not found or rejected by safety checks"
+		});
+	} catch (err) {
+		failedFiles.push({
+			path: p,
+			error: err instanceof Error ? err.message : String(err)
+		});
+	}
+	for (const id of rawAttachmentIds) if (typeof id === "string" && id.trim()) try {
+		if (await deps.deleteWorkspaceImageByAttachmentId(id)) deletedFiles.push(id);
+	} catch (err) {
+		failedFiles.push({
+			path: id,
+			error: err instanceof Error ? err.message : String(err)
+		});
+	}
+	res.writeHead(200, {
+		"content-type": "application/json",
+		"cache-control": "no-store"
+	});
+	res.end(JSON.stringify({
+		ok: failedFiles.length === 0,
+		deletedCount: deletedFiles.length,
+		deletedFiles,
+		failedFiles
+	}));
+}
 /** Validate the persisted reference carried by a tool presentation. */
 function imageAttachmentFromMeta(meta) {
 	const value = record(meta);
@@ -1375,6 +1425,88 @@ async function saveImageToWorkspace(options) {
 	}
 	return target;
 }
+/** Regex pattern strictly matching generated image file names (e.g. image-01234567.png). */
+const GENERATED_IMAGE_NAME_REGEX = /^image-[0-9a-f]{8,}\.(png|jpg|jpeg|webp|gif)$/i;
+/**
+* Safely delete a generated image file from workspace disk by its path.
+* Enforces strict safety gates:
+* 1. Base name must match generated image pattern (`image-<hex>.<ext>`) to avoid touching user files.
+* 2. Path must be a regular file and NOT a symbolic link.
+* 3. Real canonical path's basename must also match the pattern.
+* 4. Real canonical path must reside within an allowed workspace root (or process.cwd()).
+*/
+async function deleteImageFromWorkspace(filePath, allowedWorkspaceRoots) {
+	const resolved = resolve(filePath);
+	const base = resolved.split(/[/\\]/).pop() ?? "";
+	if (!GENERATED_IMAGE_NAME_REGEX.test(base)) return false;
+	try {
+		const fileLstat = await lstat(resolved);
+		if (fileLstat.isSymbolicLink() || !fileLstat.isFile()) return false;
+	} catch (err) {
+		if (err?.code === "ENOENT") return true;
+		throw err;
+	}
+	try {
+		const realFile = await realpath(resolved);
+		const realBase = realFile.split(/[/\\]/).pop() ?? "";
+		if (!GENERATED_IMAGE_NAME_REGEX.test(realBase)) return false;
+		const rootsToCheck = /* @__PURE__ */ new Set();
+		if (allowedWorkspaceRoots) {
+			for (const r of allowedWorkspaceRoots) if (typeof r === "string" && r.trim()) rootsToCheck.add(resolve(r));
+		}
+		rootsToCheck.add(resolve(process.cwd()));
+		let withinAllowed = false;
+		for (const root of rootsToCheck) try {
+			if (containsPath(await realpath(root), realFile)) {
+				withinAllowed = true;
+				break;
+			}
+		} catch {}
+		if (!withinAllowed) return false;
+		await unlink(realFile);
+		return true;
+	} catch (err) {
+		if (err?.code === "ENOENT") return true;
+		throw err;
+	}
+}
+/**
+* Safely find and delete a generated image file by its attachment ID within a single workspace root.
+* Strictly checks sha256:64hex format and avoids scanning unrelated workspaces.
+* Only used as fallback for historical images where savedTo was not persisted.
+*/
+async function deleteImageByAttachmentIdFromWorkspace(attachmentId, options = {}) {
+	const match = attachmentId.match(/^sha256:([0-9a-f]{64})$/i);
+	if (!match || !match[1]) return false;
+	const prefix = match[1].slice(0, 8);
+	const rootsToCheck = /* @__PURE__ */ new Set();
+	if (options.workspaceRoot && options.workspaceRoot.trim()) rootsToCheck.add(resolve(options.workspaceRoot.trim()));
+	else if (options.allowedWorkspaceRoots) {
+		for (const r of options.allowedWorkspaceRoots) if (typeof r === "string" && r.trim()) rootsToCheck.add(resolve(r));
+	}
+	rootsToCheck.add(resolve(process.cwd()));
+	const candidateDirs = /* @__PURE__ */ new Set();
+	if (options.folder && options.folder.trim()) candidateDirs.add(options.folder.trim());
+	candidateDirs.add("dsh-image-gen");
+	candidateDirs.add("image");
+	candidateDirs.add("images");
+	candidateDirs.add("");
+	const candidateExtensions = [
+		"png",
+		"jpg",
+		"jpeg",
+		"webp",
+		"gif"
+	];
+	let deleted = false;
+	for (const root of rootsToCheck) for (const dir of candidateDirs) for (const ext of candidateExtensions) {
+		const targetPath = join(root, dir, `image-${prefix}.${ext}`);
+		try {
+			if (await deleteImageFromWorkspace(targetPath, rootsToCheck)) deleted = true;
+		} catch {}
+	}
+	return deleted;
+}
 //#endregion
 //#region lib/types/index.js
 const name = "dsh-image-gen";
@@ -1386,6 +1518,7 @@ const inject = [
 ];
 function apply(ctx, config = {}) {
 	let current = () => config;
+	const knownWorkspaceRoots = /* @__PURE__ */ new Set();
 	installImageSettings(ctx, config, {
 		setSource: (source) => {
 			current = source;
@@ -1397,6 +1530,17 @@ function apply(ctx, config = {}) {
 		path: IMAGE_ROUTE,
 		handler: (req, res) => serveImage(req, res, { readImage: (ref) => ctx.attachments.readImage(ref) })
 	}), "dsh-image-gen: image route");
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: DELETE_ROUTE,
+		handler: (req, res) => serveDelete(req, res, {
+			deleteWorkspaceImage: (filePath) => deleteImageFromWorkspace(filePath, knownWorkspaceRoots),
+			deleteWorkspaceImageByAttachmentId: (attachmentId) => deleteImageByAttachmentIdFromWorkspace(attachmentId, {
+				folder: current().workspaceFolder,
+				allowedWorkspaceRoots: knownWorkspaceRoots
+			})
+		})
+	}), "dsh-image-gen: delete route");
 	ctx.tools.register(defineTool({
 		name: "generate_image",
 		description: "Generate a new image with the configured provider. Use when the user asks to create or draw a new image; use edit_image instead when they want to change an existing image. Give a complete visual prompt including subject, composition, style, lighting, and any exact text that should appear. A successful image is attached directly to the conversation and may also be saved under the session workspace. Do not call read, glob, or other tools to locate or verify the image.",
@@ -1449,7 +1593,7 @@ function apply(ctx, config = {}) {
 					timeoutMs: active.timeoutMs,
 					maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 					signal: exec.signal
-				}), active.provider, workflow.name, "API workflow", current(), exec);
+				}), active.provider, workflow.name, "API workflow", current(), exec, knownWorkspaceRoots);
 			}
 			const credential = await ctx.credentials.resolve(credentialRef(active.apiKeyEnv));
 			if (credential === void 0 || credential.value.length === 0) throw new Error(`generate_image requires the ${active.apiKeyEnv} credential; configure it in Settings > Plugins > Image generation.`);
@@ -1465,7 +1609,7 @@ function apply(ctx, config = {}) {
 					imageSize,
 					maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 					signal: exec.signal
-				}), active.provider, active.model, `${aspectRatio}, ${imageSize}`, current(), exec);
+				}), active.provider, active.model, `${aspectRatio}, ${imageSize}`, current(), exec, knownWorkspaceRoots);
 			}
 			if (active.provider === "dashscope") {
 				const size = args.size ?? active.imageSize;
@@ -1477,7 +1621,7 @@ function apply(ctx, config = {}) {
 					size,
 					maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 					signal: exec.signal
-				}), active.provider, active.model, size, current(), exec);
+				}), active.provider, active.model, size, current(), exec, knownWorkspaceRoots);
 			}
 			const size = args.size ?? active.imageSize;
 			return saveGenerated(ctx, await generateOpenAICompatibleImage({
@@ -1489,7 +1633,7 @@ function apply(ctx, config = {}) {
 				size,
 				maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 				signal: exec.signal
-			}), active.provider, active.model, size, current(), exec);
+			}), active.provider, active.model, size, current(), exec, knownWorkspaceRoots);
 		},
 		presentResult: (_args, result) => imagePresentation(result)
 	}));
@@ -1580,7 +1724,7 @@ function apply(ctx, config = {}) {
 					timeoutMs: active.timeoutMs,
 					maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 					signal: exec.signal
-				}), active.provider, workflow.name, "API workflow", current(), exec);
+				}), active.provider, workflow.name, "API workflow", current(), exec, knownWorkspaceRoots);
 			}
 			const credential = await ctx.credentials.resolve(credentialRef(active.apiKeyEnv));
 			if (credential === void 0 || credential.value.length === 0) throw new Error(`edit_image requires the ${active.apiKeyEnv} credential; configure it in Settings > Plugins > Image generation.`);
@@ -1597,7 +1741,7 @@ function apply(ctx, config = {}) {
 					imageSize,
 					maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 					signal: exec.signal
-				}), active.provider, active.model, `${aspectRatio}, ${imageSize}`, current(), exec);
+				}), active.provider, active.model, `${aspectRatio}, ${imageSize}`, current(), exec, knownWorkspaceRoots);
 			}
 			const size = args.size ?? active.imageSize;
 			if (active.provider === "openai") return saveGenerated(ctx, await editOpenAICompatibleImage({
@@ -1609,7 +1753,7 @@ function apply(ctx, config = {}) {
 				size,
 				maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 				signal: exec.signal
-			}), active.provider, active.model, size, current(), exec);
+			}), active.provider, active.model, size, current(), exec, knownWorkspaceRoots);
 			if (active.provider === "seedream") return saveGenerated(ctx, await editSeedreamImage({
 				apiKey: credential.value,
 				baseURL: active.baseURL,
@@ -1619,7 +1763,7 @@ function apply(ctx, config = {}) {
 				size,
 				maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 				signal: exec.signal
-			}), active.provider, active.model, size, current(), exec);
+			}), active.provider, active.model, size, current(), exec, knownWorkspaceRoots);
 			return saveGenerated(ctx, await editDashScopeImage({
 				apiKey: credential.value,
 				endpoint: active.endpoint,
@@ -1629,7 +1773,7 @@ function apply(ctx, config = {}) {
 				size,
 				maxBytes: ctx.attachments.imageLimits.maxImageBytes,
 				signal: exec.signal
-			}), active.provider, active.model, size, current(), exec);
+			}), active.provider, active.model, size, current(), exec, knownWorkspaceRoots);
 		},
 		presentResult: (_args, result) => imagePresentation(result)
 	}));
@@ -1736,7 +1880,7 @@ function attachmentMeta(ref) {
 		} }
 	};
 }
-async function saveGenerated(ctx, generated, provider, model, output, config, exec) {
+async function saveGenerated(ctx, generated, provider, model, output, config, exec, knownRoots) {
 	if (!ctx.attachments.imageLimits.mediaTypes.includes(generated.mediaType)) throw new Error(`This DSH deployment does not accept ${generated.mediaType} generated images`);
 	const attachment = await ctx.attachments.saveImage({
 		data: generated.data,
@@ -1753,6 +1897,7 @@ async function saveGenerated(ctx, generated, provider, model, output, config, ex
 	if (config.saveToWorkspace === false) return value;
 	const workspaceRoot = exec.agent?.session.header.cwd;
 	if (workspaceRoot === void 0) return value;
+	knownRoots?.add(workspaceRoot);
 	try {
 		value.savedTo = await saveImageToWorkspace({
 			workspaceRoot,
@@ -1804,4 +1949,4 @@ function installImageSettings(ctx, config, hooks) {
 	ctx.logger.warn("dsh-image-gen: this DSH exposes neither settings API generation; settings UI stays on the composition entry");
 }
 //#endregion
-export { Config, IMAGE_ROUTE, apply, imageAttachmentFromMeta, inject, name };
+export { Config, DELETE_ROUTE, IMAGE_ROUTE, apply, imageAttachmentFromMeta, inject, name };

package/lib/types/client/gallery-store.d.ts

@@ -12,11 +12,17 @@ export interface GalleryItem {
     provider: ImageProvider;
     model: string;
     createdAt: number;
-    aspectRatio?: string;
-    imageSize?: string;
-    output?: string;
+    aspectRatio?: string | undefined;
+    imageSize?: string | undefined;
+    output?: string | undefined;
     /** Workflow seed reported by the ComfyUI provider. Optional so records written by older versions stay readable; the object store is schemaless, so no IndexedDB version bump is needed. */
-    seed?: number;
+    seed?: number | undefined;
+    /** Saved file path on workspace disk if savedTo was returned */
+    savedTo?: string | undefined;
+    /** Whether this item is marked as favorite */
+    isFavorite?: boolean | undefined;
+    /** Custom tags or collection markers */
+    tags?: string[] | undefined;
 }
 type GalleryListener = () => void;
 /**
@@ -26,6 +32,7 @@ export declare function subscribeGallery(listener: GalleryListener): () => void;
 /**
  * Save or update a gallery record by attachmentId.
  * Skipped if the item was previously deleted (tombstoned).
+ * Preserves existing isFavorite, tags, and original createdAt on re-renders.
  */
 export declare function saveGalleryItem(item: Omit<GalleryItem, 'createdAt'> & {
     createdAt?: number;
@@ -34,10 +41,19 @@ export declare function saveGalleryItem(item: Omit<GalleryItem, 'createdAt'> & {
  * Retrieve all gallery records sorted by createdAt descending.
  */
 export declare function getGalleryItems(): Promise<GalleryItem[]>;
+/**
+ * Toggle favorite status of a gallery item.
+ * Returns the new favorite status (true if favorited, false if unfavorited).
+ */
+export declare function toggleFavoriteGalleryItem(id: string): Promise<boolean>;
 /**
  * Delete a single gallery record by ID and record a tombstone.
  */
 export declare function deleteGalleryItem(id: string): Promise<void>;
+/**
+ * Bulk delete multiple gallery records by IDs and record tombstones in a single transaction.
+ */
+export declare function bulkDeleteGalleryItems(ids: string[]): Promise<void>;
 /**
  * Clear all gallery records and reset tombstones.
  */

package/lib/types/client/gallery-view.d.ts

@@ -1,6 +1,7 @@
 /**
- * Native Workspace Gallery View Component for DSH `conversation.view` slot.
- * Fully i18n-reactive (Chinese & English).
+ * Native Workspace Gallery & Studio View Component for DSH `conversation.view` slot.
+ * Fully i18n-reactive (Chinese & English) with modular tabs, multi-dimensional filters,
+ * responsive image grid, and placeholder routes.
  */
 import { type FC } from 'react';
 export interface LocaleService {
@@ -9,23 +10,38 @@ export interface LocaleService {
     };
     subscribe(fn: () => void): () => void;
 }
+export type TabKey = 'gallery' | 'studio' | 'favorites' | 'compare' | 'tasks';
+export type SortKey = 'newest' | 'oldest';
 declare const DICT: {
     readonly zh: {
-        readonly totalCount: "共 {count} 张生成图片";
-        readonly searchPlaceholder: "搜索 Prompt 关键词…";
-        readonly filterAll: "全部厂商";
+        readonly tabGallery: "图库";
+        readonly tabStudio: "工作台";
+        readonly tabFavorites: "收藏";
+        readonly tabCompare: "对比";
+        readonly tabTasks: "任务";
+        readonly filterAllProviders: "全部提供商";
         readonly filterGoogle: "Google Gemini";
         readonly filterOpenAI: "OpenAI / 中转站";
         readonly filterSeedream: "字节 Seedream";
         readonly filterDashScope: "阿里 DashScope";
         readonly filterComfyUI: "本地 ComfyUI";
+        readonly filterAllModels: "全部模型";
+        readonly filterAllRatios: "全部比例";
+        readonly searchPlaceholder: "搜索 Prompt、标签…";
+        readonly sortNewest: "最新生成";
+        readonly sortOldest: "最早生成";
+        readonly totalCount: "共 {count} 张生成图片";
         readonly emptyTitle: "暂无生图记录";
         readonly emptyDesc: "在对话中让 Agent 生图后，生成的图片会自动收录到这里。";
+        readonly favEmptyTitle: "暂无收藏图片";
+        readonly favEmptyDesc: "在图库中点击卡片右下角的 ♡ 按钮，即可将喜爱的图片收录到这里。";
         readonly noMatchTitle: "未找到匹配结果";
-        readonly noMatchDesc: "尝试更换搜索关键词或选择其他厂商。";
+        readonly noMatchDesc: "尝试更换搜索关键词或调整筛选条件。";
         readonly copiedPrompt: "已复制 Prompt";
         readonly copiedImage: "已复制图片";
         readonly copyFailed: "复制失败";
+        readonly favoriteAdded: "已添加到收藏";
+        readonly favoriteRemoved: "已取消收藏";
         readonly preview: "查看大图";
         readonly download: "下载图片";
         readonly copyImg: "复制图片";
@@ -36,23 +52,68 @@ declare const DICT: {
         readonly model: "模型";
         readonly prompt: "Prompt";
         readonly close: "关闭 (Esc)";
+        readonly prevImage: "上一张 (←)";
+        readonly nextImage: "下一张 (→)";
+        readonly manage: "批量删除";
+        readonly exitManage: "退出选择";
+        readonly selectedCount: "已选 {n} 项";
+        readonly selectAll: "全选";
+        readonly invertSelect: "反选";
+        readonly clearSelect: "清空";
+        readonly batchDelete: "批量删除";
+        readonly batchDeleteTitle: "确认批量删除选中的 {count} 张图片？";
+        readonly batchDeleteTitleSingle: "确认从画廊中删除这张图片？";
+        readonly batchDeleteDesc: "将从画廊历史记录中移除所选图片。";
+        readonly deleteWorkspaceFilesOpt: "同时清理工作区磁盘物理文件（不可恢复）";
+        readonly cancel: "取消";
+        readonly confirmBatchDelete: "确认删除 ({count})";
+        readonly confirmDeleteSingle: "确认删除";
+        readonly batchDeletedToast: "已删除 {count} 张图片";
+        readonly batchDeletedWithFilesToast: "已删除 {count} 张图片，并清理了 {files} 个工作区文件";
+        readonly deleteFailedFileLocked: "已删除 {count} 张图片，但有 {files} 个文件因被系统占用未能删除";
+        readonly deleteFailedDatabase: "删除失败：本地数据库操作异常";
+        readonly justNow: "刚刚";
+        readonly minutesAgo: "{n} 分钟前";
+        readonly hoursAgo: "{n} 小时前";
+        readonly daysAgo: "{n} 天前";
+        readonly studioTitle: "AI 图像工作台 (Studio)";
+        readonly studioDesc: "工作台模块正在紧锣密鼓开发中。在此你将体验大图精修、变体生成 (Variations)、参数重调并一键将生成结果无缝插回 DSH 正在进行的对话。";
+        readonly studioTip: "💡 提示：目前你可以在“图库”中点击任意图片，在弹窗中进行查看、复制与下载。";
+        readonly compareTitle: "多模型横向对比 (Compare)";
+        readonly compareDesc: "支持单个 Prompt 一键同时调度 Gemini、Seedream、DashScope 及本地 ComfyUI 模型并排生成，直观横评画质与细节。";
+        readonly tasksTitle: "异步任务队列 (Tasks)";
+        readonly tasksDesc: "集中管理后台批量生图、多模型并发生成与本地 ComfyUI 耗时任务。支持状态追踪、失败重试与执行耗时分析。";
+        readonly comingSoonBadge: "即将推出";
     };
     readonly en: {
-        readonly totalCount: "{count} images total";
-        readonly searchPlaceholder: "Search prompt keywords…";
-        readonly filterAll: "All Providers";
+        readonly tabGallery: "Gallery";
+        readonly tabStudio: "Studio";
+        readonly tabFavorites: "Favorites";
+        readonly tabCompare: "Compare";
+        readonly tabTasks: "Tasks";
+        readonly filterAllProviders: "All Providers";
         readonly filterGoogle: "Google Gemini";
         readonly filterOpenAI: "OpenAI / Relay";
         readonly filterSeedream: "ByteDance Seedream";
         readonly filterDashScope: "Aliyun DashScope";
         readonly filterComfyUI: "Local ComfyUI";
+        readonly filterAllModels: "All Models";
+        readonly filterAllRatios: "All Ratios";
+        readonly searchPlaceholder: "Search prompt, tags…";
+        readonly sortNewest: "Newest first";
+        readonly sortOldest: "Oldest first";
+        readonly totalCount: "{count} images total";
         readonly emptyTitle: "No images generated yet";
         readonly emptyDesc: "Images generated during conversations will automatically appear here.";
+        readonly favEmptyTitle: "No favorite images yet";
+        readonly favEmptyDesc: "Click the ♡ button on any card in the gallery to collect your favorite images here.";
         readonly noMatchTitle: "No matching images";
-        readonly noMatchDesc: "Try a different search keyword or provider filter.";
+        readonly noMatchDesc: "Try a different search keyword or adjust filter criteria.";
         readonly copiedPrompt: "Prompt copied";
         readonly copiedImage: "Image copied";
         readonly copyFailed: "Copy failed";
+        readonly favoriteAdded: "Added to favorites";
+        readonly favoriteRemoved: "Removed from favorites";
         readonly preview: "Full Preview";
         readonly download: "Download";
         readonly copyImg: "Copy Image";
@@ -63,6 +124,38 @@ declare const DICT: {
         readonly model: "Model";
         readonly prompt: "Prompt";
         readonly close: "Close (Esc)";
+        readonly prevImage: "Previous (←)";
+        readonly nextImage: "Next (→)";
+        readonly manage: "Batch Delete";
+        readonly exitManage: "Done";
+        readonly selectedCount: "{n} selected";
+        readonly selectAll: "Select All";
+        readonly invertSelect: "Invert";
+        readonly clearSelect: "Clear";
+        readonly batchDelete: "Batch Delete";
+        readonly batchDeleteTitle: "Delete {count} selected images?";
+        readonly batchDeleteTitleSingle: "Delete this image from gallery?";
+        readonly batchDeleteDesc: "These images will be removed from your gallery history.";
+        readonly deleteWorkspaceFilesOpt: "Also delete files from workspace disk (cannot be undone)";
+        readonly cancel: "Cancel";
+        readonly confirmBatchDelete: "Delete ({count})";
+        readonly confirmDeleteSingle: "Delete";
+        readonly batchDeletedToast: "Deleted {count} images";
+        readonly batchDeletedWithFilesToast: "Deleted {count} images and cleaned {files} workspace files";
+        readonly deleteFailedFileLocked: "Deleted {count} images, but {files} files could not be deleted (busy/locked)";
+        readonly deleteFailedDatabase: "Failed to delete: local database error";
+        readonly justNow: "Just now";
+        readonly minutesAgo: "{n}m ago";
+        readonly hoursAgo: "{n}h ago";
+        readonly daysAgo: "{n}d ago";
+        readonly studioTitle: "AI Image Studio";
+        readonly studioDesc: "Studio workbench is under active development. Fine-tune prompts, generate variations (2x/4x), and inject images directly into DSH chat.";
+        readonly studioTip: "💡 Tip: You can currently click any image in the Gallery to preview, copy, or download it.";
+        readonly compareTitle: "Model Comparison (Compare)";
+        readonly compareDesc: "Side-by-side multi-model benchmarking coming soon. Test Gemini, Seedream, DashScope, and ComfyUI with a single prompt.";
+        readonly tasksTitle: "Task Queue (Tasks)";
+        readonly tasksDesc: "Centralized view for batch generation, asynchronous ComfyUI runs, live progress tracking, and retry controls.";
+        readonly comingSoonBadge: "Coming Soon";
     };
 };
 export type DictKey = keyof typeof DICT.zh;

package/lib/types/image-route.d.ts

@@ -1,12 +1,19 @@
 /** Same-origin HTTP bridge from the Web result card to the Attachment service. */
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { ImageAttachmentRef, StoredImageAttachment } from '@deepseek-ai/dsh-attachment';
-export { IMAGE_ROUTE } from './shared.js';
+export { IMAGE_ROUTE, DELETE_ROUTE } from './shared.js';
 /** Dependencies required by the image route. */
 export interface ImageRouteDeps {
     readImage(ref: ImageAttachmentRef): Promise<StoredImageAttachment>;
 }
+/** Dependencies required by the delete route. */
+export interface DeleteRouteDeps {
+    deleteWorkspaceImage(filePath: string): Promise<boolean>;
+    deleteWorkspaceImageByAttachmentId(attachmentId: string): Promise<boolean>;
+}
 /** Serve one verified durable image reference to a same-origin browser request. */
 export declare function serveImage(req: IncomingMessage, res: ServerResponse, deps: ImageRouteDeps): Promise<void>;
+/** Safely delete one or more generated image files from the workspace disk. */
+export declare function serveDelete(req: IncomingMessage, res: ServerResponse, deps: DeleteRouteDeps): Promise<void>;
 /** Validate the persisted reference carried by a tool presentation. */
 export declare function imageAttachmentFromMeta(meta: unknown): ImageAttachmentRef | undefined;

package/lib/types/index.d.ts

@@ -2,7 +2,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { Config } from './config.js';
 export { Config } from './config.js';
-export { IMAGE_ROUTE, imageAttachmentFromMeta } from './image-route.js';
+export { IMAGE_ROUTE, DELETE_ROUTE, imageAttachmentFromMeta } from './image-route.js';
 export declare const name = "dsh-image-gen";
 export declare const inject: string[];
 export declare function apply(ctx: Context, config?: Config): void;

package/lib/types/shared.d.ts

@@ -1,6 +1,8 @@
 /** Values shared by the Host and browser Bundle faces. */
 /** Browser route used by the generated-image card. */
 export declare const IMAGE_ROUTE = "/plugins/dsh-image-gen/image";
+/** Browser route used for deleting generated images and workspace files. */
+export declare const DELETE_ROUTE = "/plugins/dsh-image-gen/delete";
 /** Namespace persisted through DSH Settings. */
 export declare const IMAGE_GENERATION_NAMESPACE = "image-generation";
 /** Supported providers. */

package/lib/types/workspace-save.d.ts

@@ -50,3 +50,24 @@ export declare function saveImageToWorkspace(options: {
     data: Uint8Array;
     signal?: AbortSignal;
 }): Promise<string>;
+/** Discover all DSH workspace paths recorded in local application storage. */
+export declare function getDshWorkspaceRoots(): Promise<string[]>;
+/**
+ * Safely delete a generated image file from workspace disk by its path.
+ * Enforces strict safety gates:
+ * 1. Base name must match generated image pattern (`image-<hex>.<ext>`) to avoid touching user files.
+ * 2. Path must be a regular file and NOT a symbolic link.
+ * 3. Real canonical path's basename must also match the pattern.
+ * 4. Real canonical path must reside within an allowed workspace root (or process.cwd()).
+ */
+export declare function deleteImageFromWorkspace(filePath: string, allowedWorkspaceRoots?: Iterable<string>): Promise<boolean>;
+/**
+ * Safely find and delete a generated image file by its attachment ID within a single workspace root.
+ * Strictly checks sha256:64hex format and avoids scanning unrelated workspaces.
+ * Only used as fallback for historical images where savedTo was not persisted.
+ */
+export declare function deleteImageByAttachmentIdFromWorkspace(attachmentId: string, options?: {
+    workspaceRoot?: string | undefined;
+    folder?: string | undefined;
+    allowedWorkspaceRoots?: Iterable<string> | undefined;
+}): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-image-gen",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",
@@ -130,5 +130,8 @@
     "unrun": "^0.3.1",
     "vitest": "^4.1.8"
   },
-  "packageManager": "pnpm@11.7.0"
+  "packageManager": "pnpm@11.7.0",
+  "dependencies": {
+    "lucide-react": "^1.38.0"
+  }
 }