前言¶
在 DeepSeek Harness（DSH）里做图像生成或编辑，常见做法是单独开浏览器标签页跑工作台，或在智能体流程里自己拼 API 调用。前者和 DSH 左栏、会话上下文脱节；后者很难复用现成的画廊、参考图、遮罩编辑和多供应商配置。CookSleep/gpt_image_playground 已经提供完整的生图工作台（画廊 / Agent 双模式等）。dsh-gpt-image-playground 由社区维护者 southcul 发布，把上游官方构建（v0.8.4）以 vendor 方式打进插件，在 DSH 内同源提供页面，并可选走 DSH 侧 API 代理，解决跨域与「生成中途切面板导致 iframe 被卸载」两类集成问题。
这是什么¶
一句话：把 GPT Image Playground 原版工作台装进 DSH——左栏多一个「生图工作台」入口，点开即完整上游 UI；插件本身主要负责同源托管与可选代理，不 fork 上游业务逻辑。
- npm 包名：
dsh-gpt-image-playground（当前资料中 package 版本 0.2.4） - 分类：模型推理（社区目录 SkillHub 插件页）
- 上游：
vendor-app/来自 CookSleep 的 gpt_image_playground 官方构建，MIT；本插件亦为 MIT
核心功能¶
完整能力继承自上游 v0.8.4，资料中明确列出的包括：
- 画廊 / Agent 双模式；批量生成、迭代、多提示词提交、流式预览
- 参考图（最多 16 张）、遮罩编辑器、画板标注（画笔 / 文字 / 图形 / 像素橡皮擦）、评论定位
- 多 API 配置与多供应商：OpenAI 兼容 Images / Responses、sub2api 异步、fal.ai、自定义 HTTP 供应商
- 1K / 2K / 4K 尺寸预设与规整、真实参数与改写后提示词对比
- 收藏夹、失败重试、框选 / 侧滑多选、大图预览、ZIP 备份
- 透明背景（原生 / 本地后处理）、Codex CLI 兼容、提示词防改写、外观与习惯配置
与独立打开上游站点的差异（均在 iframe 内注入，不改上游构建产物）：
- 隐藏「安装为应用 / 下载客户端 / 操作指南」等入口；设置页隐藏「关于」标签；版本徽标显示本插件版本；关闭上游公告卡
- 工作台挂在
shell.overlay的常驻 iframe：切换 DSH 主面板时 iframe 仅隐藏不卸载，避免 keyed 的main槽卸载导致进行中的生成请求被销毁 - DSH 窗口级快捷键不穿透到 iframe 内应用
可选 API 代理：当接口不支持浏览器跨域时，由 DSH 主机转发，Authorization 与 multipart 图片体原样透传。
安装与启用¶
DSH 生态强调「一切皆插件」；社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前建议自行查看 GitHub 仓库 源码与 LICENSE、THIRD-PARTY-NOTICES.md。插件随当前 DSH 进程权限运行，API Key 存本机浏览器存储（资料说明不上传），仍须按组织策略评估 Key 与代理暴露面。
用 npm 包名（推荐）¶
在 DSH 中打开 插件 → 安装，填写：
dsh-gpt-image-playground
装完后在插件列表启用，刷新页面（Ctrl+R），左栏出现「相框」图标。
命令行等价：
dsh plugin --profile desktop add dsh-gpt-image-playground
从 Release 压缩包¶
下载 最新 Release 中的 gpt-image-playground-<版本>.zip，解压后任选其一：
- DSH 插件页 → 安装 → 填写解压目录的绝对路径（推荐）
- 或在 Windows 上右键
install.ps1→ 使用 PowerShell 运行
从仓库目录¶
若已从仓库取得源码目录，在 DSH → 插件 → 安装 → 填写该目录绝对路径即可（README 亦给出 clone 地址，此处不展开 clone 步骤）。
典型用法¶
第一次使用可按 README 顺序操作：
- 打开工作台 → 右上角齿轮 → API 配置，填写 API URL 与 Key。
- 若提示「接口不支持浏览器跨域请求」：点工作台左下角 ⚙（iframe 外的小按钮），填写真实 API 地址并保存；将面板显示的代理地址复制到应用内的「API URL」。
代理地址形如：
http://127.0.0.1:13807/plugins/dsh-gpt-image-playground/proxy
请求由 DSH 主机转发至你配置的真实 API。
适用场景与注意¶
适合：已在 DSH 桌面 / Web 侧做智能体或对话开发，希望左栏一键进入完整生图工作台，且需要与 DSH 同域部署、必要时走内置代理的场景。
注意：
peerDependencies要求@deepseek-ai/cordis（>=4.0.0 <5）与react（>=18.2.0 <19）；Node 引擎为^22.19.0 || >=24.0.0（见 package.json）- 界面裁剪与代理行为以插件 README 为准；第三方许可见包内
THIRD-PARTY-NOTICES.md
结尾¶
dsh-gpt-image-playground 的价值在于：不重复造生图 UI，把 CookSleep 的 GPT Image Playground v0.8.4 以 vendor 方式嵌入 DSH，并用 overlay iframe 与可选 /proxy 解决集成时的生命周期与 CORS 问题。目录与文档：
