更新不会丢配置

Key、Base URL、模型、历史都在：

$DSH_HOME/image-studio/

更新/重装插件不会清空这个目录。不要为了更新去删除它。

使用

点击侧边栏「生图工作台」。
选择服务商页签（Agnes / GPT Image / Grok / 兼容接口）。
点右上角「配置」，给当前服务商填 Key、Base URL、模型、默认参数。
需要图生图时，在提示词下方点「添加参考图」，选择或拖入一张 PNG / JPEG / WebP；缩略图会显示在参考图区域，可随时更换/移除。
输入提示词，点「生成图片」。
生成后结果右上角有「下载原图」（PNG/JPEG/WebP）和「复制路径」；参考图生成的结果会带「参考图 1」标记。

或直接发送：

/image gpt 2k 16:9 一只戴宇航头盔的橘猫
/image grok 2k 9:16 雨夜霓虹街道
/image agnes 1k 1:1 电影感棚拍
/image 2k 16:9 默认服务商出图

## 配置字段

顶层：

| 字段 | 默认值 | 说明 |
|---|---|---|
| `enabled` | `true` | 总开关 |
| `defaultProvider` | `agnes` | `/image` 未写 `--provider` 时使用；点击面板服务商页签会自动更新 |
| `providers..*` | 见下表 | 每个服务商的独立配置 |

每个 `providers.`：

| 字段 | 说明 |
|---|---|
| `baseUrl` | 根地址；不能带查询参数 |
| `endpointPath` | 默认 `/v1/images/generations`，兼容中转可改 |
| `model` | 默认模型 |
| `size` | 默认尺寸；Agnes/Grok 用 1K/2K，OpenAI 用 1024x1024 等 |
| `ratio` | 仅 Agnes/Grok 使用 |
| `quality` | 仅 OpenAI/Grok 使用 |

Key 的环境变量兜底（文件 Key 优先）：

| 服务商 | 环境变量 |
|---|---|
| Agnes | `DSH_IMAGE_STUDIO_AGNES_API_KEY`，兼容旧 `DSH_IMAGE_STUDIO_API_KEY` |
| OpenAI | `DSH_IMAGE_STUDIO_OPENAI_API_KEY` |
| Grok | `DSH_IMAGE_STUDIO_GROK_API_KEY` |
| 兼容接口 | `DSH_IMAGE_STUDIO_OPENAI_COMPATIBLE_API_KEY` |

Key 优先级：**`credentials.json` 中该服务商的 Key > 该服务商环境变量 > 无**；不会读取其他服务商的 Key，也不会读取 dsh 的模型凭据。

dsh-image-studio

같은 패키지 이름의 다른 저장소

설치

문서

更新不会丢配置

使用