前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。雖然 DSH 自身包含多種模型能力，但並非所有模型都具備生圖或改圖的能力。對於開發者或用戶而言，在純文本模型中直接調用生圖功能通常需要複雜的集成。
dsh-image-bridge 解決了這個問題。它作爲一個獨立的插件，爲 DSH 內沒有作圖能力的模型掛載了 image_generate（生圖）和 image_edit（改圖）兩個工具。通過配置外部服務，模型即可獲得繪圖能力，且圖片會作爲持久附件出現在對話中，並自動保存到會話工作區。
插件信息¶
- 名稱：kkj-luna/dsh-image-bridge
- 維護者：kkj-luna
- 類別：聯網工具
- 許可協議：MIT
- 核心價值：給 DeepSeek Harness 裏沒有作圖能力的模型接上外部生圖服務。
安裝與啓用¶
插件已發佈在 npm 上，安裝過程非常簡單。需要在 Web profile 下運行命令。
- 執行安裝命令：
dsh plugin --profile web add kkj-luna-dsh-image-bridge
-
安裝完成後，必須重啓
dsh web。插件代碼不支持熱重載，修改代碼後也需要重啓。 -
重啓後，打開 設置 → 生圖橋，確認頁面能正常加載。
核心功能¶
該插件主要提供以下能力：
- 工具掛載：爲模型掛載
image_generate和image_edit兩個工具。 - 持久化存儲：生成的圖片會作爲持久附件出現在對話流中，並另存到會話工作區的
generated-images/目錄下。 - 多服務商支持：支持任何 OpenAI 兼容的接口（如 OpenAI、智譜、通義千問、SiliconFlow 等）。
- 容錯機制：支持主用與備用模型自動切換。當主用模型連接失敗或生成超時（在請求發出後），會自動切換到備用模型。
- Web 界面配置：所有服務商配置、模型選擇均在 Web 界面完成。
- 安全性：
- API Key 安全存儲在 DSH 的憑據服務中（
$DSH_HOME/.credentials.yaml），不回傳瀏覽器，也不寫入配置文件。 - 對方返回的圖片地址會經過 SSRF 安全關卡檢查，僅允許
http/https並攔截本地與私網地址。
- API Key 安全存儲在 DSH 的憑據服務中（
典型用法¶
配置過程分爲三個步驟：
-
添加服務商
在 設置 → 生圖橋 中點擊「＋ 添加模型提供商」，輸入接口地址（如https://api.openai.com/v1）和 API Key。 -
測試並保存模型列表
點擊「測試連接」，獲取可用模型列表後，點擊浮層上的「保存」。注意，只有保存後模型纔會出現在下拉列表中。 -
選擇模型並使用
在頁面的「模型」區塊，爲生圖和改圖各選擇一個模型（可各配一個備用）。點擊「保存模型設置」。之後，直接在對話中對模型下達指令，例如「幫我畫一隻戴宇航頭盔的柴犬」，模型即可調用插件進行生圖。
注意事項與限制¶
- 重啓要求：修改插件代碼後必須重啓 DSH 才能生效。
- 密鑰管理：密鑰不存儲在配置文件中，僅存儲在憑據服務裏。刪除服務商配置不會自動清理已存儲的密鑰，需手動刪除。
- 導航欄圖標：當前導航欄圖標爲權宜方案，未來將依賴官方能力。
- 超時策略：插件默認只會在連接失敗時切換備用模型，不會因爲生成速度慢而切換。
