前言¶
在 DSH 里做智能体或日常开发时，常见做法是把生图交给外部 API，或在浏览器和 ComfyUI 之间来回切换。对话里要出图、工作区要落文件、面板里又要调步数和种子，三条路径往往对不齐。dsh-comfyui 把本地 ComfyUI 的 text-to-image 收进 Harness：侧边栏生图面板、对话工具 image_generate、磁盘图库共用同一套后端，并围绕 Krea 2 Turbo 预设做了提示词优化、画师风插画与真像素游戏资产两条风格线。
这是什么¶
dsh-comfyui 由 prophetcrab 维护，MIT 许可，当前包版本 0.8.0，要求 DSH >=0.2.1-rc.2 <0.3.0。插件本身不捆绑 ComfyUI 与权重，只驱动本机已安装的 ComfyUI；通过 /object_info 发现模型，GGUF（UnetLoaderGGUF + CLIPLoaderGGUF）与常规 UNETLoader/CLIPLoader 均可。内置预设指向 Krea 2 Turbo（GGUF Q4 + Qwen3-VL 文本编码器 + Qwen-Image VAE）。
社区目录页：prophetcrab/dsh-comfyui。源码与完整环境清单见 GitHub：prophetcrab/dsh-comfyui 及仓库内 SETUP.md。
核心功能¶
生图面板¶
侧边栏入口 ComfyUI 生图 打开主面板：提示词框、Krea 调过的 优化提示词、尺寸 / 步数 / guidance / 种子、实时进度、最近一次结果，以及落盘的图库。渲染过程中显示步进进度、耗时和 停止；切换页面后面板保留草稿与进行中的任务。图库缩略图悬停可 删除（二次确认）。对话里生成的图 additionally 会复制到工作区 generated/。
自动拉起 ComfyUI¶
插件探测 127.0.0.1:8188；若无响应则启动 <comfyRoot>/run.sh（README 示例路径为 ~/tools/ComfyUI/run.sh）。首次启动可能较慢：探针通过后，第一次任务会加载约 15 GB 权重（模型需事先按 SETUP.md 准备）。
对话工具 image_generate¶
智能体可通过 image_generate 在对话中出图，并写入工作区 generated/。参数与面板预设一致，例如普通插画、像素资产、参考图模式等（见下文典型用法）。
两套预设¶
面板 预设 卡片并排两项，注册表为 lib/prompt.js 中的 STYLES：
| 预设 | id | 作用 |
|---|---|---|
| 画师风插画 | illustration |
带线稿与笔触感的数字插画 |
| 像素游戏资产 | pixel |
经 LoRA 与 refiner 得到真实格子像素精灵，而非缩小版插画 |
画师风插画 下可选 通用 或 14 位画师参考 chip（新海诚、吉卜力、京阿尼等，见 README ARTISTS）；README 说明这些是风格参考，不宜冒充原作者作品。像素游戏资产 忽略画师行。
另有一行 画风 LoRA：仅展示 models/loras 里已安装且 /object_info 可见的官方/社区 Krea 2 风格 LoRA（如赛璐璐日间动漫、复古动漫、艺术水彩等），选中后按 ComfyUI Krea 2 模板挂 LoRA 并追加 trigger word。
像素游戏资产（要点）¶
选 像素游戏资产 或工具参数 style: "pixel" / pixel_asset: true：
- Krea 2 pixel LoRA 先出 1024² 图；
Krea2PixelArtRefiner（需envy-ai/ComfyUI-Krea2-Pixel-Art-Refiner与opencv-python-headless）折叠到目标逻辑网格并压缩色板；- 图库中保存的精灵为 32 / 64 / 128 / 256 px 真像素，原始 1024² 不写入磁盘；
- 再经 refiner 扩回 1024² 硬块预览（
*.preview.png），图库与对话展示预览，小图仍为可下载资产。
面板可调精灵尺寸与色板数量（2–256，默认 24）。宿主会拒绝把大于请求尺寸的「像素」任务存进像素位，避免图改动后误存平滑大图。
参考图（图 + 文）¶
krea2-turbo 可走 Krea 2 edit 路径：identity（人设一致）或 style（画风参考），需安装 ComfyUI-Krea2-Ostris-Edit 及对应 LoRA。面板在 参考图 卡上传并选择模式；默认输出尺寸 跟随参考图（约 1MP），也可在尺寸下拉中覆盖。带参考图的步进在 Apple Silicon 上 README 记为明显慢于纯文生图（约 50–60 s/step）。
安装与启用¶
ComfyUI、自定义节点与 Krea 权重需按 SETUP.md 自行准备。模型与 LoRA 下载脚本示例：
./scripts/download-models.sh # 7.0 GB GGUF + 8.3 GB text encoder + VAE
./scripts/download-loras.sh # 可选风格 LoRA
安装到 DSH profile（命令以 README 为准）：
cd ~/.dsh/profiles/<profile>
# 1. install the package (verified form: pnpm add "<name>@file:<absolute path>")
pnpm add "dsh-comfyui@file:$HOME/project/dsh-comfyui"
# 2. append the row below to cordis.patch.yml
# 3. reload it (touch cordis.patch.yml, or restart the app), then refresh the page
在 cordis.patch.yml 中追加：
- insert:
- id: comfyui
name: dsh-comfyui
保存后 touch cordis.patch.yml 或重启应用，再刷新页面。
典型用法¶
面板¶
侧边栏 → ComfyUI 生图 → 输入想法，可选 优化提示词 → 选预设与尺寸 → 生成。像素预设下选精灵尺寸与色板；参考图模式下上传图并选 人设 / 风格。
对话工具示例¶
像素精灵：
image_generate({
prompt: "a wooden treasure chest",
pixel_asset: true,
asset_size: 64,
palette_colors: 24
})
画师风插画（带画师 id）：
image_generate({ prompt: "...", style: "illustration", artist: "shinkai" })
// artist: "ghibli" 等；省略 artist 为通用插画
参考图：
image_generate({
prompt: "...",
reference: "/path/to/portrait.png",
reference_mode: "identity"
})
适用场景与注意¶
适合已在本地维护 ComfyUI、希望 DSH 对话与面板共用 Krea 2 Turbo 工作流、并需要插画预设或真像素游戏资产的开发者。插件以 当前 DSH 进程权限 运行，会探测端口并可能执行 run.sh；安装前应阅读源码与 MIT 许可证，并按 SETUP.md 核对自定义节点、磁盘空间（首次任务约 15 GB 加载）及 Hugging Face 下载等已知坑（如 Apple Silicon 上 FP8、缺少 OpenCV 等）。
DSH 生态强调「一切皆插件」；skillhub.cn 上的插件目录为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-comfyui 把本地 ComfyUI 生图、Krea 2 双预设、提示词优化与图库收进 Harness 一条链路，对话与工作区路径一致。详情与 SETUP.md：GitHub — prophetcrab/dsh-comfyui；目录页：skillhub.cn/plugins/prophetcrab/dsh-comfyui。
