@dickpy/dsh-imagegen 1.2.1 → 1.2.3

package/README.md

@@ -22,7 +22,8 @@
   <strong>
     <a href="#gallery">画廊管理</a>&nbsp;&nbsp;&nbsp;|
     <a href="#quick-start">快速开始</a>&nbsp;&nbsp;&nbsp;|
-    <a href="#configuration">配置模型</a>
+    <a href="#configuration">配置模型</a>&nbsp;&nbsp;&nbsp;|
+    <a href="#community">交流群</a>
   </strong>
 </p>
 
@@ -31,8 +32,8 @@
 
 | 过去要反复做的事 | 现在的工作方式 |
 | --- | --- |
-| 在对话、网页生图工具和本地文件夹之间切换 | 在 DSH 对话里描述目标，Agent 提交任务并把图片直接回贴到当前消息流 |
-| 生图耗时很长，只能盯着页面或不断询问状态 | 任务进入宿主侧后台队列；你可以继续工作，完成结果会回到对话和工作台 |
+| 在对话、网页生图工具和本地文件夹之间切换 | 在 DSH 对话里描述目标，Agent 等待任务并把图片作为工具结果直接显示 |
+| 生图耗时很长，只能盯着页面或不断询问状态 | Agent 工具调用会保持等待直到完成，结果同时保存在对话和工作台 |
 | 第一张图不对，就重新组织全部提示词 | 直接说“换成黄色”“保留构图但改成夜景”，Agent 复用上一张图继续图生图 |
 | 多个模型各有优缺点，难以公平比较 | 用同一提示词和参数并行生成，在并列全屏视图中挑选结果 |
 | 收藏变多后无法找回、筛选或导出 | 画廊支持瀑布流、搜索、标签、批量下载和 JSON 备份 |
@@ -40,11 +41,11 @@
 <a id="agent-workflow"></a>
 ## Agent 对话生图与连续编辑
 
-这是插件的核心体验。开启“允许 Agent 调用生图”后，直接在 DSH 对话中说出你想要的画面即可。Agent 会从已允许的模型中选择合适项，提交后台任务；任务完成时，真实图片会作为附件回贴在对话中。
+这是插件的核心体验。开启“允许 Agent 调用生图”后，直接在 DSH 对话中说出你想要的画面即可。Agent 会从已允许的模型中选择合适项，提交任务并等待完成；真实图片会作为工具结果附件显示在对话中，不会额外产生一条用户消息。
 
 接着，你可以基于结果继续提出修改。Agent 会携带该图片的引用调用图生图，不必重新上传文件，也不必重新描述全部上下文。它适合快速探索视觉方向、反复打磨 UI 视觉稿、海报或产品素材。
 
-![Agent 在对话中提交海报生成任务，成图自动回贴到消息流](docs/images/agent-chat-poster-workflow.png)
+![Agent 在对话中提交海报生成任务，成图作为工具结果显示](docs/images/agent-chat-poster-workflow.png)
 
 ### 可直接使用的案例提示词
 
@@ -66,9 +67,9 @@ Agent 会把上一轮图片作为参考图提交图生图任务，因此第二
 
 | 工具 | 用途 |
 | --- | --- |
-| `generate_image` | 提交文生图任务，立即返回任务 ID，不阻塞对话。 |
+| `generate_image` | 提交文生图任务，默认等待完成后返回图片附件；传 `wait_for_completion: false` 可改为后台模式。 |
 | `get_image_generation_task` | 查询任务；完成时取回图片附件与下一步编辑所需的图片引用。 |
-| `edit_image` | 以已有图片为参考提交图生图任务。 |
+| `edit_image` | 以已有图片为参考提交图生图任务，默认等待完成后返回图片附件。 |
 | `cancel_image_generation_task` | 取消排队中或正在执行的任务。 |
 
 未配置 API 地址、密钥或可用生图模型时，工具会明确引导到 DSH 的“设置 → 插件 → AI 生图”，而不是静默失败。Agent 调用默认开启，也可按需关闭，仅保留侧边栏工作台。
@@ -132,7 +133,7 @@ Windows 如遇 PowerShell 脚本策略限制，请使用 `dsh.cmd`。安装后
 从 [GitHub Releases](https://github.com/dickpy/dsh-imagegen/releases) 下载 tgz 后执行：
 
 ```bash
-dsh plugin --profile web add <下载路径>/dickpy-dsh-imagegen-1.2.1.tgz
+dsh plugin --profile web add <下载路径>/dickpy-dsh-imagegen-1.2.3.tgz
 ```
 
 <a id="configuration"></a>
@@ -154,8 +155,19 @@ dsh plugin --profile web add <下载路径>/dickpy-dsh-imagegen-1.2.1.tgz
 
 - **OpenAI 兼容接口**：支持 `/images/generations`、`/images/edits` 和 `{ data: [{ b64_json | url }] }` 格式响应。
 - **Grok Imagine**：原生支持 `grok-imagine-image` 与 `grok-imagine-image-2.0`。将地址设为 `https://api.x.ai/v1` 后，图生图会使用其 JSON `image_url` 协议，比例和清晰度映射为 `aspect_ratio` 与 `resolution`。
+- **Nano Banana（谷歌 Gemini 图像系列）**：内置 `nanobanana2` / `nanobanana2-lite` / `nanobanana-pro`（也识别官方 `gemini-3.x-image*` ID）。走 OpenAI 兼容接口时，比例和清晰度映射为 `aspect_ratio` 与 `image_size`（1K/2K/4K），输出请求 base64。
+- **Seedream（字节跳动生图系列）**：内置 `seedream-5.0-pro`（也识别 `seedream-4.x`、`doubao-seedream-…`）。无 `/images/edits`，文生图与图生图统一走 `/images/generations`，参考图以 JSON `image` 数组发送；比例走 `size`，清晰度走 `resolution`（1K/2K，5.0-pro 上限 2K）。
 - **后续模型**：可将 `qwen-image`、Gemini 等 OpenAI 兼容网关模型加入清单；厂商专属鉴权或请求协议需要单独适配。
 
+<a id="community"></a>
+## 交流群
+
+欢迎加入 QQ 群，一起交流 DSH、AI 生图和插件使用体验，也欢迎分享提示词、工作流与改进建议。
+
+<p align="center">
+  <img src="docs/images/community-qq.png" alt="扫码加入 dsh-imagegen QQ 交流群" width="360" />
+</p>
+
 <a id="security"></a>
 ## 数据与安全