dsh-image-gen 0.4.1 → 0.5.0

package/README.en.md

@@ -1,338 +1,344 @@
-<div align="center">
-
-<img src="docs/assets/readme/hero-en.webp" alt="dsh-image-gen feature overview" width="100%" />
-
-<br />
-
-<p><a href="README.md">简体中文</a> · <strong>English</strong></p>
-
-# 🎨 dsh-image-gen
-
-### Native AI image creation suite for DeepSeek Harness
-
-<p><b>In-chat generation and editing · Studio batch creation · Multi-model comparison · 500+ prompt inspirations · Gallery management · Local ComfyUI</b></p>
-
-<p>
-  <a href="https://www.npmjs.com/package/dsh-image-gen"><img src="https://img.shields.io/npm/v/dsh-image-gen?style=flat-square&color=4f6ef7" alt="npm version" /></a>
-  <a href="https://www.npmjs.com/package/dsh-image-gen"><img src="https://img.shields.io/npm/dm/dsh-image-gen?style=flat-square&color=10b981" alt="npm downloads" /></a>
-  <a href="https://github.com/shanliuling/dsh-image-gen/actions/workflows/ci.yml"><img src="https://github.com/shanliuling/dsh-image-gen/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
-  <a href="https://github.com/shanliuling/dsh-image-gen/stargazers"><img src="https://img.shields.io/github/stars/shanliuling/dsh-image-gen?style=flat-square" alt="GitHub stars" /></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-f5c542?style=flat-square" alt="License: MIT" /></a>
-  <a href="https://linux.do/"><img src="https://img.shields.io/badge/LINUX%20DO-Community-555?style=flat-square" alt="LINUX DO" /></a>
-</p>
-
-<p>
-  <a href="#quick-start">Quick Start</a> ·
-  <a href="#core-capabilities">Core Capabilities</a> ·
-  <a href="#provider-support">Provider Support</a> ·
-  <a href="#faq">FAQ</a>
-</p>
-
-<br />
-
-</div>
-
-**A complete AI image creation workflow for DeepSeek Harness.**
-
-`dsh-image-gen` goes far beyond basic in-chat image generation. It brings **continuous natural-language editing**, **Studio batch creation**, **side-by-side multi-model comparison**, a **500+ prompt inspiration library**, and **local ComfyUI** workflows into DSH. It supports **Google Gemini, OpenAI Images / Compatible, ByteDance Seedream, Aliyun DashScope**, and private local workflows. It uses a BYOK model and can isolate generated assets by workspace.
-
-```bash
-pnpm dsh plugin --profile web add dsh-image-gen@latest
-```
-
-> **Update notice:** This release includes major changes. Existing users should update to the latest version.
-
-<img src="docs/assets/readme/workflow-overview.webp" alt="dsh-image-gen complete AI image creation workflow" width="100%" />
-
----
-
-## One plugin, four creative workflows
-
-| Entry | Best for | What you can do |
-| :--- | :--- | :--- |
-| 💬 **Chat** | Letting the Agent understand natural-language requests | Text-to-image, image-to-image, multi-image reference, continuous editing, and in-place regeneration |
-| 🎛️ **Studio** | Precise control over creation parameters | Batch generation, multiple reference images, and advanced canvas |
-| ✨ **Inspiration** | Finding compositions, styles, and prompts | Browse 500+ examples, search and filter, favorite, copy, or send a prompt to Studio |
-| 🖼️ **Gallery** | Organizing and reusing generated results | Search, filter, favorite, regenerate, download, batch-manage, and isolate by workspace |
-
----
-
-## Quick Start
-
-### 1. Install the plugin
-
-Requirements: DeepSeek Harness stable version, Node.js `^22.19.0` or `>= 24.0.0`.
-
-Run this command from your DeepSeek Harness project root:
-
-```bash
-pnpm dsh plugin --profile web add dsh-image-gen@latest
-```
-
-> 💬 **Power-user tip:** You can also send this directly to the Agent in a DSH chat:<br />
-> `Install the image generation plugin by running this command in the terminal: pnpm dsh plugin --profile web add dsh-image-gen@latest`
-
-<details>
-<summary><strong>Alternative installation methods (global / GitHub / local development)</strong></summary>
-
-```bash
-# If dsh is installed globally:
-dsh plugin --profile web add dsh-image-gen@latest
-
-# Install the latest source directly from GitHub:
-pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
-
-# Clone the repository and install it for local development:
-git clone https://github.com/shanliuling/dsh-image-gen.git
-pnpm dsh plugin --profile web add ./dsh-image-gen
-```
-
-</details>
-
-### 2. Configure a Provider
-
-After restarting DSH, open:
-
-**Settings → Plugins → Plugin Configuration → Image Generation**
-
-Choose a Provider, enter your API key, and adjust the model, Endpoint / Base URL, and workspace-save options as needed. For ComfyUI, enter an address reachable by the DSH Host and import an **API Format Workflow JSON** file.
-
-### 3. Start creating
-
-Describe the image you want directly in chat:
-
-```text
-Create a cinematic cyberpunk cat on a neon street at night, 16:9.
-```
-
-You can also upload a reference image directly for style transfer or editing:
-
-```text
-Keep the character and composition unchanged, then add black sunglasses to the cat.
-```
-
-<br />
-
-<div align="center">
-  <img src="docs/assets/readme/provider-settings.webp" alt="DSH Plugin Settings" width="46%" />
-  <img src="docs/assets/readme/chat-example.webp" alt="Chat generation and editing example" width="46%" />
-  <br />
-  <sub>Left: Provider Settings · Right: In-chat generation, editing, and continuous refinement.</sub>
-</div>
-
-<br />
-
-For more precise parameter control, open **Gallery** from the conversation header, then switch between **Gallery / Studio / Inspiration / Favorites**.
-
----
-
-## Core Capabilities
-
-### 💬 In-chat generation, editing, and revision switching
-
-- Use natural language for text-to-image, image-to-image, multi-image reference, and style transfer.
-- Edit the original prompt to regenerate, then switch between revisions on the same image card.
-
-<br />
-
-<div align="center">
-  <img src="docs/assets/readme/regenerating.webp" alt="Image regeneration in progress" width="46%" />
-  <img src="docs/assets/readme/revision-switcher.webp" alt="Switching between generated revisions on the same image card" width="46%" />
-  <br />
-  <sub>Regenerate in place after editing the prompt, then switch between previous results on the same image card.</sub>
-</div>
-
-<br />
-
-### 🎛️ Studio batch creation
-
-- Support multiple reference images, and generate multiple candidates at a time.
-- Control the Provider, model, aspect ratio, and quality, then save only the results you want.
-
-<br />
-
-<div align="center">
-  <img src="docs/assets/readme/studio-workbench.webp" alt="dsh-image-gen Studio workbench" width="100%" />
-  <br />
-  <sub>Import references, control parameters, generate batches, select results, and save—all within one Studio.</sub>
-</div>
-
-<br />
-
-### ⚖️ Side-by-side multi-model comparison
-
-Run the same prompt and reference images across multiple models, then compare and save the results on one canvas.
-
-<br />
-
-<div align="center">
-  <img src="docs/assets/readme/multi-model-compare.webp" alt="Comparing the same prompt across multiple image models" width="100%" />
-  <br />
-  <sub>Compare results from different models on one canvas, then save the images you prefer in a batch.</sub>
-</div>
-
-<br />
-
-### ✨ 500+ prompt inspiration examples
-
-- Browse and filter **500+ prompt examples**, then favorite, copy, or send them directly to Studio.
-- Images are cached locally, so browsing and learning consume no tokens or generation quota.
-
-<br />
-
-<div align="center">
-  <img src="docs/assets/readme/inspiration-library.webp" alt="Prompt inspiration library" width="100%" />
-  <br />
-  <sub>Find inspiration first, then send a prompt to Studio. Browsing and copying from the local cache consume no generation quota.</sub>
-</div>
-
-<br />
-
-### 🖼️ Gallery, favorites, and batch management
-
-- Manage images saved from chat and Studio in one place, isolated by workspace.
-- Search, filter, favorite, download, continue editing, regenerate, and batch-manage results.
-
-<br />
-
-<div align="center">
-  <img src="docs/assets/readme/gallery-management.webp" alt="Gallery filtering, favorites, and batch management" width="100%" />
-  <br />
-  <sub>Filter, favorite, and batch-manage gallery items while keeping data isolated by workspace.</sub>
-</div>
-
-<br />
-
-### 🧩 Multiple local ComfyUI workflows
-
-Bring private image generation on your local GPU directly into Agent conversations.
-
-- Import and manage multiple named workflows with prompt presets and common placeholders.
-- Let the Agent select a workflow by name for text-to-image or image-to-image generation in chat.
-
-> ComfyUI is not yet integrated into Studio or multi-model comparison.
-
-<br />
-
-<div align="center">
-  <img src="docs/assets/readme/comfyui-workflows.webp" alt="Multiple named ComfyUI workflow settings" width="58%" />
-  <br />
-  <sub>Maintain independent workflows for different tasks and let the Agent select them precisely by name.</sub>
-</div>
-
-<br />
-
----
-
-## Provider Support
-
-| Provider | Chat generation | Chat editing | Studio | Multi-model comparison |
-| :--- | :---: | :---: | :---: | :---: |
-| **Google Gemini** | ✅ | ✅ Multiple | ✅ | ✅ |
-| **OpenAI Images / Compatible** | ✅ | ✅ Multiple | ✅ | ✅ |
-| **ByteDance Seedream / Volcengine Ark** | ✅ | ✅ Multiple | ✅ | ✅ |
-| **Aliyun DashScope / Qwen Image** | ✅ | ✅ Multiple | ✅ | ✅ |
-| **Local ComfyUI** | ✅ | ✅ Single | — | — |
-
-> Studio and multi-model comparison currently support cloud Providers only. Multi-model comparison uses the model configured for each Provider in Settings.
-
-<details>
-<summary><strong>Current default models and endpoints (all configurable)</strong></summary>
-
-| Provider | Default model | Default Endpoint / Base URL |
-| :--- | :--- | :--- |
-| Google Gemini | `gemini-3.1-flash-image` | `https://generativelanguage.googleapis.com/v1beta/interactions` |
-| OpenAI Images | `gpt-image-2` | `https://api.openai.com/v1` |
-| OpenAI Compatible | Custom | Custom Base URL |
-| ByteDance Seedream | `doubao-seedream-5-0-260128` | `https://ark.cn-beijing.volces.com/api/v3` |
-| Aliyun DashScope | `qwen-image-3.0` | `https://dashscope.aliyuncs.com/api/v1` |
-| Local ComfyUI | Imported API Workflow | `http://127.0.0.1:8188` |
-
-</details>
-
----
-
-## Data and Privacy
-
-- **BYOK:** API keys are stored through the DSH Credentials service and are never displayed in plaintext on the settings page.
-- **Cloud requests:** The prompt and reference images used for a request are sent to the selected Provider. Follow that Provider's terms of service.
-- **Local ComfyUI:** Requests are sent to the configured ComfyUI address.
-- **Workspace files:** When workspace saving is enabled, chat results are written to disk; Studio saves only the candidates you select.
-- **Gallery and favorites:** Gallery metadata and favorite state are stored in the current browser's local storage.
-- **Inspiration cache:** Example metadata ships with the plugin. Images load on demand and are cached locally, and the cache can be cleared at any time.
-
-## FAQ
-
-<details>
-<summary><strong>What should I do if “Image Generation” is missing after installation?</strong></summary>
-
-Fully restart the current DSH Profile, then inspect the plugin configuration:
-
-```bash
-dsh --profile web --dump-config
-```
-
-If `dsh-image-gen` is absent from the output, run the installation command again. When filing an issue, include the DSH version, plugin version, and relevant error logs, but never include your API key.
-
-</details>
-
-<details>
-<summary><strong>Where are generated images saved?</strong></summary>
-
-When “Save to workspace” is enabled, chat results are saved to the `dsh-image-gen/` subdirectory of the current workspace by default. You can change this directory in Settings. Studio candidates remain on the temporary canvas until you select which results should enter the gallery and be saved.
-
-</details>
-
-<details>
-<summary><strong>Why is ComfyUI not available in Studio?</strong></summary>
-
-Studio and multi-model comparison currently support four cloud Provider families only. ComfyUI supports text-to-image, single-image editing, and multiple named workflows through Agent chat.
-
-</details>
-
-<details>
-<summary><strong>Does deleting an item from the gallery remove its chat message?</strong></summary>
-
-No. Deleting a gallery record does not modify the original chat message. You may separately choose to remove the corresponding local image file from the workspace. File deletion is normally irreversible, so confirm carefully.
-
-</details>
-
-<details>
-<summary><strong>How do I upgrade?</strong></summary>
-
-```bash
-pnpm dsh plugin --profile web add dsh-image-gen@latest
-```
-
-Restart the corresponding DSH Profile after upgrading.
-
-</details>
-
----
-
-## Local Development
-
-```bash
-git clone https://github.com/shanliuling/dsh-image-gen.git
-cd dsh-image-gen
-
-pnpm install
-pnpm run typecheck
-pnpm test
-pnpm run build
-pnpm run pack:check
-```
-
-Feedback is welcome through [Issues](https://github.com/shanliuling/dsh-image-gen/issues). Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a Pull Request.
-
-## License
-
-This project is open source under the [MIT License](LICENSE).
-
-<div align="center">
-
-If `dsh-image-gen` improves your workflow, consider giving the project a ⭐ **Star** to support continued maintenance.
-
-**[View Releases](https://github.com/shanliuling/dsh-image-gen/releases) · [Open an Issue](https://github.com/shanliuling/dsh-image-gen/issues) · [Contribute](CONTRIBUTING.md)**
-
-</div>
+<div align="center">
+
+<img src="docs/assets/readme/hero-en.webp" alt="dsh-image-gen feature overview" width="100%" />
+
+<br />
+
+<p><a href="README.md">简体中文</a> · <strong>English</strong></p>
+
+# 🎨 dsh-image-gen
+
+### Native AI image creation suite for DeepSeek Harness
+
+<p><b>In-chat generation and editing · Studio batch creation · Multi-model comparison · 500+ prompt inspirations · Gallery management · Local ComfyUI</b></p>
+
+<p>
+  <a href="https://www.npmjs.com/package/dsh-image-gen"><img src="https://img.shields.io/npm/v/dsh-image-gen?style=flat-square&color=4f6ef7" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/dsh-image-gen"><img src="https://img.shields.io/npm/dm/dsh-image-gen?style=flat-square&color=10b981" alt="npm downloads" /></a>
+  <a href="https://github.com/shanliuling/dsh-image-gen/actions/workflows/ci.yml"><img src="https://github.com/shanliuling/dsh-image-gen/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
+  <a href="https://github.com/shanliuling/dsh-image-gen/stargazers"><img src="https://img.shields.io/github/stars/shanliuling/dsh-image-gen?style=flat-square" alt="GitHub stars" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-f5c542?style=flat-square" alt="License: MIT" /></a>
+  <a href="https://linux.do/"><img src="https://img.shields.io/badge/LINUX%20DO-Community-555?style=flat-square" alt="LINUX DO" /></a>
+</p>
+
+<p>
+  <a href="#quick-start">Quick Start</a> ·
+  <a href="#core-capabilities">Core Capabilities</a> ·
+  <a href="#provider-support">Provider Support</a> ·
+  <a href="#faq">FAQ</a>
+</p>
+
+<br />
+
+</div>
+
+**A complete AI image creation workflow for DeepSeek Harness.**
+
+`dsh-image-gen` goes far beyond basic in-chat image generation. It brings **continuous natural-language editing**, **Studio batch creation**, **side-by-side multi-model comparison**, a **500+ prompt inspiration library**, and **local ComfyUI** workflows into DSH. It supports **Google Gemini, OpenAI Images / Compatible, ByteDance Seedream, Aliyun DashScope, xAI Grok Imagine, Zhipu GLM-Image**, and private local workflows. It uses a BYOK model and can isolate generated assets by workspace.
+
+```bash
+pnpm dsh plugin --profile web add dsh-image-gen@latest
+```
+
+> **Update notice:** This release includes major changes. Existing users should update to the latest version.
+
+<img src="docs/assets/readme/workflow-overview.webp" alt="dsh-image-gen complete AI image creation workflow" width="100%" />
+
+---
+
+## One plugin, four creative workflows
+
+| Entry | Best for | What you can do |
+| :--- | :--- | :--- |
+| 💬 **Chat** | Letting the Agent understand natural-language requests | Text-to-image, image-to-image, multi-image reference, continuous editing, and in-place regeneration |
+| 🎛️ **Studio** | Precise control over creation parameters | Batch generation, multiple reference images, and advanced canvas |
+| ✨ **Inspiration** | Finding compositions, styles, and prompts | Browse 500+ examples, search and filter, favorite, copy, or send a prompt to Studio |
+| 🖼️ **Gallery** | Organizing and reusing generated results | Search, filter, favorite, regenerate, download, batch-manage, and isolate by workspace |
+
+---
+
+## Quick Start
+
+### 1. Install the plugin
+
+Requirements: DeepSeek Harness stable version, Node.js `^22.19.0` or `>= 24.0.0`.
+
+Run this command from your DeepSeek Harness project root:
+
+```bash
+pnpm dsh plugin --profile web add dsh-image-gen@latest
+```
+
+> 💬 **Power-user tip:** You can also send this directly to the Agent in a DSH chat:<br />
+> `Install the image generation plugin by running this command in the terminal: pnpm dsh plugin --profile web add dsh-image-gen@latest`
+
+<details>
+<summary><strong>Alternative installation methods (global / GitHub / local development)</strong></summary>
+
+```bash
+# If dsh is installed globally:
+dsh plugin --profile web add dsh-image-gen@latest
+
+# Install the latest source directly from GitHub:
+pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
+
+# Clone the repository and install it for local development:
+git clone https://github.com/shanliuling/dsh-image-gen.git
+pnpm dsh plugin --profile web add ./dsh-image-gen
+```
+
+</details>
+
+### 2. Configure a Provider
+
+After restarting DSH, open:
+
+**Settings → Plugins → Plugin Configuration → Image Generation**
+
+Choose a Provider, enter your API key, and adjust the model, Endpoint / Base URL, and workspace-save options as needed. Once the key is stored, click **Test connection** to verify it, or **Fetch models** to pull every image-capable model the provider offers—no manual lookups needed. For ComfyUI, enter an address reachable by the DSH Host and import an **API Format Workflow JSON** file.
+
+### 3. Start creating
+
+Describe the image you want directly in chat:
+
+```text
+Create a cinematic cyberpunk cat on a neon street at night, 16:9.
+```
+
+You can also upload a reference image directly for style transfer or editing:
+
+```text
+Keep the character and composition unchanged, then add black sunglasses to the cat.
+```
+
+<br />
+
+<div align="center">
+  <img src="docs/assets/readme/provider-settings.webp" alt="DSH Plugin Settings" width="46%" />
+  <img src="docs/assets/readme/chat-example.webp" alt="Chat generation and editing example" width="46%" />
+  <br />
+  <sub>Left: Provider Settings · Right: In-chat generation, editing, and continuous refinement.</sub>
+</div>
+
+<br />
+
+For more precise parameter control, open **Gallery** from the conversation header, then switch between **Gallery / Studio / Inspiration / Favorites**.
+
+---
+
+## Core Capabilities
+
+### 💬 In-chat generation, editing, and revision switching
+
+- Use natural language for text-to-image, image-to-image, multi-image reference, and style transfer.
+- Edit the original prompt to regenerate, then switch between revisions on the same image card.
+
+<br />
+
+<div align="center">
+  <img src="docs/assets/readme/regenerating.webp" alt="Image regeneration in progress" width="46%" />
+  <img src="docs/assets/readme/revision-switcher.webp" alt="Switching between generated revisions on the same image card" width="46%" />
+  <br />
+  <sub>Regenerate in place after editing the prompt, then switch between previous results on the same image card.</sub>
+</div>
+
+<br />
+
+### 🎛️ Studio batch creation
+
+- Support multiple reference images, and generate multiple candidates at a time.
+- Control the Provider, model, aspect ratio, and quality, then save only the results you want.
+
+<br />
+
+<div align="center">
+  <img src="docs/assets/readme/studio-workbench.webp" alt="dsh-image-gen Studio workbench" width="100%" />
+  <br />
+  <sub>Import references, control parameters, generate batches, select results, and save—all within one Studio.</sub>
+</div>
+
+<br />
+
+### ⚖️ Side-by-side multi-model comparison
+
+Run the same prompt and reference images across multiple models, then compare and save the results on one canvas.
+
+<br />
+
+<div align="center">
+  <img src="docs/assets/readme/multi-model-compare.webp" alt="Comparing the same prompt across multiple image models" width="100%" />
+  <br />
+  <sub>Compare results from different models on one canvas, then save the images you prefer in a batch.</sub>
+</div>
+
+<br />
+
+### ✨ 500+ prompt inspiration examples
+
+- Browse and filter **500+ prompt examples**, then favorite, copy, or send them directly to Studio.
+- Images are cached locally, so browsing and learning consume no tokens or generation quota.
+
+<br />
+
+<div align="center">
+  <img src="docs/assets/readme/inspiration-library.webp" alt="Prompt inspiration library" width="100%" />
+  <br />
+  <sub>Find inspiration first, then send a prompt to Studio. Browsing and copying from the local cache consume no generation quota.</sub>
+</div>
+
+<br />
+
+### 🖼️ Gallery, favorites, and batch management
+
+- Manage images saved from chat and Studio in one place, isolated by workspace.
+- Search, filter, favorite, download, continue editing, regenerate, and batch-manage results.
+
+<br />
+
+<div align="center">
+  <img src="docs/assets/readme/gallery-management.webp" alt="Gallery filtering, favorites, and batch management" width="100%" />
+  <br />
+  <sub>Filter, favorite, and batch-manage gallery items while keeping data isolated by workspace.</sub>
+</div>
+
+<br />
+
+### 🧩 Multiple local ComfyUI workflows
+
+Bring private image generation on your local GPU directly into Agent conversations.
+
+- Import and manage multiple named workflows with prompt presets and common placeholders.
+- Let the Agent select a workflow by name for text-to-image or image-to-image generation in chat.
+
+> ComfyUI is not yet integrated into Studio or multi-model comparison.
+
+<br />
+
+<div align="center">
+  <img src="docs/assets/readme/comfyui-workflows.webp" alt="Multiple named ComfyUI workflow settings" width="58%" />
+  <br />
+  <sub>Maintain independent workflows for different tasks and let the Agent select them precisely by name.</sub>
+</div>
+
+<br />
+
+---
+
+## Provider Support
+
+| Provider | Chat generation | Chat editing | Studio | Multi-model comparison |
+| :--- | :---: | :---: | :---: | :---: |
+| **Google Gemini** | ✅ | ✅ Multiple | ✅ | ✅ |
+| **OpenAI Images** | ✅ | ✅ Multiple | ✅ | ✅ |
+| **OpenAI Compatible (relay)** | ✅ | ✅ Multiple | ✅ | ✅ |
+| **ByteDance Seedream / Volcengine Ark** | ✅ | ✅ Multiple | ✅ | ✅ |
+| **Aliyun DashScope / Qwen Image** | ✅ | ✅ Multiple | ✅ | ✅ |
+| **xAI Grok Imagine** | ✅ | ⚠️ Limited | ✅ | ✅ |
+| **Zhipu GLM-Image** | ✅ | — | ✅ | ✅ |
+| **Local ComfyUI** | ✅ | ✅ Single | — | — |
+
+> Studio and multi-model comparison currently support cloud Providers only. Multi-model comparison uses the model configured for each Provider in Settings.
+> Zhipu GLM-Image does not support image-to-image upstream. xAI image editing goes through the OpenAI-compatible protocol (multipart); some gateways may need further adaptation.
+
+<details>
+<summary><strong>Current default models and endpoints (all configurable)</strong></summary>
+
+| Provider | Default model | Default Endpoint / Base URL |
+| :--- | :--- | :--- |
+| Google Gemini | `gemini-3.1-flash-image` | `https://generativelanguage.googleapis.com/v1beta/interactions` |
+| OpenAI Images | `gpt-image-2` | `https://api.openai.com/v1` |
+| OpenAI Compatible | Custom | Custom Base URL |
+| ByteDance Seedream | `doubao-seedream-5-0-260128` | `https://ark.cn-beijing.volces.com/api/v3` |
+| Aliyun DashScope | `qwen-image-3.0` | `https://dashscope.aliyuncs.com/api/v1` |
+| xAI Grok Imagine | `grok-imagine-image` | `https://api.x.ai/v1` |
+| Zhipu GLM-Image | `glm-image` | `https://open.bigmodel.cn/api/paas/v4` |
+| Local ComfyUI | Imported API Workflow | `http://127.0.0.1:8188` |
+
+</details>
+
+---
+
+## Data and Privacy
+
+- **BYOK:** API keys are stored through the DSH Credentials service and are never displayed in plaintext on the settings page.
+- **Cloud requests:** The prompt and reference images used for a request are sent to the selected Provider. Follow that Provider's terms of service.
+- **Local ComfyUI:** Requests are sent to the configured ComfyUI address.
+- **Workspace files:** When workspace saving is enabled, chat results are written to disk; Studio saves only the candidates you select.
+- **Gallery and favorites:** Gallery metadata and favorite state are stored in the current browser's local storage.
+- **Inspiration cache:** Example metadata ships with the plugin. Images load on demand and are cached locally, and the cache can be cleared at any time.
+
+## FAQ
+
+<details>
+<summary><strong>What should I do if “Image Generation” is missing after installation?</strong></summary>
+
+Fully restart the current DSH Profile, then inspect the plugin configuration:
+
+```bash
+dsh --profile web --dump-config
+```
+
+If `dsh-image-gen` is absent from the output, run the installation command again. When filing an issue, include the DSH version, plugin version, and relevant error logs, but never include your API key.
+
+</details>
+
+<details>
+<summary><strong>Where are generated images saved?</strong></summary>
+
+When “Save to workspace” is enabled, chat results are saved to the `dsh-image-gen/` subdirectory of the current workspace by default. You can change this directory in Settings. Studio candidates remain on the temporary canvas until you select which results should enter the gallery and be saved.
+
+</details>
+
+<details>
+<summary><strong>Why is ComfyUI not available in Studio?</strong></summary>
+
+Studio and multi-model comparison currently support cloud Providers only; ComfyUI is not yet integrated. ComfyUI supports text-to-image, single-image editing, and multiple named workflows through Agent chat.
+
+</details>
+
+<details>
+<summary><strong>Does deleting an item from the gallery remove its chat message?</strong></summary>
+
+No. Deleting a gallery record does not modify the original chat message. You may separately choose to remove the corresponding local image file from the workspace. File deletion is normally irreversible, so confirm carefully.
+
+</details>
+
+<details>
+<summary><strong>How do I upgrade?</strong></summary>
+
+```bash
+pnpm dsh plugin --profile web add dsh-image-gen@latest
+```
+
+Restart the corresponding DSH Profile after upgrading.
+
+</details>
+
+---
+
+## Local Development
+
+```bash
+git clone https://github.com/shanliuling/dsh-image-gen.git
+cd dsh-image-gen
+
+pnpm install
+pnpm run typecheck
+pnpm test
+pnpm run build
+pnpm run pack:check
+```
+
+Feedback is welcome through [Issues](https://github.com/shanliuling/dsh-image-gen/issues). Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a Pull Request.
+
+## License
+
+This project is open source under the [MIT License](LICENSE).
+
+<div align="center">
+
+If `dsh-image-gen` improves your workflow, consider giving the project a ⭐ **Star** to support continued maintenance.
+
+**[View Releases](https://github.com/shanliuling/dsh-image-gen/releases) · [Open an Issue](https://github.com/shanliuling/dsh-image-gen/issues) · [Contribute](CONTRIBUTING.md)**
+
+</div>