feat: 支持对话与设置页单图编辑

README.md

@@ -7,6 +7,7 @@
 - **接口配置**：设置 Base URL 和 API Key，支持第三方兼容服务。
 - **显式选择模型**：手动维护模型 ID，或从接口读取模型列表；可设置对话默认模型，也可以每次在对话中指定。
 - **对话生图**：助手通过 `imagegen_status` 查询配置，通过 `imagegen_generate` 生成图片。
+- **图片编辑**：对话工具 `imagegen_edit` 与「编辑图片」页面支持上传单张 PNG/JPEG/WebP，调用 `/images/edits`，保留输入原图并另存结果。
 - **直接生成**：在「设置 → 生图 → 生成图片」中输入提示词、选择模型并生成。
 - **图片输出**：支持 base64 和图片 URL 响应，提供图片预览与原图下载。
 - **技能复用**：附带 imagegen 提示词规范和示例，并注册 DSH 专用的 `dsh-imagegen` 技能。
@@ -104,12 +105,35 @@ git+https://git.crash.work/cneicy/dsh-imagegen.git
 4. 按需展开尺寸、质量与数量设置。
 5. 点击「生成图片」，完成后预览并下载原图。
 
+### 编辑已有图片（1.1.0）
+
+先确认服务商和所选模型支持 `POST /v1/images/edits`（`edits` 为复数；Base URL 已有 `/v1` 时只追加 `/images/edits`）。支持生图不代表支持编辑。
+
+- **对话中**：上传图片，或指定已有图片的本机路径，例如「把这张图的背景改成海边，保持人物、衣服和姿势不变，用我设置的默认模型」。助手使用附件的本机路径调用 `imagegen_edit`。
+- **设置页**：进入「设置 → 生图 → 编辑图片」，选择图片并预览，选择模型，输入修改要求，然后点击「编辑图片」。
+- 输入仅支持一张 PNG/JPEG/WebP，最大 20 MiB；DSH 附件服务还会检查图片能否解码及部署的像素限制。暂不支持 GIF、蒙版或多图输入。
+- 原图字节会发送到所配置的服务商；请求可能收费，失败不自动重试。输出另存为新文件，输入不会被覆盖。
+- 对话附件可能已经过 DSH 缩放；要使用原始分辨率，请选择本机原文件或在设置页上传原文件。
+
+工具参数示例（路径替换为实际存在的绝对路径）：
+
+```json
+{
+  "image_path": "D:/Pictures/input.png",
+  "model": "gpt-image-2.5-sunburst",
+  "prompt": "只将背景改成夕阳下的海边，保持人物、衣服和姿势不变"
+}
+```
+
+编辑工具复用生图的 `n`、`size`、`quality`、`background`、`output_format` 可选参数；是否支持由服务商决定。设置页通过 `POST /api/imagegen/edit` 提交 multipart 表单：`image` 为文件，`input` 为上述生成参数的 JSON（不包含 `image_path`）。浏览器路由只接收上传文件，不读取请求提供的本机路径。
+
 ### 对话工具
 
 | 工具 | 用途 |
 | --- | --- |
 | `imagegen_status` | 返回 Base URL、是否已配置、候选模型、默认模型与输出目录；不返回密钥。 |
 | `imagegen_generate` | 以明确的模型和提示词生成图片，并返回 DSH 图片附件及原图路径。 |
+| `imagegen_edit` | 上传 `image_path` 指定的图片，按提示词编辑并返回新图片附件和路径。 |
 
 生成参数示例：
 
@@ -164,7 +188,7 @@ git+https://git.crash.work/cneicy/dsh-imagegen.git
 
 **模型不支持尺寸、质量或透明背景**：去掉不受支持的可选参数，或显式选择支持这些能力的模型。第三方服务也可能忽略某些参数。
 
-**能否用参考图或修改已有图片？** 当前只实现文生图，不支持参考图输入、图像编辑或蒙版。附带的上游 imagegen 技能资源包含编辑说明，但不代表本插件已实现编辑接口。
+**能否用参考图或修改已有图片？** 1.1.0 起支持单张图片加文字指令编辑，调用 `/images/edits`。暂不支持蒙版和多图输入。若编辑返回 404，请检查服务商是否提供该端点；插件不会自动降级成文生图。
 
 ## 开发与验证