dsh-image-gen

dsh plugin --profile web add dsh-image-gen

<div align="center">

<img src="docs/assets/readme/hero-zh.webp" alt="dsh-image-gen 中文功能概览" width="100%" />

<br />

<p><strong>简体中文</strong> · <a href="README.en.md">English</a></p>

🎨 dsh-image-gen

在 DeepSeek Harness 里，用说话的方式画图

<p><b>对话批量生图 · 看得懂草图的 AI 画布 · Agent 自动套用 500+ Prompt 灵感 · 订阅账号免 Key</b></p>

<p>

<a href="https://www.npmjs.com/package/dsh-image-gen"><img src="https://img.shields.io/npm/v/dsh-image-gen?style=flat-square&color=4f6ef7" alt="npm version" /></a>

<a href="https://www.npmjs.com/package/dsh-image-gen"><img src="https://img.shields.io/npm/dm/dsh-image-gen?style=flat-square&color=10b981" alt="npm downloads" /></a>

<a href="https://github.com/shanliuling/dsh-image-gen/actions/workflows/ci.yml"><img src="https://github.com/shanliuling/dsh-image-gen/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>

<a href="https://dsh-insights.com/p/shanliuling/dsh-image-gen"><img src="https://dsh-insights.com/badge/shanliuling/dsh-image-gen.svg" alt="DSH Insights health" /></a>

<a href="https://github.com/shanliuling/dsh-image-gen/stargazers"><img src="https://img.shields.io/github/stars/shanliuling/dsh-image-gen?style=flat-square" alt="GitHub stars" /></a>

<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-f5c542?style=flat-square" alt="License: Apache-2.0" /></a>

<a href="https://linux.do/"><img src="https://img.shields.io/badge/LINUX%20DO-社区友链-555?style=flat-square" alt="LINUX DO" /></a>

</p>

<p>

<a href="https://atomgit.com/shanliuling/dsh-image-gen"><img src="https://atomgit.com/shanliuling/dsh-image-gen/star/new_badge.svg" alt="AtomGit" height="55" /></a>

</p>

<p>

<a href="#一句话就能做到">一句话就能做到</a> ·

<a href="#快速开始">快速开始</a> ·

<a href="#核心能力">核心能力</a> ·

<a href="#provider-支持情况">Provider 支持</a> ·

<a href="#常见问题">常见问题</a>

</p>

<br />

<table>

<tr>

<td width="50%" align="center"><b>🔁 一句话，一整组图</b><br />_{一条消息Agent 批量生成几十张图片}</td>

<td width="50%" align="center"><b>✏️ 画个草图、圈个地方，AI 就懂</b><br />_{圈出剑 → 换成斧头 · 火柴人 → 成图}</td>

</tr>

<tr>

<td><a href="#chat-batch"><img src="docs/assets/readme/hero-batch.webp" alt="一条消息写 5 个画面，Agent 逐张生成并收进图库" width="100%" /></a></td>

<td><a href="#ai-canvas"><img src="docs/assets/readme/hero-canvas.webp" alt="在画布上圈出剑换成战斧，再把火柴人草图变成二次元剑士" width="100%" /></a></td>

</tr>

</table>

</div>

<br />

dsh-image-gen 是 DeepSeek Harness 的原生图像创作插件。它不是在对话框里塞一个生图按钮，而是让 Agent 本身学会画图：它能一次规划并生成一整组图，能看懂你在画布上的涂鸦和圈选，能自己去灵感库里找合适的风格模板。需要精细控制时，还有 Studio 工作台、多模型对比和图库。

已有 ChatGPT、Grok 或 Google 订阅？直接登录即可生图，无需额外购买 API Key。

支持：Gemini · OpenAI / Compatible · Seedream · DashScope · Grok Imagine · GLM-Image · 本地 ComfyUI

pnpm dsh plugin --profile web add dsh-image-gen@latest

每个版本的更新内容见 Releases。

---

一句话就能做到

不用学参数，也不用切页面，直接在 DSH 对话里说：

你在对话里说 · 插件会做什么

「给《咖啡店开业》这篇文章配 4 张插图，统一扁平插画风，16:9」 · 🔁 对话批量生图：Agent 把需求拆成 4 个 Prompt 逐张生成，一条消息收齐整组图

