dsh-imagegen

快速开始

需要已安装 DeepSeek Harness 和 Node.js 20+。

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

安装后重启 dsh web，侧边栏会出现「生图」入口。到「设置 → 生图配置」添加提供方、填写 API 地址与密钥、检测并选择生图模型，保存后即可开始创作。Windows 若遇 PowerShell 脚本策略限制，请使用 dsh.cmd。

• **让 Agent 安装：**把上面的安装命令发给 DSH、Codex 或其他 coding agent。
• **指定版本：**使用 @superdsh/dsh-imagegen@<版本号>，或从 GitHub Releases 下载 tgz 后安装。
• **升级：**重复执行 add 命令；插件也会在面板中提示新版本。更新后重启 dsh web。
• 渠道配置、历史记录和画廊数据保存在 DSH 宿主侧，正常升级不会清空。

核心功能

| 能力 | 用途 | | --- | --- | | 无限画布 | 把提示词、参考图和生成节点连成可迭代的创作流程。 | | 电商套图 | 从商品参考图生成主图、卖点图、场景图等成套素材。 | | 文生图 / 图生图 | 使用兼容的生图渠道生成、编辑并比较图片。 | | 对话与 Agent | 在 DSH 对话中生成图片、继续编辑，并把结果带回会话。 | | 画廊与历史 | 管理创作结果、模板与标签；在不同设备上接续创作。 |

把文字、图片和生成配置连起来；从历史或画廊加入素材，再继续生成和迭代。

• 支持图片、文本、生成配置和文件节点；图片节点可标注、移除背景或拆分图层。
• 单个文件最大 50MB；可在画布内预览常见文档、表格、PDF、图片与音视频。
• 内置文本润色、图片描述、内容抽取和图片转可编辑 PPT 等技能；图片转 PPT 不需要另外安装第三方技能或配置 OCR token。
• 图片转 PPT 使用配置的聊天模型理解版式，在本地生成可编辑文字与基础矢量形状；复杂照片或插画可能会简化。
• 也可安装和管理外部技能。重任务技能会启动具有本机文件读写与命令执行能力的无头 Agent；运行前请检查技能来源和权限。
• 旧版第三方 image-to-editable-ppt 可继续用于独立 Agent 工作流；它不参与内置图片转 PPT，相关 OCR 或图片后端配置也不是内置流程的前置条件。
• 技能配置格式与安全边界见 docs/skill-config.md。

从商品主体和可选风格参考出发，先预览套图计划、逐张调整提示词，再批量生成；主图可作为其他用途图片的一致性参考。

输入提示词即可生成，也可上传参考图进行编辑；支持多张结果、比例与清晰度设置、任务队列、历史恢复和全屏预览。

在 DSH 对话里可让 Agent 调用生图；用 /edit_image 描述修改内容，也可从工作台或画廊把图片加入当前会话继续编辑。

多模型对比

同一提示词可提交给多个模型并列查看结果，便于快速挑选风格与质量。

提示词模板库内置精选案例、沧河、手绘、Prompt/Signal 与 GPT Image 2 五个来源，可搜索、筛选、收藏并直接带入生图。生成结果可在画廊中用标签和收藏继续整理。

可编辑海报：文字与 Logo

在无限画布的图片工具栏或右键菜单选择 「海报编辑：文字 / Logo」，即可叠加可编辑标题、价格和品牌 Logo。支持多行文字、自动换行、字体类别、字号、颜色、对齐、Logo 等比缩放、拖动定位、图层顺序及撤销重做。

• 保存到画布：生成新图片节点并保存可编辑图层，原图保持原样；再次打开新节点可继续编辑。请等待画布保存完成再关闭页面。
• 导出 PNG：下载与预览一致的合成图；PNG 本身不保存可编辑工程。
• 合成过程在本地完成，不调用模型；底图已有文字不会自动移除。最长边上限 4096 像素。

模型配置

在「设置 → 生图配置」添加渠道，填写 API 地址与密钥，检测并选择生图模型。可配置多个提供方，并设置默认生图模型和可选的提示词增强聊天模型。

chatgpt2api 图片任务接口：将渠道 API 地址填写为 https://你的网关/v1/videos，开启「完整 URL」，选择 Images 协议。文生图和图生图均使用 JSON 提交，以 n 一次请求 1–100 张图片，再自动轮询 /v1/videos/{任务ID}。比例通过 aspect_ratio 原样传递；选择「自动」则不传比例，不发送清晰度和细节参数。图生图最多支持 8 张参考图，最终显示服务端实际返回的所有图片。兼容图片接口 /v1/images/generations 和 /v1/images/edits 同样支持 n 与 202 异步任务响应。

