前言¶
DeepSeek Harness (DSH) 是一個插件化的智能體開發框架。由於文本模型無法直接處理圖像數據，在開發基於文本模型的 Agent 時，如果需要生成或編輯圖片，通常需要跳轉到外部工具。
sfyyy/dsh-generation-image 插件解決了這個問題。它爲 DSH 會話提供了一個 generate_image 工具，允許 Agent 調用用戶指定的 OpenAI 兼容圖像 API（如 xiaoyaoapi 或本地網關），並將生成的圖片持久化保存爲 DSH 附件，在會話 UI 中以縮略圖形式展示。
核心能力¶
該插件主要提供以下功能：
- 文本與圖像生成：支持純文本生成圖片（Text-to-Image），也支持通過
referenceImageIds參數基於已有附件進行編輯（Image-to-Image）。 - 會話集成：生成的圖像會自動保存爲 DSH 附件，並在對話界面的右側（助手側）渲染爲可點擊的縮略圖。
- 模型安全隔離：DeepSeek 文本模型在處理消息時，會將圖片塊重寫爲文本標記，確保模型不會直接接觸圖像數據。
- 多格式支持：支持 API 返回
b64_json格式，也支持返回遠程url格式（插件會自動下載字節流）。
安裝與啓用¶
插件通過 npm 安裝。安裝後需重啓 dsh web 以使 UI 生效。
# 使用 dsh CLI 安裝
dsh plugin --profile web add @dsh-extension/dsh-generation-image
安裝完成後，在 DSH Web 的設置中找到 “Generation Image” 選項進行配置。
配置¶
插件默認不提供憑證，需要用戶自行配置 API 端點和密鑰。配置優先級爲：設置頁面 > 環境變量 > 配置文件。
配置文件路徑爲 ~/.dsh/generation-image.json：
{
"enabled": true,
"baseUrl": "https://your-image-endpoint.example/v1",
"apiKey": "sk-xxxx",
"model": "gpt-image-2",
"size": "",
"quality": "auto"
}
主要配置項說明：
* baseUrl：OpenAI 兼容接口的根地址（需包含 /v1），默認爲空。
* apiKey / apiKeyEnv：API 密鑰，互斥，直接填入或通過環境變量覆蓋。
* size：默認尺寸，留空表示不限，或設爲 "auto"。
* quality：默認質量，默認爲 "auto"。
環境變量覆蓋支持：
* DSH_GENERATION_IMAGE_BASE_URL
* DSH_GENERATION_IMAGE_API_KEY
* DSH_GENERATION_IMAGE_MODEL
* DSH_GENERATION_IMAGE_SIZE
* DSH_GENERATION_IMAGE_QUALITY
典型用法¶
Agent 調用 generate_image 工具。該工具接收以下參數：
prompt(必需)：圖片描述。size(可選)：尺寸限制，默認爲空（不受限）。quality(可選)：質量設置，默認爲auto。count(可選)：生成數量，限制爲 1-4。如果請求數量超過 1，插件會自動將其拆分爲多次n=1的請求。referenceImageIds(可選)：用於/images/edits端點的圖片附件 ID。
示例：
Agent 可以通過提供 referenceImageIds 來請求修改一張圖片，或者不提供該參數僅進行文本生成。
注意事項¶
- BYO Credentials：插件不內置 API Key，必須自行配置。
- 會話重啓：安裝新插件後，務必重啓
dsh web進程，UI 纔會加載新的縮略圖渲染邏輯。 - 環境變量覆蓋：配置優先級遵循官方說明，環境變量可用於在不修改配置文件的情況下靈活切換環境。
- 生態歸屬：該插件屬於 DSH 生態的一部分，由社區維護，目錄地址爲 skillhub.cn，與 DeepSeek 官方無直接隸屬關係。
結語¶
dsh-generation-image 是在 DSH 中擴展多模態能力的基礎組件。它通過標準的 OpenAI 兼容接口，將圖像生成能力無縫集成到現有的智能體工作流中，同時通過附件機制解決了數據持久化的問題。
