@dickpy/dsh-imagegen 1.0.19 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (21) hide show
  1. package/README.md +25 -7
  2. package/docs/images/gallery-workspace.png +0 -0
  3. package/docs/images/multi-model-comparison.png +0 -0
  4. package/lib/client.js +1267 -460
  5. package/lib/client.js.map +1 -1
  6. package/lib/index.js +376 -56
  7. package/package.json +1 -1
  8. package/src/client/ImageGenPanel.tsx +306 -27
  9. package/src/client/SettingsCard.tsx +79 -0
  10. package/src/client/api.ts +37 -1
  11. package/src/client/locales.ts +110 -2
  12. package/src/client/panel.module.css +129 -1
  13. package/src/client/settings-card.module.css +42 -0
  14. package/src/client/settings-scope.ts +22 -1
  15. package/src/engine.ts +4 -3
  16. package/src/gallery-store.ts +15 -1
  17. package/src/index.ts +24 -1
  18. package/src/prompt-enhancer.ts +67 -0
  19. package/src/protocol.ts +32 -2
  20. package/src/routes.ts +133 -39
  21. package/src/task-queue.ts +70 -0
package/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
  [![Node.js](https://img.shields.io/badge/node-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
5
5
  [![Platform](https://img.shields.io/badge/platform-DeepSeek%20Harness-111827)](https://github.com/dickpy/dsh-imagegen)
6
6
 
7
- DeepSeek Harness (DSH) Web GUI 的 AI 生图插件。它通过宿主进程安全地代理 OpenAI 兼容的图像生成接口，为 DSH 提供文生图、图生图编辑、生成历史、提示词模板库和一体化设置页。
7
+ DeepSeek Harness (DSH) Web GUI 的 AI 生图工作台。它通过宿主进程安全地代理 OpenAI 兼容的图像生成接口，把提示词增强、文生图、图生图、后台任务、多模型对比、历史记录与画廊管理放进同一个 DSH 原生界面。
8
8
 
9
9
  > 默认模型为 `gpt-image-2`，也内置对 xAI `grok-imagine-image`（Grok Imagine）的支持；同时兼容提供 `/images/generations` 和 `/images/edits` 的 OpenAI 兼容端点。
10
10
 
@@ -12,7 +12,7 @@ DeepSeek Harness (DSH) Web GUI 的 AI 生图插件。它通过宿主进程安全
12
12
 
13
13
  ### AI 生图工作台
14
14
 
15
- 三栏工作台将参数、生成结果和历史记录放在同一视图中；生成的图片可预览、下载，并从历史记录恢复参数。
15
+ 三栏工作台将参数、生成结果和历史记录放在同一视图中。任务提交后可继续操作；生成的图片可预览、下载，并从历史记录恢复参数。
16
16
 
17
17
  **四图结果布局**
18
18
 
@@ -22,6 +22,12 @@ DeepSeek Harness (DSH) Web GUI 的 AI 生图插件。它通过宿主进程安全
22
22
 
23
23
  ![AI 生图工作台单图结果布局](docs/images/image-generation-studio-single.png)
24
24
 
25
+ ### 多模型并列对比
26
+
27
+ 打开「多模型对比」后，为同一提示词勾选多个模型。任务会进入后台队列，完成后在画布中并列展示，支持进入全屏对比，直观看出不同模型在构图、质感与文字处理上的差异。
28
+
29
+ ![gpt-image-2 与 grok-imagine-image 的多模型并列结果对比](docs/images/multi-model-comparison.png)
30
+
25
31
  ### 提示词模板库
26
32
 
27
33
  模板库提供 441 个 `gpt-image-2` 案例的展示图、分类筛选和完整提示词；打开详情后可以复制提示词，或一键回填到生图输入框。
@@ -34,13 +40,23 @@ DeepSeek Harness (DSH) Web GUI 的 AI 生图插件。它通过宿主进程安全
34
40
 
35
41
  ![插件配置卡片（显示当前版本）](docs/images/plugin-settings.png)
36
42
 
43
+ ### 画廊工作区
44
+
45
+ 画廊标签页提供左侧分类筛选和右侧作品墙：可在瀑布流与整齐网格之间切换，纵向滚动浏览收藏，点击任意图片打开大图预览。支持关键词搜索、自建标签、标签筛选、批量下载与 JSON 导出。
46
+
47
+ ![画廊工作区：分类筛选、瀑布流和大图预览](docs/images/gallery-workspace.png)
48
+
37
49
  ## 功能
38
50
 
39
51
  - **文生图与图生图**：输入提示词生成图片，或上传 PNG、JPG、WEBP 参考图进行编辑。
52
+ - **Grok Imagine 支持**：支持 xAI `grok-imagine-image` 文生图与图生图；将 API 地址设置为 `https://api.x.ai/v1` 即可使用官方比例、分辨率和 JSON 图片协议。
40
53
  - **可调生成参数**：尺寸、清晰度、生成数量和细节等级均可在界面中选择；未指定的参数保持自动。
54
+ - **提示词增强**：对简短描述点击「增强」，使用独立配置或复用现有凭据的对话模型扩写为更完整的生图提示词；未配置时自动跳转到 DSH 的 AI 生图配置卡片。
55
+ - **后台生成任务**：生成请求提交到宿主侧队列，面板不再被单次请求阻塞；可查看排队/生成/完成状态，取消任务或重试失败任务。
56
+ - **多模型对比**：默认关闭；开启后可勾选多个模型，以相同提示词和参数分别生成，在画布和全屏视图并列对比结果。
41
57
  - **结果操作**：结果区固定为四分格：单图铺满，双图占上排，三图占三格，四图为 2×2；支持下载、全屏预览、可滚动缩放、前后切换、复制优化提示词，以及一键将当前图片添加到图生图。
42
- - **画廊收藏**：结果卡片、全屏预览与历史记录条目上都有「加入画廊」，可把满意的图片收藏起来；切到画廊后进入左侧分类筛选、右侧瀑布流/整齐网格的作品墙，支持按生成模式、模型、画面比例筛选、按发布时间排序、预览、移出、清空与恢复参数。画廊持久化在宿主侧 `~/.dsh/dsh-imagegen/gallery/`，无数量上限，且内容相同的图片不会重复加入。
43
- - **持久化历史**：保存提示词、参数和图片；支持查看、恢复、单条删除和清空，最多保留 50 条。
58
+ - **画廊收藏与管理**：结果卡片、全屏预览与历史记录条目上都有「加入画廊」。画廊支持瀑布流/整齐网格、持续纵向滚动、关键词搜索、模式/模型/比例/标签筛选、标签编辑、批量下载与 JSON 元数据导出；收藏持久化在宿主侧 `~/.dsh/dsh-imagegen/gallery/`，无数量上限，且内容相同的图片不会重复加入。
59
+ - **可搜索历史**：保存提示词、参数和图片；支持按关键词、模型与比例筛选，查看、恢复、单条删除和清空，最多保留 50 条。
44
60
  - **跨设备查看**：历史与画廊都保存在 DSH 宿主侧，连接同一 DSH 的浏览器或设备共享同一份记录。
45
61
  - **提示词模板库**：提示词框左下角可打开模板库，浏览 441 个 `gpt-image-2` 案例的展示图；支持搜索、分类筛选、查看完整提示词、复制，以及一键将模板回填到生图输入框。参考图通过宿主同源代理按需加载并缓存，也可手动缓存全部图片供离线浏览。
46
62
  - **原生 DSH 体验**：侧栏入口、主题适配和设置卡片均遵循 DSH Web GUI 的 UI 规范。
@@ -70,10 +86,10 @@ dsh 会自动把插件注册进 profile 的 bundle 清单（无需手动改 cord
70
86
  ### 方式三：聚合包（tarball）安装
71
87
 
72
88
  从 [GitHub Releases](https://github.com/dickpy/dsh-imagegen/releases) 下载发布产物
73
- （如 `dickpy-dsh-imagegen-1.0.9.tgz`），然后：
89
+ （如 `dickpy-dsh-imagegen-1.1.0.tgz`），然后：
74
90
 
75
91
  ```bash
76
- dsh plugin --profile web add <下载路径>/dickpy-dsh-imagegen-1.0.9.tgz
92
+ dsh plugin --profile web add <下载路径>/dickpy-dsh-imagegen-1.1.0.tgz
77
93
  ```
78
94
 
79
95
  重启 dsh web。
@@ -100,6 +116,8 @@ dsh plugin --profile web add link:/绝对路径/dsh-imagegen
100
116
  | --- | --- |
101
117
  | `api_url` | OpenAI 兼容接口根地址，例如 `https://api.openai.com/v1`。插件会自动追加接口路径。 |
102
118
  | `api_key` | Bearer API 密钥。界面仅显示是否已配置；输入新值可覆盖，清空后保存可删除。 |
119
+ | 对话 API 地址 / 密钥 | 可选；用于提示词增强，留空时复用生图 API 地址与密钥。 |
120
+ | 对话模型 | 用于提示词增强的 `/chat/completions` 模型；可从设置卡片获取可用模型后选择。 |
103
121
  | 启用插件 | 关闭后生图工作台不可用，设置卡片仍可用于重新启用。 |
104
122
  | 向 Agent 播报 | 开启后，将插件能力写入 Agent 系统提示词。 |
105
123
 
@@ -119,7 +137,7 @@ Grok Imagine 模型（`grok-imagine-image` / `grok-imagine-image-2.0`）的请
119
137
 
120
138
  ## 画廊与 Grok Imagine
121
139
 
122
- 画廊提供独立的作品浏览工作区：左侧按生成模式、模型和画面比例筛选，右侧以纵向瀑布流或整齐网格展示收藏图片，支持发布时间排序、持续向下滚动、点击卡片打开大图预览、恢复参数、移出和清空。收藏数据由 DSH 宿主持久化到 `~/.dsh/dsh-imagegen/gallery/`，同一图片内容不会重复保存。
140
+ 画廊提供独立的作品浏览工作区：左侧按生成模式、模型、画面比例和自建标签筛选，右侧以纵向瀑布流或整齐网格展示收藏图片。支持关键词搜索、标签新建/编辑/筛选、批量下载、JSON 元数据导出、发布时间排序、持续向下滚动、点击卡片打开大图预览、恢复参数、移出和清空。收藏数据由 DSH 宿主持久化到 `~/.dsh/dsh-imagegen/gallery/`，同一图片内容不会重复保存。
123
141
 
124
142
  插件原生支持 xAI `grok-imagine-image`。将 API 地址设置为 `https://api.x.ai/v1` 后，文生图使用 `/images/generations`，图生图按 Grok Imagine 的 JSON `image_url` 协议调用 `/images/edits`；界面中的比例和清晰度会分别映射为 `aspect_ratio` 与 `resolution`。
125
143