@dickpy/dsh-imagegen 1.0.0 → 1.0.1

package/README.md

@@ -33,44 +33,49 @@ DeepSeek Harness (DSH) Web GUI 的 AI 生图插件。它通过宿主进程安全
 
 ## 快速开始
 
-### 1. 构建插件
+> 前置条件：已安装 DSH（`npm i -g @deepseek-ai/dsh`）与 pnpm。
+> 装完统一**重启 dsh web**，侧边栏即出现「AI 生图」入口，再到「设置 → 插件 → 可配置」填写 API 地址与密钥。
 
-前置条件：Node.js 20+、pnpm，以及一个可运行的 DSH Web profile。
+### 方式一：让 AI 帮你安装（最省事）
+
+把下面提示词直接粘贴给 **DSH**（或 Codex / 其他 coding agent）执行即可：
+
+```text
+用 dsh plugin --profile web add @dickpy/dsh-imagegen@1.0.0 安装 AI 生图插件（profile 名按实际修改），完成后重启 dsh web。
+```
+
+### 方式二：npm 安装（推荐）
 
 ```bash
-git clone https://github.com/dickpy/dsh-imagegen.git
-cd dsh-imagegen
-pnpm install
-pnpm run build
+dsh plugin --profile web add @dickpy/dsh-imagegen@1.0.0
 ```
 
-### 2. 接入 DSH Web profile
+dsh 会自动把插件注册进 profile 的 bundle 清单（无需手动改 cordis.patch.yml），重启 dsh web 即可。
 
-在 DSH Web profile 的 `package.json` 中加入本地依赖：
+### 方式三：聚合包（tarball）安装
 
-```json
-{
-  "dependencies": {
-    "@dickpy/dsh-imagegen": "link:E:/dsh-plugin"
-  }
-}
+从 [GitHub Releases](https://github.com/dickpy/dsh-imagegen/releases) 下载发布产物
+（如 `dsh-local-dsh-imagegen-1.0.0.tgz`），然后：
+
+```bash
+dsh plugin --profile web add <下载路径>/dsh-local-dsh-imagegen-1.0.0.tgz
 ```
 
-然后在该 profile 的 `cordis.patch.yml` 追加插件条目：
+重启 dsh web。
 
-```yaml
-- insert:
-    - id: imagegen
-      name: '@dickpy/dsh-imagegen'
-```
+### 方式四：源码开发启动（最后的选择）
 
-在 profile 目录执行安装并重启 DSH：
+需要改插件源码时才用这种方式：
 
 ```bash
+git clone https://github.com/dickpy/dsh-imagegen.git
+cd dsh-imagegen
 pnpm install
+pnpm run build
+dsh plugin --profile web add link:/绝对路径/dsh-imagegen
 ```
 
-`lib` 内的宿主与客户端 bundle 变更需要重新构建；开发时可运行 `pnpm run watch` 持续构建。
+重启 dsh web；开发时可运行 `pnpm run watch` 持续构建，bundle 变更由 client-hmr 自动热更。
 
 ## 配置 API
 
@@ -121,6 +126,14 @@ pnpm run build      # 构建宿主与 Web bundle
 pnpm run watch      # 持续构建
 ```
 
