前言¶
DeepSeek Harness (DSH) 是一個本地智能體開發環境。在對話中直接生成圖片通常需要調用雲端 API。dsh-qwen-paint 插件解決了這個問題，它允許 DSH 在對話中直接調用本機運行的 ComfyUI，使用千問 Qwen-Image 2.1 模型進行繪圖。整個過程運行在 127.0.0.1 上，不需要任何 API Key，也不需要網絡連接。
插件簡介¶
這是一個 DSH 插件，分爲 Host 和 Client 兩部分。它註冊了一個名爲 draw_image 的工具。
* Host 側：負責工具註冊、空閒 5 分鐘自動關停 ComfyUI、掛載只讀狀態端點。
* Client 側：負責在 Composer 下方顯示 ComfyUI 在線狀態，以及內聯顯示生成的圖片。
依賴與安裝¶
依賴環境¶
安裝前需滿足以下條件：
* ComfyUI：需跑在 127.0.0.1:8188。
* 模型文件：需要三個千問模型文件（約 13.3 GB），具體文件名和路徑見下方說明。
* 顯卡：NVIDIA 顯卡開箱即用；AMD Radeon 建議使用 ROCm 路線（注意：A 卡可能遇到靜默出錯）。
安裝步驟¶
- 通過 Plugin Manager 安裝
在 DSH 完全退出後，使用以下命令安裝插件：
dsh plugin --profile desktop add link:<本目錄>
安裝後**必須徹底退出 DSH 再重新打開**，宿主側的工具清單隻在啓動時裝配一次。
- 一鍵部署（推薦）
插件提供了安裝腳本，可以自動檢測環境並下載模型文件。
node scripts/setup.mjs
該腳本會自動查找 ComfyUI，下載所需的三個模型文件到正確目錄，並進行 SHA256 校驗。如果中途斷網，直接重跑即可斷點續傳。
- 僅安裝插件本體
如果 ComfyUI 和模型已就緒，只需掛載插件：
node scripts/install.mjs
使用方法¶
安裝並重啓 DSH 後，在聊天框中直接輸入描述即可。助手會調用 draw_image 工具。
示例：
畫一隻在雪地裏的柴犬，逆光，膠片顆粒，電影感
給我畫一張 16:9 的賽博朋克雨夜街景，霓虹反射在積水上
用同樣的種子再畫一遍剛纔那張
參數說明：
* prompt：必填，畫面描述。
* size：畫幅比例，默認 1:1，支持 3:4、16:9 等多種比例。
* megapixels：總像素，默認 1.0。
* seed：隨機種子，不填則每次不同。
* negative：負面提示詞。注意千問模型配置較低，負面詞基本不生效。
功能特性¶
- 純本地運行：不出網，不需要任何 API Key。
- 自動空閒關停：出圖後 5 分鐘無操作，ComfyUI 會自動關閉以釋放顯存。
- 狀態可視化：在 Composer 下方顯示 ComfyUI 的在線狀態（綠色在線、黃色忙碌、灰色離線）。
- 內聯顯示：生成的圖片會直接顯示在聊天框中，而非僅作爲附件。
注意事項¶
- 模型限制：模型文件禁止商用。
- 顯存佔用：三個模型共約 14 GB，對顯存有要求。
- 首次加載：首次出圖加載模型較慢，請耐心等待。
- AMD 用戶：可能遇到靜默出錯，跑完必須人眼檢查圖片。
- 配置文件：修改配置需編輯
cordis.patch.yml，升級插件時不會覆蓋該配置。
