dsh-imagegen

DeepSeek Harness (DSH) Web GUI 的 AI 生图工作台。它通过宿主进程安全地代理 OpenAI 兼容的图像生成接口，把提示词增强、文生图、图生图、后台任务、多模型对比、历史记录与画廊管理放进同一个 DSH 原生界面。

默认模型为 gpt-image-2，也内置对 xAI grok-imagine-image（Grok Imagine）的支持；同时兼容提供 /images/generations 和 /images/edits 的 OpenAI 兼容端点。

效果预览

AI 生图工作台

三栏工作台将参数、生成结果和历史记录放在同一视图中。任务提交后可继续操作；生成的图片可预览、下载，并从历史记录恢复参数。

四图结果布局

单图结果布局

多模型并列对比

打开「多模型对比」后，为同一提示词勾选多个模型。任务会进入后台队列，完成后在画布中并列展示，支持进入全屏对比，直观看出不同模型在构图、质感与文字处理上的差异。

提示词模板库

模板库提供 441 个 gpt-image-2 案例的展示图、分类筛选和完整提示词；打开详情后可以复制提示词，或一键回填到生图输入框。

独立配置卡片

在 DSH 的“设置 -> 插件 -> 可配置”中填写 API 地址和密钥。密钥只保存在宿主侧设置文件，浏览器端不会获取明文。

画廊工作区

画廊标签页提供左侧分类筛选和右侧作品墙：可在瀑布流与整齐网格之间切换，纵向滚动浏览收藏，点击任意图片打开大图预览。支持关键词搜索、自建标签、标签筛选、批量下载与 JSON 导出。

功能

• 文生图与图生图：输入提示词生成图片，或上传 PNG、JPG、WEBP 参考图进行编辑。
• Grok Imagine 支持：支持 xAI grok-imagine-image 文生图与图生图；将 API 地址设置为 https://api.x.ai/v1 即可使用官方比例、分辨率和 JSON 图片协议。
• 可调生成参数：尺寸、清晰度、生成数量和细节等级均可在界面中选择；未指定的参数保持自动。
• 提示词增强：对简短描述点击「增强」，使用独立配置或复用现有凭据的对话模型扩写为更完整的生图提示词；未配置时自动跳转到 DSH 的 AI 生图配置卡片。
• 后台生成任务：生成请求提交到宿主侧队列，面板不再被单次请求阻塞；可查看排队/生成/完成状态，取消任务或重试失败任务。
• 多模型对比：默认关闭；开启后可勾选多个模型，以相同提示词和参数分别生成，在画布和全屏视图并列对比结果。
• 结果操作：结果区固定为四分格：单图铺满，双图占上排，三图占三格，四图为 2×2；支持下载、全屏预览、可滚动缩放、前后切换、复制优化提示词，以及一键将当前图片添加到图生图。
• 画廊收藏与管理：结果卡片、全屏预览与历史记录条目上都有「加入画廊」。画廊支持瀑布流/整齐网格、持续纵向滚动、关键词搜索、模式/模型/比例/标签筛选、标签编辑、批量下载与 JSON 元数据导出；收藏持久化在宿主侧 ~/.dsh/dsh-imagegen/gallery/，无数量上限，且内容相同的图片不会重复加入。
• 可搜索历史：保存提示词、参数和图片；支持按关键词、模型与比例筛选，查看、恢复、单条删除和清空，最多保留 50 条。
• 跨设备查看：历史与画廊都保存在 DSH 宿主侧，连接同一 DSH 的浏览器或设备共享同一份记录。
• 提示词模板库：提示词框左下角可打开模板库，浏览 441 个 gpt-image-2 案例的展示图；支持搜索、分类筛选、查看完整提示词、复制，以及一键将模板回填到生图输入框。参考图通过宿主同源代理按需加载并缓存，也可手动缓存全部图片供离线浏览。
• 原生 DSH 体验：侧栏入口、主题适配和设置卡片均遵循 DSH Web GUI 的 UI 规范。
• 在线更新：插件会检查 GitHub Releases，发现新版本时在工作台显示在线更新按钮；安装完成后重启 DSH 即可加载新版本。

快速开始

前置条件：已安装 DSH（npm i -g @deepseek-ai/dsh）与 pnpm。 装完统一重启 dsh web，侧边栏即出现「AI 生图」入口，再到「设置 → 插件 → 可配置」填写 API 地址与密钥。

方式一：让 AI 帮你安装（最省事）

把下面提示词直接粘贴给 DSH（或 Codex / 其他 coding agent）执行即可：

用 dsh plugin --profile web add @dickpy/dsh-imagegen 安装 AI 生图插件（profile 名按实际修改），完成后重启 dsh web。

