前言¶
DeepSeek Harness（DSH）的对话界面擅长文本推理与工具编排，但 Harness 本身并不直接提供图像生成能力。若要在同一会话里让模型按提示词出图、或对已有图片做风格化编辑，常见做法是切到独立生图服务，再把结果手动贴回对话——流程割裂，也不利于智能体按步骤连续调用。
下面介绍社区插件 dsh-image2-draw（维护者 JuneLearn）。它通过第三方 OpenAI Images 兼容 中转接口调用 gpt-image-2，在 DSH Web 里完成文生图与图生图，并把结果直接展示在会话中。插件当前在 SkillHub 目录 归类为「模型推理」，GitHub 仓库约 10 stars，许可证为 MIT（package.json 版本 0.1.0）。
这是什么¶
dsh-image2-draw 是面向 DSH Web 配置档的 Image2 生图插件。安装后，在 Settings > Plugins > Configurable plugins 下会出现 Image2 Draw 配置卡片；只需填写中转服务提供的 baseURL 与 API Key，默认模型为 gpt-image-2。
插件不绑定某一家中转商：README 说明可任选实现 OpenAI Images 协议的 relay，自行评估价格、稳定性与隐私条款后再接入。baseURL 可填短路径（例如 https://example.com/v1），插件会自动拼接 /images/generations；图编辑端点默认为 /images/edits，也可通过 editURL 显式覆盖。
核心功能¶
按 GitHub README 与 package.json 可核对的能力如下。
配置与凭证
- 仅需
baseURL、API Key；模型、编辑端点、超时等可在设置页调整。 - API Key 只写入 DSH credentials，不进入普通 settings 文档，也不会经插件 state 接口返回。
文生图：image2-generate
- 单次可连续生成 1–8 张图，上游请求按顺序逐个发送。
- 支持自适应竖版、横版、方形尺寸，以及经验证的自定义宽高。
图编辑：image2-edit
- 接受 1–8 张参考图，格式为 PNG、JPEG 或 WebP；单张不超过 4MB，合计不超过 32MB。
- 格式按文件魔数检测，不依赖扩展名；相对路径从当前会话工作目录解析。
会话内展示与落盘
- 生成结果在对话中以专用工具卡片展示，支持缩略图、放大与 Save As。
- 客户端卡片解析图片附件时，不把图像内容注入不支持视觉输入的 DeepSeek 模型上下文。
- 图片同时保存到当前会话工作目录下的
outputs/image2/，重名时自动编号，不覆盖已有文件。
请求与安全边界
- 默认超时 180 秒，可配置范围为 1–3600 秒。
- 对设置写入、响应体积、超时与输入图片做校验。
- HTTP 524 与超时失败不自动重试，避免上游已出图却重复计费。
具体能力（如 gpt-image-2、编辑、自定义尺寸与质量档位）取决于所选中转的实现；若返回 HTTP 400 或 404，需对照服务商的模型名与 Images 端点文档排查。
安装与启用¶
环境要求¶
安装前确认本机具备：
- Node.js：DSH 当前支持 22.19.x 或 24 及以上，推荐 Node.js 24 LTS；自带
npm与npx。 - Git：用于从 GitHub 拉取插件。
- pnpm：
dsh plugin会在 profile 目录用 pnpm 安装或移除插件；可先执行corepack enable。 - 网络能访问
registry.npmjs.org与github.com。
插件以当前 dsh 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证，确认中转 API Key 的存放与出站请求符合你的安全策略。
方式一：npx（普通用户）¶
无需克隆 Harness 源码，也无需全局安装 dsh：
npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:JuneLearn/dsh-image2-draw
安装完成后启动 Web：
npx --yes -p @deepseek-ai/dsh dsh web
方式二：Harness 源码 + pnpm（开发者）¶
若已克隆 deepseek-harness 并在源码根目录开发：
cd D:\deepseek-harness
pnpm install
pnpm dsh plugin --profile web add github:JuneLearn/dsh-image2-draw
pnpm dsh web
Web 默认监听 http://127.0.0.1:3080；端口被占用时会换用其他端口。升级时重新执行对应的 add 命令即可，无需手动维护 profile patch。卸载示例（npx）：
npx --yes -p @deepseek-ai/dsh dsh plugin --profile web remove dsh-image2-draw
重启 dsh web 后，Image2 Draw 卡片与相关工具会一并移除。
典型用法¶
- 打开 Settings > Plugins > Configurable plugins > Image2 Draw。
- 填入中转服务提供的 API Key。
- 填入 relay 端点，例如
https://example.com/v1。 - 按需调整模型、编辑端点或超时；默认值在多数场景下可直接使用。
- 点击 Save，等待出现 Saved 状态。
- 新建会话，让模型调用
image2-generate文生图；或提供参考图路径后调用image2-edit。
文生图示例提示：
Call image2-generate to create a portrait cinematic poster of a future city at high quality.
图编辑示例提示：
Call image2-edit with D:\images\room.png and restyle the room with light Japanese wood while preserving the layout.
适用场景与注意¶
适合谁
- 已在 DSH Web 里编排智能体，希望在同一对话中完成「描述 → 出图 → 继续推理」的开发者。
- 已有或计划接入 OpenAI Images 兼容中转，且上游支持
gpt-image-2或等价模型名的团队。
使用前须知
- 生图质量、计费与数据留存由第三方中转决定，插件本身不托管模型。
- 参考图与生成图有体积与数量上限；大批量出图时注意会话目录磁盘占用。
- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；插件列表与 GitHub 仓库由维护者自行发布。
同作者的 DSH Reasoning Settings（dsh-reasoning-settings）用于在 Harness 里配置第三方模型的 reasoning 等级，可与本插件搭配使用，但彼此无硬依赖。
