dsh-jimeng —— 即梦(火山方舟 Seedream)生图插件

把「即梦（Seedream）文生图 / 图生图」带进 DeepSeek Harness —— 对话里说一句话，AI 就能画图。

DeepSeek Harness(DSH) 的生图插件：调用火山方舟 Volcengine Ark的即梦（Seedream）图片生成模型，支持文生图 + 图生图，提供两种使用方式：

1. 模型工具：对话里直接说「帮我画一只鲸鱼」，AI 会调用 generate_image / image_to_image 生图，图片落盘并直接显示在对话里。
2. 手动生图面板：设置 → 「即梦生图」分区，手动填 prompt（或选参考图）生图。

特性

• 🖼️ 文生图 generate_image + 图生图 image_to_image（参考图支持本地路径 / URL / data URL）
• 🔽 模型下拉选择：内置常见 Seedream 模型下拉 + 「检测可用模型」按钮（自动探测 OpenAI 兼容平台的生图模型）+ 自定义输入兜底
• ⚙️ 可编辑 API 配置：Ark API Key、baseUrl、文生图/图生图模型、默认尺寸、水印开关、保存目录，持久化到 ~/.dsh/dsh-jimeng.json
• 🗂️ 图片落盘：生成图自动保存到 ~/.dsh/jimeng-images/，同时注册为对话附件直接显示
• 🔒 Key 只存 host：API Key 不暴露给浏览器明文（前端只拿到掩码）

界面截图

「即梦生图」出现在设置侧边栏「模型」下方：

设置面板（可编辑 API 配置 + 手动生图）：

模型下拉 + 「检测可用模型」（自动探测 Seedream 生图模型）：

首次使用：三步完成

1. 安装插件

dsh plugin --profile web add link:G:\DSHJob\plugins\dsh-jimeng

或手动：把 "dsh-jimeng": "file:G:/DSHJob/plugins/dsh-jimeng" 加入 web profile 的 package.json dependencies，并在 dsh.profile.bundles 里加 "dsh-jimeng"，然后 pnpm install。

2. 填写 Ark API Key

打开 设置 → 即梦生图，填入火山方舟的 API Key：

1. 登录「火山引擎控制台 → 火山方舟（Ark）」；
2. 左侧「API Key 管理」→「创建 API Key」，复制整串 API Key；
3. 粘进「API Key」输入框，点「保存配置」。

⚠️ 注意：要填的是「API Key 管理」里的 API Key，不是账号级的 AccessKey/SecretKey（AK/SK）。AK/SK 是签名鉴权，Bearer 用不了，会报 401。

3. 重启并生图

重启 DSH Web Host、刷新页面后，两种方式生图：

• 对话里直接说「帮我画一只鲸鱼」；
• 或到「设置 → 即梦生图」手动填 prompt 生成。

接入方式

• 端点：POST {baseUrl}/images/generations（OpenAI 兼容）
• 默认 baseUrl：https://ark.cn-beijing.volces.com/api/v3
• 默认模型：doubao-seedream-4-0-250828（统一文生图/图生图；图生图模型可单独填 modelI2i）
• 鉴权：Authorization: Bearer <API Key>

插件走 OpenAI 兼容的 images 接口，任何暴露该接口的平台都能用，只需改 baseUrl + 模型名 + key：

平台	baseUrl	模型示例	备注
火山方舟 Ark	https://ark.cn-beijing.volces.com/api/v3	doubao-seedream-4-0-250828	官方，即梦 Seedream
硅基流动 SiliconFlow	https://api.siliconflow.cn/v1	其 Seedream / Kolors 模型名	OpenAI 兼容
自定义中转	你的中转地址	中转提供的模型名	OpenAI 兼容

注意：如果用的是 Seedream 3.0，文生图/图生图是两个不同模型（doubao-seedream-3-0-t2i-250415 / doubao-seedream-3-0-i2i-250415），请分别在「模型(文生图)」和「模型(图生图)」里填写。Seedream 4.0 起统一为一个模型，可同时做文生图和图生图。

工具说明

工具	参数	说明
generate_image	prompt(必填)、size、n(1-4)	文生图
image_to_image	image(必填)、prompt(必填)、size	图生图（参考图：本地路径 / URL / data URL）

兼容性

组件	要求
DeepSeek Harness	0.1.x（在 0.1.1-rc.2 验证）
Node.js	>= 20
图片平台	任何 OpenAI 兼容 /images/generations 服务

常见问题

生图报 401「API key format is incorrect / missing or invalid」

多半是 key 填错了：

1. 确认填的是「火山方舟 → API Key 管理」里的 API Key，不是 AK/SK；
2. 复制完整、别带空格/换行；
3. 确认账号已「开通火山方舟」；刚开通的话可以重新生成一次 key。

图生图报 400「invalid url specified」

旧版本插件把参考图发成了裸 base64 导致；升级到最新版即可（已改为发送 data:image/...;base64,... data URL）。

「检测可用模型」返回「未检测到生图模型」

火山方舟的 /models 接口主要返回对话模型；如果没检测到生图模型，直接用内置的 Seedream 下拉列表，或用「自定义」手动填模型名 / ep- 接入点 ID。

如何确认插件已载入

dsh --profile web --dump-config

配置中应当出现 name: dsh-jimeng。

如何卸载

dsh plugin --profile web remove dsh-jimeng

卸载后重启 DSH Web Host。

目录结构

dsh-jimeng/
├── package.json        # DSH bundle 插件元数据
├── cordis.patch.yml    # 插件挂载声明
├── index.js            # host 插件（工具 + HTTP API + 配置持久化）
├── client.js           # client 插件（设置分区 + 手动生图面板）
├── assets/             # README 首图 + 界面截图
└── README.md

许可证

MIT © 2026 Quqing-future