前言¶

DeepSeek Harness (DSH) 採用插件化架構，其核心運行時主要針對文本流式響應進行適配。直接接入圖片生成 API（如 Stable Diffusion、DALL-E 等）通常需要編寫自定義適配器，將 API 響應轉換爲 DSH 原生的圖片塊並持久化到會話附件中。dsh-plugin-use-images 插件通過自定義適配層，解決了這一集成問題。

這是什麼¶

這是一個將圖片生成 HTTP API 適配爲 DSH 可選模型的插件。由用戶 chuling-lingling 維護。它允許用戶在 DSH 聊天界面中直接調用外部圖片生成接口，並將返回的圖片作爲會話附件處理。

核心功能¶

• API 適配：將生成圖片的 HTTP API 適配爲 DSH 可選模型。
• 響應格式支持：支持 JSON URL、JSON base64、JSON data URL、text/plain URL/data URL 以及 HTTP 直接返回的 image/png/jpeg/webp/gif。
• 模板變量：支持在請求 JSON 模板中使用 {{prompt}}、{{model}}、{{n}} 和 {{apiKey}} 變量。
• 配置方式：支持在設置頁配置 Base URL、API Key、模型 ID，以及高級接口的 JSON 模板、Headers 和響應提取路徑。支持 YAML 備用配置及熱更新。

安裝與啓用¶

使用官方安裝命令添加插件：

dsh plugin --profile web add github:chuling-lingling/dsh-plugin-use-images

安裝完成後重啓 dsh web 即可生效。

典型用法¶

1. 在聊天框的模型選擇器中選中圖片模型。
2. 在設置頁的「圖片 / 視頻 API」區域新增接口，填寫 Base URL、API Key 和模型 ID。
3. 在聊天界面發送文本，該文本將作爲 prompt 發送給圖片 API，響應結果會轉換爲 DSH 原生圖片塊並保存到會話附件中。

適用場景與注意¶

• Node 版本要求：運行環境需安裝 Node.js >= 20。
• 模型 ID 規則：DSH 模型 ID 僅支持小寫字母、數字和 -。
• 性能限制：單張下載圖片上限默認爲 20 MiB，生成及下載總超時默認爲 120 秒。

短結尾¶

該插件通過將 HTTP 圖片 API 統一適配爲 DSH 模型，簡化了在 DSH 中使用外部生圖服務的流程。完整的配置示例和源碼可查看 GitHub。