支持 OpenAI 兼容的 Images API / Chat Completions，以及 xAI Grok、Google Nano Banana、Seedream、Qwen-Image、GLM-Image、MiniMax 等预置渠道；也可手动添加兼容模型。

• 通用渠道默认自动判断 Images API 与 Chat Completions；也可在设置中手动指定。
• One-API、New API、LiteLLM 等只暴露 /chat/completions 的网关，可填写完整接口地址并选择对应模型。
• API 密钥保存在 DSH 宿主设置中；未被自动识别的兼容模型可手动添加。
• 不同服务商的图生图、尺寸与返回格式可能不同，请确认所选模型实际支持的能力。

数据与安全

• API 请求经 DSH 宿主转发；密钥保存在本机设置中，不直接暴露给浏览器。
• 历史、画廊、画布和图片保存在 DSH 数据目录 ~/.dsh/dsh-imagegen/，由你控制。
• 生图与图生图会把提示词或参考图发送给所配置的上游服务；请按服务商政策处理敏感内容。
• 内置轻量技能会把所选内容发送给配置的聊天模型。图片转 PPT 的 PPTX 在本地生成，由原生文字与基础矢量形状组成，不会把整张原图直接铺成幻灯片背景；结果需人工检查。
• 外部重任务技能可能读写本机文件并执行命令；运行前请确认技能可信、输入内容可共享。
• 生图会消耗上游 API 额度；请人工检查生成结果。不要把 API 密钥贴到 Issue、日志或截图中。

QQ 交流群与支持

欢迎加入 QQ 群，一起交流 DSH、AI 生图与插件使用，也欢迎分享提示词、工作流和改进建议。

• Bug 报告 · 功能建议
• 查看所有 Issues · GitHub Releases
• 如果这个插件对你有帮助，欢迎给项目点个 Star。

pnpm run typecheck
pnpm run build
pnpm run watch
node scripts/smoke.mjs

本地打包并安装到 DSH 验收：

pnpm pack --pack-destination .
dsh plugin --profile web add ./superdsh-dsh-imagegen-<版本>.tgz

许可证

Apache-2.0

内置模板所引用的第三方项目与许可见 THIRD_PARTY_NOTICES.md。

模板库新增 Image Prompts（yukkcat/image-prompts）来源，支持在线刷新；「全部」标签跨来源搜索，搜索仅对标题与提示词正文进行不区分大小写的字面子串匹配。可用 pnpm fetch-templates image-prompts 更新发布快照。

「设置 → 生图配置 → 图片存储」的「模板下载代理」可填写 http://127.0.0.1:7890 或 127.0.0.1:7890 等 HTTP(S) 代理地址。模板列表刷新及所有模板参考图下载均使用该设置；留空直连，不自动读取系统代理。模板来源、全部、收藏、灵感墙和详情使用独立缓存目录/请求键；批量缓存按标签独立记录成功、失败与进度。图片下载最多同时 300 个，校验完整性后原子写入当前本地存储目录，损坏缓存自动重新下载，临时 HTTP 错误自动重试；支持的 GitHub/CDN 地址提供原站回退。批量缓存仅返回落盘状态，避免重复传输整张图片，失败可重试。生成历史与素材库仍使用各自的持久化目录。

自定义图片与缓存目录

在「设置 → 生图配置 → 图片存储与缓存」中：

• 本地图片存储目录：保存生成历史、素材库和画布图片，例如 D:\dsh-imagegen-data。
• 模板图片缓存目录：单独保存模板库、全部、收藏、灵感墙及详情图片缓存，例如 D:\dsh-imagegen-cache；留空时使用本地图片存储目录下的 template-images。各界面缓存状态继续独立。

默认数据位置为 DSH_HOME/dsh-imagegen，未设置 DSH_HOME 时为用户目录下的 .dsh/dsh-imagegen，Windows 通常位于 C 盘。保存设置后后续下载使用新目录。现有文件不自动搬迁；切换本地存储目录后，要继续访问旧历史，需要将原数据目录的内容复制到新目录。只改模板缓存目录不影响生成历史。

npm 发布内容

npm 安装包仅包含构建后的 lib/**/*.js、lib/templates/*.json、Cordis 插件声明、第三方声明及 npm 自动附带的包信息、README 和许可证。源码 src/、文档目录和源码映射不发布。运行 pnpm build 后，可用 node scripts/package-test.mjs 验证实际 tgz 不含源码且所有模板快照可独立加载；发布 Action 也会执行此检查。