DeepSeek Harness Image2 生图插件

前言¶

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。对于需要图像生成能力的场景，DSH 本身并不内置模型，开发者需要通过插件对接外部服务。oebeliever/dsh-image2-draw 作为一个社区维护分支，填补了这一空白。它允许用户通过配置 OpenAI Images 兼容的中转接口，直接在 DSH 中使用 gpt-image-2 模型进行绘图。

插件简介¶

这是一个 DeepSeek Harness 图像生成插件，默认模型为 gpt-image-2。它提供了文生图和图生图功能，支持多端点自动故障转移。该插件基于 JuneLearn 原版进行了社区维护，并增加了网关兼容性修复，通过 MIT 许可证开源。

安装与启用¶

在已安装 DSH 的环境中，使用以下命令添加插件：

dsh plugin --profile web add github:oebeliever/dsh-image2-draw

安装完成后，重启 DSH（运行 dsh web），插件会自动加载。

配置说明¶

进入 Settings → Plugins → Plugin config，找到 Image2 Draw 设置卡片。

基本参数：
- 需填写 baseURL 和 API Key。插件会自动为短格式的 baseURL 追加 /images/generations，并将图片编辑端点推导为 /images/edits。
- 默认模型为 gpt-image-2。
密钥管理：
- API Key 仅存储在 DSH 凭证中，不会出现在明文配置文件中。
网络与权限：
- 确保网络可访问 registry.npmjs.org 和 github.com。
- 如果网关按 Token 分组模型，API Key 必须属于网关的 Image 分组。

核心功能¶

插件提供了对话工具卡片和输入框上方的 Chat-dock studio，支持以下能力：

文生图 (image2-generate)：支持 1–8 张图片的生成，请求按顺序执行。
图生图 (image2-edit)：支持 1–8 张参考图片（支持 PNG / JPEG / WebP），用于图像编辑。
多视角人像模式：在 Chat-dock studio 中，上传同一人物的 2–8 张照片，生成保持面部、体型和发型一致的新图像。
自动故障转移：支持配置多达 8 个中转端点。当遇到网络错误、超时或 4xx/5xx 状态码时，会自动切换至下一个端点。
输出处理：对话中提供缩略图、放大查看和“另存为”功能；文件也会保存到 outputs/image2/ 目录。

尺寸与质量控制¶

尺寸：支持自适应尺寸、自动透传、网关友好预设以及自定义的 WIDTHxHEIGHT（需符合特定验证规则）。
质量：支持 low / medium / high / auto 四档质量设置。

注意事项¶

环境要求：需要 Node.js >= 20（DSH 支持 22.19.x 或 >= 24）。需要安装 Git 和 pnpm。
重试机制：HTTP 524 和超时错误不会被自动重试，以避免重复扣费。
Claude Code 兼容：同一仓库也是 Claude Code 插件，通过 skills/image2-draw 提供 Skill。

目录与源码¶

GitHub 仓库：oebeliever/dsh-image2-draw
插件目录：SkillHub