前言¶

DeepSeek Harness（DSH）採用插件化架構。在開發智能體或日常使用中，往往需要直接在工具鏈裏生成圖片，而不是切換到外部應用。dsh-image-gen 插件在 DSH 左側欄提供了一個全局畫廊（佈局參考 Cherry Studio），併爲 Agent 提供了對話生圖與編輯工具。

功能¶

該插件主要提供以下能力：

側邊欄繪畫：左側欄新增「繪畫」入口。包含畫廊項目、參數設置（服務商/模型/比例/清晰度等）、畫板區域和歷史記錄。
側邊欄圖庫：瀏覽所有項目，支持搜索、篩選、收藏、批量操作（移動/下載/刪除）以及導入本地圖片。
收藏 Prompt：提供書籤按鈕和快捷鍵（如 / 或 Ctrl/⌘+K），可快速管理常用提示詞。
對話工具：Agent 需要配圖時會自動調用以下工具：
- paint_image：單圖生成。
- paint_images：一次生成多張（最多 8 張）。
- edit_painting：圖生圖或改圖，支持上傳圖片、對話附件或文件路徑。
自定義端點：預置多家服務商，同時支持添加任意數量的自定義端點，並可自動拉取模型列表。
代理設置：支持全局代理（系統代理或自定義）以及單個服務商的獨立代理配置，並提供測試連接功能。
後臺生圖：工具支持 background 參數。設置爲 true 時，任務在後臺執行，Agent 可繼續輸出文字，圖片以 genimg:<任務 ID> 的形式在 Markdown 中內聯顯示。

安裝命令：

DSH 桌面版：
插件 → 添加插件，輸入 @copylee/dsh-image-gen，安裝後啓用。

命令行（dsh web 等其他 profile）：

dsh plugin --profile web add @copylee/dsh-image-gen@latest

運行環境：
* DSH 版本：0.1.7+
* Node.js 版本：^22.19.0 或 >=24

服務商配置：
安裝後，左側欄會出現「繪畫」入口。打開後點擊右上角設置，或進入 設置 → 插件 → 圖像生成，配置至少一個服務商的 API Key。

自定義端點：
在設置中點擊「服務商 +」新建。選擇接口協議（預置支持 ModelScope、Gemini、OpenAI、硅基流動等），填寫名稱、API 地址、Key 和模型（支持「拉取模型」）。

Agent 調用與顯示：
Agent 在判斷需要配圖時會調用 paint_image 等工具。後臺任務未完成時，配合 Markdown 語法 ![說明](genimg:<任務 ID>) 可顯示同比例的「生成中」佔位符，完成後自動替換爲圖片。

數據存儲：
畫廊數據存放在 ~/.dsh/storages/copylee-image-gen/gallery.json，圖片本體存儲在 DSH 附件庫。Prompt 和參考圖會發送至配置的服務商。

共存性：該插件與原插件 dsh-image-gen 使用不同的包名、路由和數據目錄，兩者可以同時安裝。
授權：自有代碼按 MIT 授權，移植文件按 Apache-2.0 授權，詳見 NOTICE。
隱私：API Key 存儲在 DSH 憑據庫中，瀏覽器端無法獲取明文。Prompt 和參考圖會發送給服務商。
目錄配置：默認數據目錄爲 ~/.dsh/storages/copylee-image-gen/，可通過環境變量 COPYLEE_IMAGE_GEN_HOME 或插件配置項 dataDir 修改。