DeepSeek Harness (DSH) 的插件化架構允許開發者通過簡單的配置調用各類外部服務。dsh-image-gen 插件通過封裝 OpenAI Images 兼容的接口,將文本生成圖像(Text-to-Image)和圖像編輯(Image-to-Image)的能力直接集成到 DSH 的對話流中。
該插件由 Anyway-one 維護,採用 MIT 許可證。它是對舊版 dsh-image2-draw 的重寫與修復,解決了原版在加載時可能崩潰的 Bug。插件不依賴本地存儲,而是將 API Key 僅寫入 DSH 的憑證系統(默認引用名爲 IMAGE_GEN_API_KEY),不會在設置文檔中回顯。
核心功能¶
- 配置入口:在 Settings → Plugins → Plugin settings 中提供獨立的 Image Gen 卡片。
- 工具支持:提供
image-generate(文本生成圖像,支持 1-8 張)和image-edit(圖像編輯,最多 8 張 PNG/JPEG/WebP 參考圖)工具。 - 端點兼容:僅需填寫 baseURL,插件會自動拼接路徑(如將
https://example.com/v1轉爲https://example.com/v1/images/generations)。 - 結果處理:圖像在對話中內聯渲染,支持縮略圖、燈箱縮放及保存。同時,圖像也會被持久化保存到會話工作目錄下的
outputs/image-gen/,文件自動編號,不會覆蓋。 - 安全與驗證:API Key 安全存儲。插件會對配置寫入、響應大小、超時及參考文件進行驗證;遇到 524/超時錯誤時不會自動重試,以避免重複計費。
安裝¶
使用 npx 安裝:
npx --yes -p @deepseek-ai/dsh dsh plugin --profile web add github:Anyway-one/dsh-image-gen
npx --yes -p @deepseek-ai/dsh dsh web
配置¶
- 打開 Settings → Plugins → Plugin settings,展開 Image Gen 卡片。
- 填寫 Endpoint (baseURL),例如
https://example.com/v1。 - 填寫 API Key(默認存儲在憑證中,引用名爲
IMAGE_GEN_API_KEY)。 - 可選:調整 Model(默認
gpt-image-2)、Edit endpoint 或 Timeout。 - 保存配置後,在對話中使用
image-generate或image-edit工具。
注意事項¶
- 插件以當前 DSH 進程權限運行,安裝前應檢查源碼與許可證。
- 如需固定版本,可使用
github:Anyway-one/dsh-image-gen#v0.1.0進行安裝。 - 注意 524/超時錯誤不會自動重試,需手動重試以避免重複計費。
該插件通過適配 OpenAI 兼容接口,簡化了 DSH 中圖像生成的配置流程,適合需要集成各類圖像模型能力的開發者。