前言¶
DeepSeek Harness 的理念是「一切皆插件」。在使用本地或 API 網關進行圖片生成時，通常需要對接多個供應商的接口。dsh-image-generation 插件提供了設置頁，用於集中管理多個供應商和模型配置，並在對話中通過 image_generate 工具調用當前選中的模型。
功能¶
多供應商配置¶
進入 設置 → 生圖配置（左側導航）。可以添加多個供應商，配置名稱、Base URL、API 格式、API Key 以及模型組。密鑰通過憑據服務存儲，不直接寫入配置文件。
對話模型選擇¶
進入 設置 → 插件 → 插件配置 → 圖形生成。從配置過的模型中僅選一個作爲對話生圖模型。在此處可開關工具、設置默認尺寸和質量。
工具調用¶
Agent 在對話中需要生成圖片時調用 image_generate 工具。生成的圖片會寫入工作區 generate/image/ 目錄，並在對話中內聯顯示。
安裝與啓用¶
使用 npm 安裝：
dsh plugin --profile <name> add dsh-image-generation
注意：0.1.0 版本的
__ModuleLoader__id 爲dsh-image-gen，DSH 會拒絕啓動。請安裝 0.1.1 或更新版本。安裝前必須完全退出並重新打開 DSH（非刷新頁面）。
典型用法¶
- 打開 設置 → 生圖配置，添加供應商和模型，保存。
- 打開 設置 → 插件 → 插件配置，展開 圖形生成，選擇模型並保存。
- 在對話中讓 Agent 生圖，它會調用
image_generate。
工具參數：
prompt：必填，提示詞。size：圖片尺寸，支持1024x1024/1024x1536/1536x1024/auto。quality：質量，支持low/medium/high/auto。referenceImages：引用圖片，數量 1–5 張。
注意事項¶
- 版本兼容：0.1.0 版本存在啓動問題，請務必安裝 0.1.1 及以上版本。
- 啓動時機：DSH 在進程啓動時組合插件。先啓動後安裝必須完全退出並重新打開，僅刷新頁面無效。
- 插件重疊：與官方
@deepseek-ai/dsh-tool-image-generation功能重疊，本插件自帶設置頁，一般不必再裝官方包。 - 工具名衝突：與
dsh-plugin-subscriptions的工具名均爲image_generate。需根據需求選擇（API 網關生圖用本插件，訂閱生圖用 subscriptions）。
生態背景¶
DSH 是 DeepSeek 推出的智能體開發平臺，插件生態由社區維護。本插件維護者爲 whiteS18。
