前言¶
DeepSeek Harness (DSH) 通过插件机制扩展功能。dsh-jimeng 是一个插件，用于将火山方舟（Volcengine Ark）的即梦（Seedream）图片生成模型接入 DSH。它解决了在 DSH 对话中直接调用外部绘图 API 的需求，让智能体具备生成图片的能力。
该插件由用户 Quqing-future 维护，采用 MIT 许可证。
核心功能¶
插件提供两种生图方式，并包含完整的配置与交互功能：
- 对话工具：支持
generate_image（文生图）和image_to_image（图生图）工具。在对话中直接调用即可，图片会落盘并直接显示在对话消息内。 - 图生图支持：支持 1-10 张参考图，支持本地路径、URL 或 Data URL 格式。
- 设置面板：提供手动生图面板，可在设置 → 「即梦生图」分区中操作。
- 模型选择：内置常见 Seedream 模型下拉列表，支持「检测可用模型」按钮自动探测生图模型，也支持自定义输入。
- 可配置项：可编辑 API Key、baseUrl、文生图/图生图模型、默认尺寸、水印开关、保存目录等，配置持久化。
- 图片落盘：生成的图片自动保存到
~/.dsh/jimeng-images/。 - 安全机制：API Key 仅在服务端存储，前端仅接收掩码后的 host，不会暴露明文 Key。
安装与启用¶
通过命令行安装插件：
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。
使用方式¶
安装并重启 DSH Web Host 后，有两种使用方式：
- 对话生图：直接在对话中输入指令，例如「帮我画一只鲸鱼」，AI 会自动调用
generate_image工具。 - 手动生图：进入设置页面，找到「即梦生图」分区，手动填写 prompt 或选择参考图进行生成。
注意事项¶
- API Key 获取：Key 需从火山方舟控制台获取，请注意区分「API Key」和账号级的 AccessKey/SecretKey（AK/SK）。
- 模型版本：Seedream 3.0 的文生图和图生图是不同模型；4.0 起模型统一，可同时用于文生图和图生图。
- 图生图限制：单次参考图上限为 10 张（服务端限制），插件在本地会进行拦截，超限请求不会发送。
- 运行环境：需要 Node.js >= 20 以及 DeepSeek Harness 0.1.x。
生态与链接¶
该插件遵循 DSH 「一切皆插件」的理念，可接入任何兼容 OpenAI /images/generations 接口的服务（如硅基流动或自定义中转）。