「用手绘风格 #123 画一张咖啡店菜单」 · ✨ 自动套用灵感：Agent 先在 500+ 案例库里检索对应风格，再套用模板出图

「把我在画布上画的草图变成正式插画」 · ✏️ 看懂画布：Agent 读取画布选区，把草稿变成成图

「把我圈出来的剑换成斧头，其他不变」 · 🎯 圈哪改哪：只改你标出的局部

「保持这个角色不变，换到雪地场景」 · 🎭 角色一致性：图生图时保持同一个人物或物体，不会换成长得相似的另一个

「同一个 Prompt，GPT 和 Gemini 各出一张对比」 · ⚖️ 多模型对比：并发调用多个模型，放在同一张画布上比较

<img src="docs/assets/readme/workflow-overview.webp" alt="dsh-image-gen 完整 AI 图像创作工作流" width="100%" />

---

快速开始

1. 安装插件

环境要求：DeepSeek Harness 稳定版本，Node.js ^22.19.0 或 >= 24.0.0。

在你的 DeepSeek Harness 项目根目录下运行：

pnpm dsh plugin --profile web add dsh-image-gen@latest

💬 极客提示：你也可以直接把这句话发送给 DSH 对话中的 Agent：<br />

帮我安装生图插件，在终端执行：pnpm dsh plugin --profile web add dsh-image-gen@latest

<details>

<summary><strong>其他安装方式（全局 / GitHub 直装 / 本地调试）</strong></summary>

# 若已将 dsh 安装为系统全局命令：
dsh plugin --profile web add dsh-image-gen@latest

# 从 GitHub 仓库直接安装最新代码：
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git

# 本地克隆源码开发安装：
git clone https://github.com/shanliuling/dsh-image-gen.git
pnpm dsh plugin --profile web add ./dsh-image-gen

</details>

2. 配置 Provider

重启 DSH 后，点击左侧边栏的 「插件」 图标打开插件面板，在 「已安装」 分区点击 dsh-image-gen，进入插件详情页即可看到「图像生成」配置表单：

插件面板 → 已安装 → dsh-image-gen

DSH 0.1.5 及更早版本没有插件面板，入口仍为「设置 → 插件 → 插件配置 → 图像生成」；插件已同时兼容两种入口。

选择 Provider，填写自己的 API Key，并按需调整模型、Endpoint / Base URL 与工作区保存选项。填好 Key 后可点击「测试连接」验证可用性，或点击「拉取模型」一键获取该厂商支持的全部生图模型，无需手动查文档。使用 ComfyUI 时，请填写 DSH Host 可访问的服务地址，并导入 API Format Workflow JSON。

已有 ChatGPT、Grok 或 Google 订阅？无需填写 API Key：展开对应的订阅 Provider 行，点击「登录」并在浏览器完成授权，即可直接开始文生图与图生图。

<div align="center">

<img src="docs/assets/readme/config.webp" alt="插件详情页选择默认 Provider、查看各渠道状态，并在对话输入框旁切换渠道" width="100%" />

<br />

_{选默认 Provider → 查看各渠道的 Key / 登录状态 → 在对话输入框旁随手切换。}

</div>

3. 开始创作

在聊天框中直接描述你想要的图片：

画一张雨夜霓虹街头的赛博朋克猫咪，电影感光线，16:9。

想要一整组图？直接说数量和统一风格：

给我的小红书笔记《周末露营清单》配 5 张图：帐篷、炉具、睡袋、照明、零食，统一日系手绘风，3:4。

也可以直接上传参考图，让 Agent 进行风格重构或局部编辑：

保持角色与构图不变，给猫咪戴上一副黑色墨镜。

<br />

<div align="center">

<img src="docs/assets/readme/chat-example.webp" alt="对话生图与风格重构效果" width="60%" />

<br />

_{在对话中直接生图、图生图与连续编辑。}

</div>

<br />

需要更细的参数控制时，点击会话顶部的 画廊 入口，进入 图库 / 工作台 / 灵感 / 收藏。

---

核心能力

<a id="chat-batch"></a>

🔁 对话批量生图：一句话，

…(truncated)