前言¶
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 等級，可與本插件搭配使用，但彼此無硬依賴。
