前言¶
在 DeepSeek Harness（DSH）里做智能体或日常开发，经常需要「按提示词出图」或「拿一张图再改一版」。若每次都在终端 curl 第三方接口、自己管 Key 和落盘路径，Web 侧和 Agent 侧很难共用同一套配置。社区插件 dsh-plugin-image2（维护者 Mr-Maidong）把接口地址、API Key、模型与输出目录收进当前 profile，在左侧栏提供「图像生成」页面，并注册 image2_generate / `image2_edit 两个工具，页面与 Agent 走同一 Host 逻辑。
这是什么¶
Image studio（图像生成） 是一个 DSH Harness 插件，分类属于模型推理。它解决两件事：在 Web UI 里填写生图接口与密钥后直接出图、结果进本地画廊；同时把生成与改图能力暴露给 Agent。仓库：Mr-Maidong/dsh-plugin-image2；社区目录页：skillhub.cn 条目。当前 package 版本为 1.7.2，许可证 MIT（以仓库 package.json 为准）。
核心功能¶
Web 侧「图像生成」页¶
安装并重启 DSH 后，左侧栏会出现「图像生成」入口。第一次进入会弹出接口设置；已配置时从标题栏右上角「设置」进入。
设置项包括：
- 接口地址：生图 API 基础地址，例如
https://api.openai.com/v1；也可粘贴完整路由，插件会自动截掉/images/generations等后缀。 - API Key：保存后页面只显示掩码，不再回显明文。
- 模型：默认
gpt-image-2.5。 - 输出目录：默认
~/Pictures/image2，支持~路径。 - 超时时间（秒）：默认
180，有效范围 5–900；控制一次生图/改图及结果下载的总时长。「测试连接」固定 20 秒，不受此项影响。
左列输入提示词，可选画幅、质量、背景（默认 16:9 / 自动 / 自动，切换只影响当次）。不传参考图时走文生图（/images/generations）；在提示词框左下角添加 1–5 张参考图（单张 ≤ 14 MB）则自动走图生图（/images/edits），按钮文案变为「图生图」。生成过程中同一按钮变为「取消生图 Ns」，点击会通过 Host 中断对接口的请求，避免后台继续出图。右列为生图预览与历史缩略图（分页、批量删记录；删记录不删磁盘文件）。
Agent 工具¶
Host 在 index.js 注册两个工具，与页面共用同一套设置与超时：
image2_generate(prompt, size?, quality?, background?, outputDir?)— 调用生成接口，返回落盘路径。image2_edit(image, prompt, mask?, size?, quality?, background?, outputDir?)— 调用/images/edits，结果写新文件，原图不动。
background 可取 auto / transparent / opaque（透明背景适合需要 alpha 的 PNG 素材）。工具在工作区调用时，未显式传 outputDir 时默认写入 <工作区>/imgout，便于 Agent 产物落在任务旁边。
Host API（摘要）¶
鉴权通道下的 /api/image2/* 负责设置、测试连接、生成/改图、历史、取消与图片字节读取；图生图对多种 request body 写法有兼容与记忆逻辑，详见仓库 README「实现」一节。
安装与启用¶
从 GitHub 安装（命令来自仓库 README）：
dsh plugin --profile desktop add git+https://github.com/Mr-Maidong/dsh-plugin-image2.git
Host 半侧在 DSH 启动时加载，安装后需重启 DSH。之后若只改 client.js，刷新页面即可。
典型用法¶
- 执行上述安装命令并重启 DSH。
- 打开左侧栏「图像生成」，在设置里填写接口地址与 API Key，可选「测试连接」（探测
{接口地址}/models），保存。 - 输入提示词，按需选画幅/质量/背景，点「生成图片」；需要图生图时在左下角「添加参考图」选 1–5 张后再生成。
- 在 Agent 对话中让模型调用
image2_generate或image2_edit，参数与 Web 侧共用 profile 里的接口配置。
适用场景与注意¶
适合已在 DSH desktop profile 下工作、并希望同一 profile 内人工出图与 Agent 出图共用 Key 和端点的用户。接口需兼容 README 描述的 OpenAI 风格路由（/images/generations、/images/edits 等）；具体模型与计费取决于你接入的服务商。
插件以当前 DSH 进程权限运行，API Key 与生成文件会落在本机配置与输出目录。安装前请自行查看 GitHub 源码 与 MIT 许可证。社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-plugin-image2 把生图接口、Web 画廊与 Agent 工具收到一个插件里，减少重复配 Key 和散落脚本。更多信息见目录页 https://www.skillhub.cn/plugins/Mr-Maidong/dsh-plugin-image2 与仓库 https://github.com/Mr-Maidong/dsh-plugin-image2。
