Octo-o-o-o/gpt-image-design

gpt-image-design

DeepSeek Harness 插件：用 ChatGPT Pro 网页会话或 OpenAI 兼容生图 API 出设计图与 HTML demo，侧边栏画廊预览。

待分类chatgptcordisdeepseek-harness

GPT-Image Design

在 DeepSeek Harness（DSH）里，用真实的 ChatGPT Pro 网页会话，或任意 OpenAI 兼容生图 API，出设计图与单文件 HTML demo；图片和代码保存到本地，侧边栏画廊预览，iframe 直接打开 demo。

English: Generate images and HTML demos through a real ChatGPT Pro web session or an OpenAI-compatible image API, saved locally with a gallery in DSH.

风险提示：web 通道是订阅网页自动化，不是官方 API；页面改版、账号风控与 ToS 风险由使用者承担。api 通道按服务商条款计费，只产出图片，不产出 HTML demo。

*首次安装后的空状态：侧边栏入口和面板已加载；在会话里用 /gpt-image-design 开始。*

两种通道

通道 · 适合 · 产出 web（默认） · 有 ChatGPT 订阅，想顺带生成 HTML demo · 图片 + 前端代码/HTML demo api · 没有订阅，或想用 gpt-image-1 等 API 的质量/尺寸/参考图控制 · 只有图片；HTML demo 由 agent 另行生成

它解决什么问题

一句话生成多个方向的设计图，并把每轮结果按主题和轮次落盘。
侧边栏「Image Design」提供画廊、demo iframe 预览和设计决策记录。
材料里的图片可以作为参考图（api 通道走 /images/edits），最多 4 张、每张 25MB。
适合落地页/海报/UI 方向探索；不适合需要像素级精确排版、或必须使用特定品牌规范自动校验的场景。

前置条件

DSH >= 0.2.1-rc.2 < 0.3.0（本版本实测 0.2.1-rc.2）。
Node.js 22+（DSH 自带 runtime 也可以）。
web 通道：本机 Google Chrome + 可登录 ChatGPT 网页的账号；首次登录必须有人工操作。
api 通道：一个 OpenAI 兼容的生图服务、base URL、key 和模型名。
web 通道固定单账号、单会话，与研究插件共用同一个 Chrome profile。

安装

从 dsh.pub（推荐）

npx dshpub add Octo-o-o-o/gpt-image-design

dsh.pub 会把仓库固定到一个公开 commit 再安装。

从 Git commit

dsh plugin --profile <profile> add github:Octo-o-o-o/gpt-image-design#<40-char-commit>

