为 DeepSeek Harness Web 端补上对话内生图能力，支持 Google Gemini、OpenAI 与字节 Seedream 三家厂商，并自带本地生图画廊。
- 语言
- TypeScript
- License
- MIT
- 分支
- main
安装
$ dsh plugin --profile web add github:shanliuling/dsh-image-gen在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 shanliuling/dsh-image-gen：先查看仓库 https://github.com/shanliuling/dsh-image-gen.git 确认安全性，然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手，由它代你完成安装与验证。
一句话定位
为 DeepSeek Harness (DSH) Web 端补上"对话内生图"原生能力，支持 Google Gemini、OpenAI（含兼容中转）与字节 Seedream（火山方舟）三家厂商，并自带本地生图画廊、全屏预览、复制与下载等交互。
核心能力
- 在对话中用自然语言触发图片生成，Agent 自动调用
generate_image工具并把图片直接渲染到当前会话流 - 同时支持 Google Gemini、OpenAI / OpenAI 兼容中转、字节 Seedream（火山方舟）三家厂商，可在 Web 设置中随时切换
- 顶栏自带"画廊"Tab，按时间倒序汇总所有历史生成图片，支持按 Prompt 关键词搜索和按厂商筛选
- 图片结果接入 DSH 自身的 Attachment 与 Conversation 体系，重开历史会话仍能看到之前生成的图
- 鼠标悬停图片或进入画廊后，支持全屏大图预览、一键复制到剪贴板、本地下载、新标签页打开
- API Key 通过 DSH 自带凭据服务加密管理，前端只写不读，无明文持久化
技术实现
- 语言: TypeScript（含 React 客户端）
- 关键依赖:
@deepseek-ai/cordis、@deepseek-ai/dsh-tools、@deepseek-ai/dsh-attachment、@deepseek-ai/dsh-credentials、react - 架构模式: DSH Bundle 双面注入 — Host 面在
src/index.ts用 Cordisapply(ctx, config)注册generate_image工具 + 同源图片 HTTP 路由，Client 面在src/client/index.tsx向settings.plugin.item、tool.call.toolview、conversation.view三个槽位分别注入设置卡片、对话结果卡片和画廊 Tab；画廊元数据用浏览器 IndexedDB 本地持久化 - 入口文件:
src/index.ts（Host face，lib/index.js） /src/client/index.tsx（Client face，lib/client.js）
适用场景
想让 DSH Agent 在聊天中直接生成插画、概念图、博文配图的人。安装后只需填一次 API Key，再让 Agent 描述想要的画面，图片会出现在当前对话中并自动归入"画廊"供后续查找、复制、下载。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DeepSeek Harness | >=0.1.0-rc.5 | 由 peerDependencies 声明；需使用 web profile |
| Node | >=22.19.0（也支持 >=24.0.0） | 由 engines.node 声明 |
| Cordis | >=4.0.0 <5 | 插件 Host face 注入框架 |
| React | >=18.2.0 <19 | Client face 渲染依赖 |
| Schemastery | >=3.18.0 <4 | 配置 Schema 定义 |
| 平台 | 仅 Web | dsh.client.platform 显式声明为 web，不适用于 headless / desktop profile |
| 原生模块 | 无 | 纯 JS + 标准浏览器 API |
安装方式
dsh plugin --profile web add github:shanliuling/dsh-image-gen
配置项
| 配置 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| provider | 字符串 | 选择生图厂商：google（Google Gemini）、openai（OpenAI 或兼容中转）、seedream（字节火山方舟） | google |
| googleModel | 字符串 | Google 端使用的模型名 | gemini-3.1-flash-image |
| googleEndpoint | 字符串 | Google Interactions 接口完整地址（含反代场景） | https://generativelanguage.googleapis.com/v1beta/interactions |
| openaiModel | 字符串 | OpenAI / 兼容中转端使用的模型名 | gpt-image-2 |
| openaiBaseURL | 字符串 | OpenAI 兼容 /v1 接口地址（用于中转站/反代） | https://api.openai.com/v1 |
| seedreamModel | 字符串 | 火山方舟 Seedream 模型名 | doubao-seedream-5-0-260128 |
| seedreamBaseURL | 字符串 | 火山方舟 /api/v3 接口地址 | https://ark.cn-beijing.volces.com/api/v3 |
API Key 不在前述 Config schema 中，而是由 DSH 凭据服务单独保存，前端只写入不读回明文，凭证名分别为 GEMINI_API_KEY / OPENAI_API_KEY / ARK_API_KEY。
常见问题
Q: 安装后在哪里填 API Key？
A: 打开 DSH Web（默认 http://localhost:3080），进入 Settings → Plugins → Image generation，展开卡片后选择 Provider 并填写对应 API Key 保存即可。Key 通过 DSH 凭据服务加密保存，前端不会显示明文。
Q: 是不是必须给三个 Provider 都准备 Key？
A: 不必，只需要给当前选中的那一个 Provider 准备即可；切换 Provider 后再补对应的 Key。
Q: OpenAI Compatible 模式可以接哪些服务？
A: 凡是提供与 OpenAI /v1/images/generations 兼容接口的服务都可以，包括各类中转站、自部署网关或火山方舟等同协议接入点，把 Base URL 改成对应服务的 /v1 地址即可。
Q: 生成的图片存放在哪里？
A: 图片二进制由 DSH 自身的 Attachment 服务持久化，可随历史会话重新打开；画廊使用的索引元数据（Prompt、Provider、模型等）保存在浏览器 IndexedDB，卸载插件或换浏览器不会自动同步。
Q: 顶栏看不到"画廊"Tab 怎么办？
A: 画廊 Tab 由插件注入到 conversation.view 槽位，安装完成后会自动出现；如果没出现，请确认当前是 web profile，刷新页面或检查插件是否被禁用。
Q: 报错 "generate_image requires the XXX credential" 是什么意思？
A: 当前选中 Provider 对应的 API Key 尚未配置，回到 Settings → Plugins → Image generation 填写并保存即可，错误信息中会带出对应的环境变量名（GEMINI_API_KEY / OPENAI_API_KEY / ARK_API_KEY）。
Q: 一次能生成多张图片吗？
A: generate_image 工具每次调用返回一张图，但 Agent 可根据需要自动连续多次调用，所有结果都会进入画廊统一管理。
Q: 可以把生成的图片下载到本地吗？
A: 可以。鼠标悬停到对话里的图片或画廊卡片，会出现工具条，点击下载图标即可保存为 PNG/JPEG 到本地。
上手难度
入门 — 装好之后只需要在设置里填一个 API Key，其余参数保持默认即可对话生图；切换厂商和调整模型都在同一个设置卡片里完成。
已知问题与限制
- 仅支持 Web profile：
dsh.client.platform显式声明为web，headless / desktop profile 下无法加载 - 受 DSH 自身
attachments.imageLimits.maxImageBytes上限约束，超过限制的图片会被插件主动拒绝并抛错 - 仅接受
image/png、image/jpeg、image/webp、image/gif四种 MIME 类型的图片入库 - Google 端支持
aspect_ratio与image_size（1K/2K/4K）控制；OpenAI 与 Seedream 端只走size字段 - Google Gemini 官方接口在部分网络环境下连通性可能受限，可通过
googleEndpoint配置反代或中转地址解决
🎨 dsh-image-gen
让 DeepSeek Harness 像 ChatGPT 一样在对话中直接生成图片，支持画廊汇总,全屏预览、快捷复制与一键下载。
English | 简体中文
💬 直接对你的 DeepSeek Harness Agent 发送以下提示词：
帮我安装生图插件，执行命令：pnpm dsh plugin --profile web add dsh-image-gen@latest
（也可以手动在终端执行：pnpm dsh plugin --profile web add dsh-image-gen@latest）
安装完成后，在 DSH 设置中填入自己的 API Key，就可以直接对 Agent 说：
帮我画一张雨夜霓虹街头的赛博朋克猫咪。
Agent 会自动调用 generate_image，生成图片并直接显示在当前对话中。
💡 它解决什么问题？
dsh-image-gen 是专为 DeepSeek Harness (DSH) 打造的开源图像生成插件。
DeepSeek Harness 已经可以让 Agent 调用不同工具完成任务，本项目为它补上了原生的多模态生图能力：
graph LR
A[用户 Prompt] --> B[DeepSeek Harness Agent]
B --> C[generate_image 工具]
C --> D[Gemini / OpenAI / Seedream]
D --> E[图片数据]
E --> F[当前 Conversation 对话流]
🚀 快速安装与使用
1. 安装插件
在你的 DeepSeek Harness 项目根目录下运行：
# 推荐方式：安装或升级到最新版本
pnpm dsh plugin --profile web add dsh-image-gen@latest
# 若已将 dsh 安装为系统全局命令：
dsh plugin --profile web add dsh-image-gen@latest
🛠️ 其他安装方式（Git 仓库直装 / 本地调试）
# 方式 B：从 GitHub 仓库直接安装最新代码
pnpm dsh plugin --profile web add git+https://github.com/shanliuling/dsh-image-gen.git
# 方式 C：本地克隆源码开发安装
git clone https://github.com/shanliuling/dsh-image-gen.git
pnpm dsh plugin --profile web add ./dsh-image-gen
2. 配置 API Key
打开 DSH Web 页面（默认 http://localhost:3080）：
- 进入 Settings → Plugins → Image generation。
- 选择 Provider，填写 API Key，点击 保存 即可。
3. 开始对话生图
现在直接在聊天框输入：
生成一张极简主义的现代建筑客厅插画。
当前 Agent 就会自动调用 generate_image 工具并在对话流中返回图片。
4. 查看原生生图画廊
点击会话顶栏的 [画廊] Tab，即可集中查看和搜索所有对话生成的历史图片：
✨ 主要能力
- 💬 对话中直接生图：不需要切换到其他网站，也不需要手动复制 Prompt，直接告诉 Agent 你想画什么即可。
- 🖼️ 历史生图画廊：顶栏自带「画廊」Tab，自动汇总所有历史生成的图片，支持关键词搜索、厂商筛选与一键复制/下载。
- 🔍 交互式图片工具：支持点击全屏大图预览、一键复制图片到剪贴板、本地下载与新标签页打开。
- 🎨 多 Provider 支持：目前支持 Google Gemini、OpenAI Images、OpenAI Compatible API 以及 ByteDance Seedream / Volcengine Ark。Provider、模型和 Endpoint 都可以在设置界面中自由修改。
- 🔑 BYOK (自带 Key)：插件使用你自己的 API Key。API Key 通过 DeepSeek Harness 的
credentials服务管理，采用写保护隔离，不需要写进项目源码或配置文件，前端不存明文。 - 🖼️ 图片跟随会话保存：生成结果会接入 DeepSeek Harness 的 Attachment / Conversation 体系，重新打开历史会话后，仍然可以看到之前生成的图片。
- ⚙️ 原生设置界面：Provider、API Key、模型和 Endpoint 都可以直接在 DSH Web 设置中修改，不需要手动编辑配置文件。
📦 支持的 Provider
| Provider | 默认模型 | 默认 Endpoint / Base URL |
|---|---|---|
| Google Gemini | gemini-3.1-flash-image | https://generativelanguage.googleapis.com/v1beta/interactions |
| OpenAI Images | gpt-image-2 | https://api.openai.com/v1 |
| OpenAI Compatible | 自定义 | 自定义 Base URL |
| ByteDance Seedream / 火山方舟 | doubao-seedream-5-0-260128 | https://ark.cn-beijing.volces.com/api/v3 |
🛠️ 本地开发 (Development)
# 克隆仓库
git clone https://github.com/shanliuling/dsh-image-gen.git
cd dsh-image-gen
# 安装依赖与构建
pnpm install
pnpm run typecheck
pnpm run test
pnpm run build
# 检查 npm 打包内容
pnpm run pack:check
📄 开源协议 (License)
本项目基于 MIT License 开源。
如果这个插件对你有用，欢迎点一个 ⭐️ Star 支持！
收录徽章
[](https://deepseek-plugin.org/plugins/shanliuling/dsh-image-gen)把这段 markdown 粘贴到你的 GitHub README，链接回本插件详情页。徽章只声明已被本站收录，不代表安全认证。