+## 📬 反馈与提问
+
+- **遇到 Bug**：请使用 [Bug 报告模板](https://github.com/dickpy/dsh-imagegen/issues/new?template=bug_report.yml) 提交，
+  并附带插件版本、DSH 版本、安装方式与复现步骤（**请勿在 issue 中粘贴 API 密钥**）。
+- **功能建议**：请使用 [功能建议模板](https://github.com/dickpy/dsh-imagegen/issues/new?template=feature_request.yml) 提交，
+  描述使用场景与期望效果。
+- **安装 / 使用问题**：先查阅本文档「快速开始」与「配置 API」章节。
+
 ## 许可证
 
 [Apache-2.0](./LICENSE)

package/lib/client.js

@@ -64,24 +64,21 @@ window.__ModuleLoader__.load({
 		var ImageGenApi = class {
 			/** Forward one generate request to the host proxy. */
 			async generate(request) {
-				return { images: (await readEnvelope(await fetch(GENERATE_API, {
+				const body = await readEnvelope(await fetch(GENERATE_API, {
 					method: "POST",
 					headers: { "content-type": "application/json" },
 					body: JSON.stringify(request)
-				}))).images };
+				}));
+				return {
+					images: body.images,
+					...body.history === void 0 ? {} : { history: body.history },
+					...body.historyError === void 0 ? {} : { historyError: body.historyError }
+				};
 			}
 			/** List the host-persisted history (newest first). */
 			async historyList() {
 				return (await readEnvelope(await fetch(HISTORY_API.list, { method: "POST" }))).entries;
 			}
-			/** Append one generation to the host-persisted history. */
-			async historyAppend(entry) {
-				return (await readEnvelope(await fetch(HISTORY_API.append, {
-					method: "POST",
-					headers: { "content-type": "application/json" },
-					body: JSON.stringify({ entry })
-				}))).entries;
-			}
 			/** Remove one history entry by id. */
 			async historyRemove(id) {
 				return (await readEnvelope(await fetch(HISTORY_API.remove, {
@@ -288,7 +285,7 @@ window.__ModuleLoader__.load({
 			"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.",
 			"settings.title": "AI Image (dsh-imagegen)",
@@ -355,85 +352,85 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var panel_module_css_default = {
+			"optionRow": "Yvqh9W_optionRow",
+			"historyPrompt": "Yvqh9W_historyPrompt",
+			"uploadHint": "Yvqh9W_uploadHint",
+			"optionGrid": "Yvqh9W_optionGrid",
+			"historyList": "Yvqh9W_historyList",
+			"paramLabel": "Yvqh9W_paramLabel",
+			"panelTitle": "Yvqh9W_panelTitle",
+			"modelLabel": "Yvqh9W_modelLabel",
 			"referenceActions": "Yvqh9W_referenceActions",
-			"banner": "Yvqh9W_banner",
-			"historyThumb": "Yvqh9W_historyThumb",
-			"configScroll": "Yvqh9W_configScroll",
+			"modePill": "Yvqh9W_modePill",
 			"reference": "Yvqh9W_reference",
-			"card": "Yvqh9W_card",
-			"grid": "Yvqh9W_grid",
-			"download": "Yvqh9W_download",
-			"zoomHint": "Yvqh9W_zoomHint",
+			"modelSelect": "Yvqh9W_modelSelect",
 			"lightbox": "Yvqh9W_lightbox",
-			"optionPill": "Yvqh9W_optionPill",
-			"prompt": "Yvqh9W_prompt",
-			"lightboxImage": "Yvqh9W_lightboxImage",
 			"promptCount": "Yvqh9W_promptCount",
-			"optionRow": "Yvqh9W_optionRow",
-			"modelWrap": "Yvqh9W_modelWrap",
-			"canvasError": "Yvqh9W_canvasError",
-			"lightboxFigure": "Yvqh9W_lightboxFigure",
-			"dshImageGenSpin": "Yvqh9W_dshImageGenSpin",
-			"lightboxDownload": "Yvqh9W_lightboxDownload",
-			"referenceImage": "Yvqh9W_referenceImage",
-			"historyAction": "Yvqh9W_historyAction",
-			"optionGrid": "Yvqh9W_optionGrid",
-			"studio": "Yvqh9W_studio",
-			"entryLabel": "Yvqh9W_entryLabel",
-			"panelHeader": "Yvqh9W_panelHeader",
-			"historyHeader": "Yvqh9W_historyHeader",
-			"historyThumbPlaceholder": "Yvqh9W_historyThumbPlaceholder",
-			"historyInfo": "Yvqh9W_historyInfo",
-			"modeRow": "Yvqh9W_modeRow",
 			"canvasHistoryTag": "Yvqh9W_canvasHistoryTag",
-			"image": "Yvqh9W_image",
-			"canvasState": "Yvqh9W_canvasState",
-			"panelSubtitle": "Yvqh9W_panelSubtitle",
-			"promptFooter": "Yvqh9W_promptFooter",
-			"canvasMeta": "Yvqh9W_canvasMeta",
-			"historyTitle": "Yvqh9W_historyTitle",
-			"canvasEmptyIcon": "Yvqh9W_canvasEmptyIcon",
-			"panelTitle": "Yvqh9W_panelTitle",
-			"paramLabel": "Yvqh9W_paramLabel",
-			"lightboxIndex": "Yvqh9W_lightboxIndex",
-			"historyPrompt": "Yvqh9W_historyPrompt",
 			"imageCaption": "Yvqh9W_imageCaption",
-			"canvasStateTitle": "Yvqh9W_canvasStateTitle",
-			"config": "Yvqh9W_config",
-			"uploadHint": "Yvqh9W_uploadHint",
-			"historyMain": "Yvqh9W_historyMain",
-			"historyClear": "Yvqh9W_historyClear",
-			"modelSelect": "Yvqh9W_modelSelect",
-			"paramGroup": "Yvqh9W_paramGroup",
-			"generateButton": "Yvqh9W_generateButton",
+			"card": "Yvqh9W_card",
+			"canvas": "Yvqh9W_canvas",
 			"historyItem": "Yvqh9W_historyItem",
-			"modelLabel": "Yvqh9W_modelLabel",
-			"historyMeta": "Yvqh9W_historyMeta",
+			"canvasBody": "Yvqh9W_canvasBody",
+			"optionPill": "Yvqh9W_optionPill",
+			"canvasState": "Yvqh9W_canvasState",
+			"footer": "Yvqh9W_footer",
+			"download": "Yvqh9W_download",
+			"lightboxImage": "Yvqh9W_lightboxImage",
+			"uploadIcon": "Yvqh9W_uploadIcon",
 			"bigSpinner": "Yvqh9W_bigSpinner",
-			"modePill": "Yvqh9W_modePill",
+			"lightboxDownload": "Yvqh9W_lightboxDownload",
 			"history": "Yvqh9W_history",
+			"promptFooter": "Yvqh9W_promptFooter",
+			"lightboxIndex": "Yvqh9W_lightboxIndex",
 			"hiddenFile": "Yvqh9W_hiddenFile",
-			"lightboxCaption": "Yvqh9W_lightboxCaption",
+			"historyClear": "Yvqh9W_historyClear",
 			"generateInner": "Yvqh9W_generateInner",
-			"imageCard": "Yvqh9W_imageCard",
-			"view": "Yvqh9W_view",
 			"panel": "Yvqh9W_panel",
-			"historyEmpty": "Yvqh9W_historyEmpty",
-			"spinner": "Yvqh9W_spinner",
-			"paramHint": "Yvqh9W_paramHint",
-			"lightboxNav": "Yvqh9W_lightboxNav",
+			"historyTitle": "Yvqh9W_historyTitle",
+			"view": "Yvqh9W_view",
 			"canvasStateHint": "Yvqh9W_canvasStateHint",
-			"canvas": "Yvqh9W_canvas",
-			"uploadBox": "Yvqh9W_uploadBox",
-			"entry": "Yvqh9W_entry",
-			"canvasBody": "Yvqh9W_canvasBody",
-			"footer": "Yvqh9W_footer",
+			"image": "Yvqh9W_image",
+			"panelSubtitle": "Yvqh9W_panelSubtitle",
+			"historyInfo": "Yvqh9W_historyInfo",
+			"canvasMeta": "Yvqh9W_canvasMeta",
+			"historyHeader": "Yvqh9W_historyHeader",
 			"entryIcon": "Yvqh9W_entryIcon",
-			"historyList": "Yvqh9W_historyList",
-			"lightboxClose": "Yvqh9W_lightboxClose",
+			"banner": "Yvqh9W_banner",
+			"generateButton": "Yvqh9W_generateButton",
+			"lightboxNav": "Yvqh9W_lightboxNav",
+			"historyMain": "Yvqh9W_historyMain",
+			"configScroll": "Yvqh9W_configScroll",
+			"paramHint": "Yvqh9W_paramHint",
 			"lightboxMeta": "Yvqh9W_lightboxMeta",
-			"uploadIcon": "Yvqh9W_uploadIcon",
-			"historyActions": "Yvqh9W_historyActions"
+			"config": "Yvqh9W_config",
+			"panelHeader": "Yvqh9W_panelHeader",
+			"canvasError": "Yvqh9W_canvasError",
+			"entry": "Yvqh9W_entry",
+			"modelWrap": "Yvqh9W_modelWrap",
+			"studio": "Yvqh9W_studio",
+			"modeRow": "Yvqh9W_modeRow",
+			"prompt": "Yvqh9W_prompt",
+			"historyActions": "Yvqh9W_historyActions",
+			"imageCard": "Yvqh9W_imageCard",
+			"dshImageGenSpin": "Yvqh9W_dshImageGenSpin",
+			"lightboxClose": "Yvqh9W_lightboxClose",
+			"uploadBox": "Yvqh9W_uploadBox",
+			"historyEmpty": "Yvqh9W_historyEmpty",
+			"canvasStateTitle": "Yvqh9W_canvasStateTitle",
+			"lightboxFigure": "Yvqh9W_lightboxFigure",
+			"lightboxCaption": "Yvqh9W_lightboxCaption",
+			"paramGroup": "Yvqh9W_paramGroup",
+			"entryLabel": "Yvqh9W_entryLabel",
+			"historyAction": "Yvqh9W_historyAction",
+			"canvasEmptyIcon": "Yvqh9W_canvasEmptyIcon",
+			"zoomHint": "Yvqh9W_zoomHint",
+			"historyMeta": "Yvqh9W_historyMeta",
+			"grid": "Yvqh9W_grid",
+			"historyThumbPlaceholder": "Yvqh9W_historyThumbPlaceholder",
+			"spinner": "Yvqh9W_spinner",
+			"historyThumb": "Yvqh9W_historyThumb",
+			"referenceImage": "Yvqh9W_referenceImage"
 		};
 		//#endregion
 		//#region src/client/ImageGenPanel.tsx
@@ -611,7 +608,8 @@ window.__ModuleLoader__.load({
 					quality,
 					n: count,
 					detail,
-					...mode === "edit" && refImage !== null ? { image: refImage.dataUrl } : {}
+					...mode === "edit" && refImage !== null ? { image: refImage.dataUrl } : {},
+					...mode === "edit" && refImage !== null ? { refName: refImage.name } : {}
 				};
 				setGenerating(true);
 				setError(null);
@@ -621,22 +619,8 @@ window.__ModuleLoader__.load({
 					const result = await api.generate(request);
 					setImages(result.images);
 					setViewingHistoryId(null);
-					const entry = {
-						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 {}
+					if (result.history !== void 0) setHistory(result.history);
+					if (result.historyError !== void 0) setError(result.historyError);
 				} catch (caught) {
 					setError(errorMessage(caught));
 				} finally {
@@ -1786,32 +1770,32 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var settings_card_module_css_default = {
-			"discard": "i1cc5G_discard",
-			"readOnly": "i1cc5G_readOnly",
-			"chevron": "i1cc5G_chevron",
-			"save": "i1cc5G_save",
-			"reset": "i1cc5G_reset",
-			"header": "i1cc5G_header",
-			"headText": "i1cc5G_headText",
-			"label": "i1cc5G_label",
+			"card": "i1cc5G_card",
+			"badges": "i1cc5G_badges",
 			"select": "i1cc5G_select",
-			"footer": "i1cc5G_footer",
-			"inputInvalid": "i1cc5G_inputInvalid",
+			"body": "i1cc5G_body",
+			"headText": "i1cc5G_headText",
+			"name": "i1cc5G_name",
+			"chevron": "i1cc5G_chevron",
+			"pending": "i1cc5G_pending",
+			"description": "i1cc5G_description",
 			"badge": "i1cc5G_badge",
+			"reset": "i1cc5G_reset",
 			"input": "i1cc5G_input",
-			"card": "i1cc5G_card",
-			"badges": "i1cc5G_badges",
 			"hint": "i1cc5G_hint",
+			"readOnly": "i1cc5G_readOnly",
+			"header": "i1cc5G_header",
 			"chevronOpen": "i1cc5G_chevronOpen",
-			"body": "i1cc5G_body",
 			"field": "i1cc5G_field",
-			"pending": "i1cc5G_pending",
 			"notExposed": "i1cc5G_notExposed",
 			"head": "i1cc5G_head",
+			"footer": "i1cc5G_footer",
 			"invalid": "i1cc5G_invalid",
+			"discard": "i1cc5G_discard",
+			"save": "i1cc5G_save",
+			"inputInvalid": "i1cc5G_inputInvalid",
 			"failed": "i1cc5G_failed",
-			"name": "i1cc5G_name",
-			"description": "i1cc5G_description"
+			"label": "i1cc5G_label"
 		};
 		//#endregion
 		//#region src/client/SettingsCard.tsx