用仓库 Release 或 dsh.pub 记录里的完整 SHA； 换成你的 profile（例如 desktop、web`）。

从 npm

dsh plugin --profile <profile> add gpt-image-design

npm 上现有 0.2.x；本仓库的 0.3.1 以 Git/dsh.pub 分发为准。

启用

安装后重启 DSH，打开 设置 → 插件，确认 GPT-Image Design 已启用；工具列表会出现 gpt_image_design，侧边栏会出现 Image Design 面板。

首次登录（web 通道）

gpt_image_design(action="login")

插件会打开一个独立的 Chrome 窗口。登录 ChatGPT 后关闭窗口即可；登录态保存在 ~/.dsh/pro-research/browser，与研究插件共用，只需登录一次。

api 通道不需要登录；配好 key 后用 probe 自检。

快速开始

web 通道

gpt_image_design(
  action="start",
  confirmed=true,
  title="落地页首屏",
  question="生成 3 个方向的首屏设计图和 1 个 HTML demo",
  brief="深色科技风，中文大标题，右侧产品界面，单文件 HTML",
  criteria=["至少 1 张完整首屏图", "一个可打开的 HTML demo"],
  rounds=2,
  designs=3
)

产物写入 /artifacts/round-NN/：

<project>/docs/design/<slug>/
├── topic.json
├── artifacts/round-01/
│   ├── image-01.png
│   ├── image-02.png
│   └── code-01.html
└── ...

image-*.png：ChatGPT 生成的图片。
code-*.html：前端代码块；单文件 HTML 可在面板 iframe 预览。

API 通道

在 设置 → 插件 → GPT-Image Design 里把 channel 改成 api，并填写：

设置 · 默认 · 说明 channel · web · web 或 api。 imageBaseUrl · https://api.openai.com/v1 · 含版本前缀的 API 根地址。 imageApiKey · 空 · key；留空则读环境变量 GPT_IMAGE_API_KEY。 imageModel · gpt-image-1 · 模型名，例如 gpt-image-1、dall-e-3 或服务商模型名。 imageSize · auto · auto 或 1024x1024 / 1536x1024 / 1024x1536 等。 imageQuality · auto · auto / low / medium / high（服务商支持时生效）。 imageFormat · png · png / jpeg / webp。 imageAuth · bearer · bearer（Authorization: Bearer）或 api-key（Azure 风格）。 imageEdit · auto · 材料里的图片是否作为参考图发给 /images/edits：auto / off。 imageTimeoutSeconds · 300 · 单张图片的生成/下载超时（秒，10–3600）。

自检：

gpt_image_design(action="probe")

返回 channel: "api"、probe.ok、模型列表或 probe.reason。ok=false 时先看 reason（key、base URL、模型名）。

改完设置或环境变量后要重载插件（重启 DSH）才生效；进行中的主题不受影响。

如果设置页没有渲染这些项，可以直接写进 profile 的 cordis.patch.yml（~/.dsh/profiles//cordis.patch.yml）：

- id: gpt-image-design
  name: gpt-image-design
  config:
    channel: api
    imageBaseUrl: https://api.openai.com/v1
    imageApiKey: <your-key>        # 或用环境变量 GPT_IMAGE_API_KEY
    imageModel: gpt-image-1
    imageSize: 1536x1024

API 通道发起

gpt_image_design(
  action="start",
  confirmed=true,
  title="深色首屏",
  question="出三个方向的首屏",
  brief="深色科技风，中文大标题，右侧产品界面",
  criteria=["三张图方向可区分", "标题中文可读"],
  designs=3
)

每个方向调用一次生图接口（designs=3 就是 3 次请求），图片保存到 artifacts/round-NN/image-01.png 等。

接口约定

POST {imageBaseUrl}/images/generations，JSON：{model, prompt, n:1, size?, quality?, output_format?}；
材料里有图片（.png/.jpg/.jpeg/.webp，最多 4 张、每张 25MB）且 imageEdit=auto 时改走 POST {imageBaseUrl}/images/edits（multipart，image[]）；
响应支持 data[].b64_json、data[].url；url 会下载后落盘，鉴权头只发给 imageBaseUrl 同源地址；
服务商必须兼容 OpenAI images 的参数名；用 image_size、batch_size 等自定义参数的服务商暂不支持。

成本与轮次

每轮 = designs 次生图请求，按 API 计费；没有配置自动裁决（judgeProvider + judgeModel）时，API 通道默认只跑 1 轮，避免重复计费。显式传 rounds 可覆盖。
自动裁决在 API 通道只看得到提示词与结果清单，看不到图片本身；更可靠的是人工复核，或不配裁决、跑 1 轮后用 continue 显式加轮。
部分方向失败不会丢掉已成功的图；失败原因写进该轮答复和面板记录。
DSH 重启后，进行中的 API 请求会丢失，这一轮不会自动重发；已生成的图片仍在 artifacts/ 里。

设置（通用）

以下设置两个通道都有：

设置 · 默认 · 说明 rounds · 3 · 每个主题默认轮次上限（1–10）。 designs · 3 · 每轮生成的方向/图片数（1–6）。 model · pro · web 通道的 ChatGPT 页面模型：pro 或 thinking。 store · project · 记录位置：project（仓库 docs/design）或 local（DSH 本机）。 autoStart · false · 设计卡是否跳过点击直接开跑。 autoReview · true · capped 后唤醒原会话检查产物。 notify · stall-only · stall-only 只在卡住时提醒，all 完成也提醒。 stallMinutes · 45 · 无进展判定分钟数。 maxRoundMinutes · 90 · 单轮墙钟上限（分钟）。 maxFiles · 12 · 单轮附件数量上限。 maxTotalMB · 24 · 单轮附件总大小（MB）。 rawAnswers · local · 原始答复保存位置：local 或 repo。 rawAnswersDir · 空 · local 模式的原文目录。 headless · false · 无头模式仅建议用于自检。 judgeProvider · 空 · 自动裁决的 LLM provider；填 off 关闭。 judgeModel · 空 · 自动裁决的 model。

产物与记录

store=project：/docs/design/（设计插件使用 docs/design）。
store=local：~/.dsh/gpt-image-design/。
原始答复默认只在本机；rawAnswers=repo 才复制进项目。
API 通道的答复是提示词与结果清单（纯文本），不是模型自然语言回复。
登录态：~/.dsh/pro-research/browser（与研究插件共用，敏感，不要提交）。

验证清单

工具列表出现 gpt_image_design，侧边栏出现 Image Design 面板。
action="probe" 返回当前通道和状态；web 通道显示登录态，api 通道显示模型/接口检查结果。
跑一个 1 轮小主题，确认 artifacts/round-01/ 下有图片；web 通道还应出现 code-*.html。
面板里能打开画廊，点击 demo 能在 iframe 里预览。
刷新侧边栏，确认主题、轮次、产物路径都在。

安全与隐私

会出网：web 通道把问题、brief、判据和材料发送到 chatgpt.com；api 通道发送到你配置的 imageBaseUrl。
本地保存：登录态在 ~/.dsh/pro-research/browser；图片/代码在项目 docs/design 或 ~/.dsh/gpt-image-design；原始答复在本机。
key 处理：key 只来自插件设置或 GPT_IMAGE_API_KEY；不会写进 topic.json、回执、日志或错误信息（错误体做了脱敏）。
权限边界：插件以 DSH 进程权限运行，可以读写上述目录、启动本机 Chrome、请求你配置的生图服务；不会把 key 发给 imageBaseUrl 之外的地址，也不会把参考图发给其他服务商。
文件管理器：插件只用固定的 explorer.exe / open / xdg-open 参数打开它自己生成的产物文件/目录，不拼接用户输入，也不执行 shell 命令。
清理：删除主题目录即可删除该主题；卸载时见下文。不要把 key、登录态或 ~/.dsh 提交到仓库。

已知限制

web 通道受页面改版、Cloudflare、账号风控、额度限制影响；失败时保留已完成轮次，不假装成功。
web 通道只支持单账号、单会话；不支持多账号并行。
api 通道只支持 OpenAI images 参数名；自定义参数服务商暂不支持。
自动裁决在 API 通道看不到图片本身，不等同于视觉评审；重要结果请人工看画廊。
单轮图片数、附件大小、超时受 designs / maxFiles / maxTotalMB / imageTimeoutSeconds 限制。
页面上的模型/功能以 ChatGPT 网页实际提供为准。

故障排查

现象 · 先检查 web 登录窗口没出现 · 是否有残留的插件 Chrome 窗口占用 profile；关掉后重试 login。登录后仍显示未登录 · probe 看状态；确认 ~/.dsh/pro-research/browser 可写；必要时重新 login。 api 返回 401 · key、imageAuth（bearer / api-key）、base URL 是否匹配服务商。 api 返回 404 · imageBaseUrl 是否包含版本前缀，模型名是否存在。只有部分方向成功 · 这是允许的；看该轮答复里的失败原因，已成功的图不会丢。 demo 在 iframe 里打不开 · 确认 code-*.html 是单文件 HTML；外链资源可能被 iframe 限制。参考图没发出去 · 检查材料格式（png/jpg/jpeg/webp）、数量（最多 4 张）、大小（每张 25MB）和 imageEdit。改设置不生效 · 需要重启 DSH 重载插件；进行中的主题不受影响。

本地验证记录

2026-10-23，DSH 0.2.1-rc.2，空 web profile，从公开 commit e29502c 安装：

--dump-config 显示 # == gpt-image-design 组合包层；
GET /gpt-image-design/topics 返回 200 {"topics":[]}；
侧边栏 Image Design 入口和空面板正常加载。

这是安装/加载验证，不等于真实网页登录或真实生图 API 的验收；web 通道需要你自己的 ChatGPT 账号，api 通道需要自己的服务商 key。

兼容性

项 · 值 DSH · 0.2.1-rc.2 实测；engines.dsh 为 >=0.2.1-rc.2 <0.3.0 Node.js · 22+ 浏览器 · web 通道需要本机 Google Chrome（稳定版） API · 任意兼容 OpenAI images 参数名的服务平台 · Windows 已验证；macOS/Linux 使用对应的 Chrome 启动路径，未在仓库内声明实测插件版本 · 0.3.1

禁用与卸载

临时禁用：设置 → 插件 关闭 GPT-Image Design；或从 profile 的 dsh.profile.bundles 移除 gpt-image-design，重启 DSH。

卸载：

dsh plugin --profile <profile> remove gpt-image-design

然后按需删除：

~/.dsh/gpt-image-design/（store=local 的记录）
~/.dsh/pro-research/browser/（如果你也不再使用研究插件；两个插件共用登录态）
项目里的 docs/design/（只删你确认不要的主题）

开发

源码和开发说明在 monorepo：Octo-o-o-o/dsh-pro。

npm install
npm test
npm run typecheck
npm run build
node scripts/smoke-bundle.mjs

本仓库是发布仓库：lib/ 是构建产物，请不要直接改 lib/；改源码请到 monorepo 的 packages/design。

License

MIT。

站点导航

gpt-image-design

GPT-Image Design

两种通道

它解决什么问题

前置条件

安装

从 dsh.pub（推荐）

从 Git commit

从 npm

启用

首次登录（web 通道）

快速开始

web 通道

API 通道

API 通道发起

接口约定

成本与轮次

设置（通用）

产物与记录

验证清单

安全与隐私

已知限制

故障排查

本地验证记录

兼容性

禁用与卸载

开发

License

dsh-web

dsh-our-free-model

dsh-purge

gpt-image-design

GPT-Image Design

两种通道

它解决什么问题

前置条件

安装

从 dsh.pub（推荐）

从 Git commit

从 npm

启用

首次登录（web 通道）

快速开始

web 通道

API 通道

API 通道发起

接口约定

成本与轮次

设置（通用）

产物与记录

验证清单

安全与隐私

已知限制

故障排查

本地验证记录

兼容性

禁用与卸载

开发

License

同类插件

dsh-web

dsh-our-free-model

dsh-purge