前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，经常需要出图：有的团队走 Agnes，有的用 OpenAI GPT Image 或 xAI Grok，还有自建或中转的 OpenAI 兼容 Images 接口。若把 Key 和参数散落在脚本、环境变量和不同客户端里，切换服务商成本高，对话里也很难稳定地「生成—改图—继续聊」。
下面介绍社区插件 dsh-image-studio（生图工作台）：在 DSH 侧边栏提供一级入口，并为 Agnes、OpenAI GPT Image、Grok Image、OpenAI 兼容四类服务商分别保存 Key 与默认参数；同时支持在对话里用 /image 语法触发 image_studio_generate 工具，把结果留在当前会话。维护者为 david-zdw，分类为模型推理；仓库当前版本 v0.8.3（MIT 许可证）。插件目录页：skillhub.cn/plugins/david-zdw/dsh-image-studio，源码：github.com/david-zdw/dsh-image-studio。
这是什么¶
dsh-image-studio 是 DSH 的多服务商生图插件：侧边栏「生图工作台」打开完整面板，或在消息里写 /image 简写调用。四个服务商各用独立 Key，互不回退、互不覆盖；Key 默认保存在本机 $DSH_HOME/image-studio/，不写入 DSH 模型凭据或其他插件配置。
能力上覆盖文生图，以及最多 5 张参考图的图生图（PNG / JPEG / WebP）。Agnes 侧复用 open-storyboard-canvas 的 Agnes 请求契约，并补齐 OpenAI Images 与 Grok Imagine 的映射。
支持的服务商¶
| id | 面板名称 | 默认 Base URL | 默认模型 | 图生图 |
|---|---|---|---|---|
agnes |
Agnes | https://apihub.agnes-ai.cn |
agnes-image-2.5-flash |
extra_body.image |
openai |
OpenAI GPT Image | https://api.openai.com |
gpt-image-1.5 |
multipart /v1/images/edits（DALL·E 3 不支持参考图） |
grok |
Grok Image | https://api.x.ai |
grok-imagine-image-2.0 |
JSON /v1/images/edits，images[] |
openai-compatible |
OpenAI 兼容 | https://api.example.com |
gpt-image-1 |
multipart /v1/images/edits |
OpenAI 兼容档可接任意 POST /images/generations 风格的中转；模型名、尺寸、接口路径可在面板修改。图生图时把生成路径中的 generations 换成 edits（默认 /v1/images/edits），Base URL 不变。
核心功能¶
侧边栏面板¶
与「插件」「自动化任务」「上下文洞察」同级，点击即开完整工作台：服务商页签、模型/尺寸/比例/质量、提示词、参考图、Ctrl/⌘+Enter 生成；生成过程有整块画布中心的矩阵点动画；结果支持全屏查看、删除、下载原图、复制路径，并保留最近 80 条历史。
GPT Image 自定义 2.5 模型尺寸为 1K/2K/3K/4K 四档，选比例后按官方规则计算像素（宽高为 16 的倍数、比例 1:3–3:1），质量支持 xhigh / max。图片与历史地址使用主 Web 服务的绝对 origin，避免多端口预览出现 401。默认生图超时 300 秒，URL 回传单独 120 秒预算，面板显示已等待秒数。
对话内 /image¶
/image 不是 DSH 内置斜杠命令，而是普通消息里的调用语法；发送后由模型调用 image_studio_generate，图片以 Markdown 内联在聊天中，工具卡可打开本地文件或原图。输入框会像普通消息一样清空，可继续对话。
同一对话中：第一条为文生图，后续消息默认基于上一张修改；加 --new 可强制重新文生图。服务商、尺寸、比例可写在开头，顺序任意，遇到第一个无法识别的词起算作提示词。
示例：
/image gpt 2k 16:9 一只戴宇航头盔的橘猫
/image 把背景改成雨夜霓虹街道，保留橘猫和头盔
/image --new agnes 1k 1:1 一只在窗边晒太阳的猫
/image --provider openai --size 1024x1024 --quality high 一只戴宇航头盔的橘猫
--provider 支持 agnes、openai（别名 gpt）、grok、openai-compatible（别名 compatible / custom）。未写 --provider 时使用配置里的 defaultProvider（默认 agnes）。
模型嗅探与主题¶
在「生图设置」保存 Key 后可点「嗅探模型」，用当前服务商 Key 请求 /v1/models；勾选后的图像模型会进入主面板下拉（带「图像」标记）。界面使用 DSH 的 --dsw-alias-*、--dsh-frame-top-clearance 等 token，与宿主主题一致。
未配置 Key、401/402/429、超时、网络错误、无图片数据等情况会有明确提示。
安装与启用¶
官方 README 推荐本地 link 安装：先取得仓库目录，再在对应 profile 下 link 到 DSH。
git clone https://github.com/david-zdw/dsh-image-studio.git
# 在 DSH profile 中安装这个本地包（路径换成你的 clone 目录）
dsh plugin --profile desktop add link:D:/path/to/dsh-image-studio
# macOS / Linux:
# dsh plugin --profile desktop add link:/path/to/dsh-image-studio
也可在 DSH 插件管理器中选择 install_bundle，目标目录指向上述仓库目录。
安装后侧边栏出现「生图工作台」。若窗口在安装前已打开，需重新加载窗口或重启 DSH。卸载：
dsh plugin --profile desktop remove dsh-image-studio
更新后顶栏显示 IMAGE WORKBENCH · v0.8.3 可用来确认版本。link 安装时需在仓库内 git pull 或 git checkout v0.8.3 后再重启 DSH；dsh plugin --profile desktop update dsh-image-studio 不会替你做 git 拉取。Key、配置与历史在 $DSH_HOME/image-studio/，更新或重装插件不会清空该目录。
配置与数据位置¶
$DSH_HOME 默认为 ~/.dsh（Windows：C:\Users\<你>\.dsh）。
| 路径 | 内容 |
|---|---|
image-studio/credentials.json |
各服务商 Key：keys.agnes / openai / grok / openai-compatible |
image-studio/config.json |
defaultProvider 与各服务商 baseUrl、endpointPath、model、size、ratio、quality |
image-studio/history.json |
最近 80 条生成元数据 |
image-studio/outputs/ |
生成的 PNG/JPEG/WebP/GIF |
Key 优先级：credentials.json 中该服务商的 Key > 该服务商环境变量 > 无。环境变量包括 DSH_IMAGE_STUDIO_AGNES_API_KEY（兼容旧 DSH_IMAGE_STUDIO_API_KEY）、DSH_IMAGE_STUDIO_OPENAI_API_KEY、DSH_IMAGE_STUDIO_GROK_API_KEY、DSH_IMAGE_STUDIO_OPENAI_COMPATIBLE_API_KEY。
面板使用步骤（摘要）：
- 打开侧边栏「生图工作台」，选择服务商页签。
- 点「配置」，为当前服务商填写 Key、Base URL、模型与默认参数；Agnes 配置内可跳转「获取 Agnes Key」。
- 可选「嗅探模型」并勾选要出现在下拉的模型。
- 需要图生图时在提示词下「添加参考图」（最多 5 张），输入提示词后「生成图片」。
适用场景与注意¶
适合需要在 DSH 内统一管理多路生图 API、又希望在对话里快速出图或连续改图的开发者。OpenAI 兼容档便于对接自建或聚合中转；Grok 优先 b64_json 以减少二次下载等待，对 xAI 子域图片下载带 Key 并在 401/403 时自动无 Key 重试。
安装前请自行阅读仓库源码与 MIT 许可证。插件以当前 DSH 进程权限运行，Key 与生成文件落在本机 $DSH_HOME/image-studio/；勿将含 Key 的配置提交到版本库。社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-image-studio 把 Agnes、GPT Image、Grok 与 OpenAI 兼容生图收进同一工作台，并用独立 Key 与 /image 对话链路降低切换成本。需要面板细调参数或浏览历史时用侧边栏；需要边聊边改图时用 /image 即可。
- 目录页：https://www.skillhub.cn/plugins/david-zdw/dsh-image-studio
- GitHub：https://github.com/david-zdw/dsh-image-studio
