dsh-imagegen-plugin

配置

卡片（推荐）

设置 → 插件 → 插件配置 → 生图配置：

字段	说明
接口类型	OpenAI 兼容（默认）/ 阿里百炼 DashScope / Replicate / fal.ai
接口地址	默认空，由你填写；OpenAI 兼容端点通常以 /v1 结尾。留空时百炼 / Replicate / fal.ai 使用官方默认地址（切换类型且该栏为空时自动预填）
模型 ID	端点提供的模型名称（格式按各家文档），文生图与改图都用它。如 gpt-image-1、flux-dev、wanx2.1-t2i-turbo
API Key	存凭据服务（固定条目 DSH_IMAGEGEN_API_KEY），不写入设置文件；已配置时输入框保持密文并显示「已配置」标签（跨页面刷新 / 宿主重启保持；读取失败会自动重试修复）。改 Key：点击输入框 → 密文清除 → 填新 Key → 保存，即以最新值为准。想复用主模型已有的 Key？不用碰这张卡片——直接对 agent 说「复用主模型配置生图，模型是 ``」
默认尺寸 / 默认张数	每次生成未显式指定时的兜底值
产物目录	相对会话工作区，默认 imagegen/

对话配置（免点页面，也是复用已有 Key 的唯一入口）

同一服务商（最常见）——对 agent 说：

复用主模型配置生图，模型是 qwen-image

agent 调用 imagegen_configure {fromMainModel:true, model:"qwen-image"}：自动读取主模型 provider 的 baseURL 与 key 凭据名写入生图配置，一步完成（卡片里会显示复用后的值与「已配置」标签）。

完全手动——直接对 agent 说：

配置生图：接口 openai，地址 https://api.example.com/v1，模型 gpt-image-1，Key sk-xxxx

agent 会调用 imagegen_configure 写入并（建议）用 imagegen_test 验证。

环境变量

DSH_IMAGEGEN_API_KEY（或 apiKeyEnv 指定的同名变量）——共享部署下比把 Key 写进凭据库更稳妥。

对话配置（免点页面，也是复用已有 Key 的唯一入口）

同一服务商（最常见）——对 agent 说：

复用主模型配置生图，模型是 qwen-image

agent 调用 imagegen_configure {fromMainModel:true, model:"qwen-image"}：自动读取主模型 provider 的 baseURL 与 key 凭据名写入生图配置，一步完成（卡片里会显示复用后的值与「已配置」标签）。

完全手动——直接对 agent 说：

配置生图：接口 openai，地址 https://api.example.com/v1，模型 gpt-image-1，Key sk-xxxx

agent 会调用 imagegen_configure 写入并（建议）用 imagegen_test 验证。

使用示例

你：生图：一只橘色小猫坐在窗台上，午后阳光，电影感
agent：（调用 image_generate，约 6s）
       ![1](https://raw.githubusercontent.com/nexsjournal/dsh-imagegen-plugin/ba7bfcee0f7281c4c2e9f30f8b2e94217e23d3df/%E2%80%A6/%E5%B7%A5%E4%BD%9C%E5%8C%BA/imagegen/2026-08-17-09-55-00-1.png)

你：把这张图改成黄昏油画质感，改动大一点
agent：（image_generate + image=上一步路径 + strength=0.7）

你：把背景换成海边，其他都别动
agent：（image_generate + edit=true，指令编辑，用已配置的模型）