方式二：npm 安装（推荐）

dsh plugin --profile web add @dickpy/dsh-imagegen

dsh 会自动把插件注册进 profile 的 bundle 清单（无需手动改 cordis.patch.yml），重启 dsh web 即可。

方式三：聚合包（tarball）安装

从 GitHub Releases 下载发布产物 （如 dickpy-dsh-imagegen-1.1.0.tgz），然后：

dsh plugin --profile web add <下载路径>/dickpy-dsh-imagegen-1.1.0.tgz

重启 dsh web。

方式四：源码开发启动（最后的选择）

需要改插件源码时才用这种方式：

git clone https://github.com/dickpy/dsh-imagegen.git
cd dsh-imagegen
pnpm install
pnpm run build
dsh plugin --profile web add link:/绝对路径/dsh-imagegen

重启 dsh web；开发时可运行 pnpm run watch 持续构建，bundle 变更由 client-hmr 自动热更。

配置 API

打开 DSH 的“设置 -> 插件 -> 可配置”，展开 AI 生图 (dsh-imagegen)：

配置完成后，从 DSH 侧栏打开“AI 生图”即可开始使用。

接口兼容性

detail 是透传参数，部分 gpt-image-2 网关支持。官方 OpenAI 端点若不接受该字段，请保持界面中的“自动”。

Grok Imagine 模型（grok-imagine-image / grok-imagine-image-2.0）的请求会按官方规范发送：界面尺寸即宽高比（1:1 / 3:4 / 4:3 / 9:16 / 2:3 / 3:2 / 16:9 / 21:9），直接作为 aspect_ratio（21:9 映射为官方文档中的 20:9 超宽）；清晰度 1k / 2k / 4k 作为 resolution（官方文档当前仅支持 1k / 2k，选 4k 时自动回落为 2k）；并固定 response_format: "b64_json"（结果 URL 为临时签名链接，直接取 base64 更稳定）。OpenAI 兼容端点则将宽高比映射为最接近的像素尺寸（如 1:1→1024×1024、16:9→1792×1024），清晰度映射为 quality 档位（1k→low、2k→medium、4k→high）。API 地址填 xAI 的 https://api.x.ai/v1 即可使用。

画廊与 Grok Imagine

画廊提供独立的作品浏览工作区：左侧按生成模式、模型、画面比例和自建标签筛选，右侧以纵向瀑布流或整齐网格展示收藏图片。支持关键词搜索、标签新建/编辑/筛选、批量下载、JSON 元数据导出、发布时间排序、持续向下滚动、点击卡片打开大图预览、恢复参数、移出和清空。收藏数据由 DSH 宿主持久化到 ~/.dsh/dsh-imagegen/gallery/，同一图片内容不会重复保存。

插件原生支持 xAI grok-imagine-image。将 API 地址设置为 https://api.x.ai/v1 后，文生图使用 /images/generations，图生图按 Grok Imagine 的 JSON image_url 协议调用 /images/edits；界面中的比例和清晰度会分别映射为 aspect_ratio 与 resolution。

数据与安全

• API 请求由 DSH 宿主进程代理，浏览器不直接连接上游 API，因此不暴露 API 密钥，也没有浏览器 CORS 问题。
• API 密钥保存在宿主侧 ~/.dsh/settings.yaml；设置桥会对密钥进行脱敏。
• 历史与画廊数据存放在 ~/.dsh/dsh-imagegen/：历史图片独立落盘于 images/（index.json 为索引），画廊在 gallery/ 子目录（gallery/index.json 为索引，按图片内容去重）。
• 模板库的提示词快照随插件发布；展示图从 vibeui.top 通过本机宿主按需拉取，并缓存到 ~/.dsh/dsh-imagegen/template-images/。模板库仅在手动刷新或首次加载展示图时访问该站点。
• 插件通过专用 loopback 路由 /api/dsh-imagegen/settings/{describe,mutate} 访问设置，不需要修改 DSH 源码或依赖第三方命名空间白名单。

项目结构

开发

pnpm run typecheck  # TypeScript 类型检查
pnpm run build      # 构建宿主与 Web bundle
pnpm run watch      # 持续构建

📬 反馈与提问

• 遇到 Bug：请使用 Bug 报告模板 提交， 并附带插件版本、DSH 版本、安装方式与复现步骤（请勿在 issue 中粘贴 API 密钥）。
• 功能建议：请使用 功能建议模板 提交， 描述使用场景与期望效果。
• 安装 / 使用问题：先查阅本文档「快速开始」与「配置 API」章节。

许可证

Apache-2.0