DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在開發智能體時,如果需要頻繁生成圖片,反覆調用外部 API 或切換窗口會打斷工作流。dsh-plugin-quick-draw-tool 提供了一個常駐的繪圖面板,直接在 DSH 界面中通過本地 ComfyUI 進行文生圖。
該插件由用戶 Yinbenfeng 維護,旨在提供一種輕量級、零配置依賴的本地繪圖方案。
插件定位¶
這是一個基於本地 ComfyUI 的 DSH 常駐畫圖面板。插件不依賴複雜的第三方自定義節點,通過一鍵部署固定版本的 ComfyUI,確保工作流的穩定性。
核心功能¶
- 常駐入口:DSH 啓動後,右下角常駐“畫圖”按鈕,無需在對話中調用。
- 繪圖控制:支持兩段提示詞、寬高、步數、隨機/指定種子設置。
- 交互體驗:提供圖片預覽與放大查看功能。
- 工作流管理:提示詞 2 可保存爲常駐預設;圖片採用安全編號保存,絕不覆蓋。
- 環境部署:一鍵部署固定版本 ComfyUI,工作流零第三方自定義節點。
安裝與部署¶
1. 安裝插件¶
在項目目錄下執行以下命令安裝:
npm install git+https://github.com/Yinbenfeng/dsh-plugin-quick-draw-Tool-.git
將包加入 DSH Web Profile 的依賴和 bundle 列表:
{
"dependencies": {
"dsh-plugin-quick-draw-tool": "git+https://github.com/Yinbenfeng/dsh-plugin-quick-draw-Tool-.git"
},
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-plugin-quick-draw-tool"
]
}
}
}
2. 部署 ComfyUI¶
在項目根目錄運行部署腳本:
powershell -ExecutionPolicy Bypass -File .\scripts\setup.ps1
腳本會在默認目錄克隆並安裝 ComfyUI,並固定到 v0.33.0 版本。
3. 下載模型¶
模型文件不隨插件分發,需自行下載並放入指定目錄。請參考以下路徑和許可證要求:
| 文件 | 完整放置路徑 | 下載頁面 | 許可證 |
|---|---|---|---|
krea2_turbo_mxfp8.safetensors |
%USERPROFILE%\.dsh\comfyui-drawing\ComfyUI\models\diffusion_models\krea2_turbo_mxfp8.safetensors |
Comfy-Org/Krea-2 | Krea 2 Community License |
qwen3vl_4b_fp8_scaled.safetensors |
%USERPROFILE%\.dsh\comfyui-drawing\ComfyUI\models\text_encoders\qwen3vl_4b_fp8_scaled.safetensors |
Comfy-Org/Qwen3-VL | Apache-2.0 |
qwen_image_vae.safetensors |
%USERPROFILE%\.dsh\comfyui-drawing\ComfyUI\models\vae\qwen_image_vae.safetensors |
Comfy-Org/Qwen-Image_ComfyUI | Apache-2.0 |
注意:Krea 2 Turbo 適用 Krea 2 Community License,包含商業使用門檻和內容過濾要求。
4. 啓動 ComfyUI¶
powershell -ExecutionPolicy Bypass -File .\scripts\start-comfyui.ps1
ComfyUI 默認監聽 127.0.0.1:8188。
5. 重啓 DSH¶
重啓 DSH 後,在右下角即可看到“畫圖”入口。使用流程爲:提示詞 → 生成 → 預覽 → 保存。
環境變量¶
插件支持通過環境變量自定義配置:
| 變量 | 作用 | 默認值 |
|---|---|---|
DSH_COMFYUI_ROOT |
ComfyUI 安裝目錄 | %USERPROFILE%\.dsh\comfyui-drawing\ComfyUI |
DSH_COMFYUI_URL |
ComfyUI 服務地址 | http://127.0.0.1:8188 |
DSH_COMFYUI_WORKFLOW |
API 工作流絕對路徑 | 包內 workflows/t2i-v7-api.json |
DSH_COMFYUI_PRESETS |
提示詞 2 預設存儲文件 | %USERPROFILE%\.dsh\comfyui-prompt2-presets.json |
注意事項與許可¶
- 插件原創代碼採用 MIT 許可證。
- 第三方組件適用各自許可證:ComfyUI (GPL-3.0)、Krea 2 Turbo (Krea 2 Community License)、Qwen 模型組件 (Apache-2.0)。
- PyTorch 與顯卡驅動需用戶自行安裝,插件不包含模型權重。
- 模型下載後請檢查許可證條款,尤其是 Krea 2 Turbo 的商業使用限制。
總結¶
dsh-plugin-quick-draw-tool 解決了 DSH 開發者在本地快速生成圖片的需求。通過固定版本的 ComfyUI 和一鍵部署腳本,降低了環境配置的門檻。適合需要在智能體中集成圖像生成能力的場景。