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