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 和一键部署脚本,降低了环境配置的门槛。适合需要在智能体中集成图像生成能力的场景。