前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在桌面端開發智能體時，生圖功能通常需要外部面板或手動切換視圖。dsh-tool-imagegen 旨在解決這一問題：它允許模型在對話中自動調用 generate_image 工具，生成的圖片直接內聯顯示在對話框中，無需額外的操作步驟。

核心功能¶

本插件提供以下核心能力：

• 自動工具調用：模型聽到生成請求時自動調用 generate_image，參數由模型組織。
• 對話內聯顯示：生成的圖片以卡片形式出現在對話流中，支持全屏查看、下載、本地打開和修改。
• 純文本輸入支持：支持純文本輸入，包含上傳參考圖和圖生圖。模型側通過自定義 generated-image / uploaded-image 塊展示圖片，對模型不可見，確保純文本模型也能安全使用。
• 網絡容錯：支持網絡自動重試（指數退避，最多 3 次），但不重試 4xx 錯誤（如模型不存在）。
• 雙模型兼容：兼容純文本模型和圖像輸入模型。
• 設置與安全：設置頁可配置接口地址、API 密鑰、模型名、默認尺寸等。密鑰僅保存在本地 settings.yaml 中，不回顯，且使用 loopback 圍欄限制訪問。

安裝與啓用¶

插件安裝後，需要將其掛載到桌面 profile。

1. 複製插件目錄到 DSH 插件目錄：

    cp -r dsh-tool-imagegen C:/Users/CJX/.dsh/plugins/

2. 進入桌面 profile 目錄，安裝依賴：

    cd C:/Users/CJX/.dsh/profiles/desktop
    pnpm install

3. 完全退出 DSH 後重新啓動。

典型用法¶

用戶可以通過自然語言觸發生圖：

• “生成一個貓咪的圖片”
• “把這張圖改成…”
• “基於這張圖改…”

對於純文本模型，需確保設置頁“向模型告知能力”已開啓。已生成的圖片支持點擊“修改”按鈕，將其作爲參考圖進行連續修改（圖生圖）。

注意事項¶

• 圖生圖限制：圖生圖功能需要上游接口支持 OpenAI 兼容的 /images/edits 接口。如果上游只實現了 /images/generations，圖生圖將失敗。
• 錯誤處理：4xx 錯誤（如模型不存在）不會觸發重試。5xx 錯誤或網絡抖動會自動重試。
• 輸出格式：當前輸出格式和風格與網關可能不兼容。
• 存儲清理：在設置頁可配置“生圖存儲”卡片，用於清理不被任何會話引用的孤兒文件。
• 安全與權限：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。