DeepSeek Harness 绘图模式插件：dsh-comfyui-control

前言¶

DeepSeek Harness（DSH）0.2 引入了新的 bundle patch 机制，预设不再通过目录读取，而是通过插件声明挂载。dsh-comfyui-control 是一个适配 DSH 0.2 的插件，它将本地 ComfyUI 整合进名为「绘图模式」的 Agent 预设中。该插件复刻了上游 good-comfyui-mcp 的能力，并补齐了控制面与复刻自检功能，共计 19 个 comfyui_* 工具。

核心功能¶

插件提供了以下 19 个工具，覆盖状态检查、模型管理、图像生成、复刻自检与 LoRA 搜索下载等场景。

状态与基础控制：comfyui_status（依赖自检、检查 8899 对比页服务）、comfyui_setup_guide（初始化清单）、comfyui_run_workflow（提交任意 workflow JSON）、comfyui_history（历史记录查询）、comfyui_queue（队列查看与中断）。
模型与管线：comfyui_list_models（列出各模型目录）、comfyui_get_model_guide（Anima 官方用法说明）、comfyui_generate（Anima/Krea2 引擎出图，支持覆盖 steps/cfg/sampler/尺寸/seed，参考图自动生成对比页）。
复刻自检：comfyui_repro_check（按上游样例元数据原样出图，生成对比页供目视判断）。
图像信息解析：comfyui_extract_image_info（解析 PNG 元数据）、comfyui_describe_image（识图，默认关闭，需显式 enable_vision=true）、comfyui_deconfuse_image（小番茄混淆图还原）。
角色与 LoRA 管理：comfyui_lookup_character_tags（Danbooru 角色标签）、comfyui_lookup_character_appearance（角色外貌标签统计）、comfyui_list_cached_characters（缓存角色列表）、comfyui_search_lora（Civitai 精确搜索）、comfyui_download_lora（下载 LoRA 并校验）、comfyui_lookup_lora_hash（文件 SHA256 反查来源）。

安装与启用¶

插件已发布到 npm，需要通过 dsh plugin add 命令安装到指定的 profile。

1. 安装插件¶

执行以下命令将插件安装到目标 profile：

dsh plugin add --profile <你的 profile> dsh-comfyui-control

安装过程会自动处理依赖写入与 bundle 注册。

2. 选择预设¶

插件仅在「绘图模式」预设中生效。
安装完成后，在 Agent 预设选择器中选择 绘图模式（id drawing），或在 plugin_manager 中确认 preset-drawing 已挂载。

注意：预设只对新会话生效，已运行的会话保持启动时的插件版本。

环境依赖¶

本地 ComfyUI 及相关服务需就绪，否则 comfyui_status 会返回 missing[]。

ComfyUI：默认运行在 http://127.0.0.1:8188。
Anima 管线模型：
- anima-base-v1.0.safetensors (diffusion_models)
- qwen_3_06b_base.safetensors (text_encoders)
- qwen_image_vae.safetensors (vae)
- RealESRGAN_x2plus.pth (upscale_models)
默认 5 件套 LoRA：插件不包含模型文件，需手动下载到 <COMFYUI_ROOT>/models/loras/，缺一不可：
- ushikani_kassen_lora-000013.safetensors (0.3)
- anima-darklight-style-v1-000194.safetensors (0.3)
- anima-base-1-photo-background-v4.safetensors (0.6)
- RealSkin SliderV2.safetensors (0.8)
- surtr945_v1.safetensors (0.8)
8899 对比页服务：出图返回的 view_url 指向该服务。需运行 npm run serve-compare 启动。
可选组件：camofox-browser（角色标签）、CIVITAI_TOKEN（下载 LoRA）、视觉服务（comfyui_describe_image 默认关闭，需 enable_vision=true）。

典型用法¶

1. 检查环境状态¶

首次使用或环境变更后，先调用状态检查：

comfyui_status

它会返回 missing[] 列表，告知缺什么（如模型、LoRA 或 8899 服务）。

2. 复刻自检¶

验证本地环境是否与上游参考一致：

comfyui_repro_check
comfyui_repro_check(allow_download=true)
comfyui_repro_check(sample='repro_sofa_rose')

3. 生成图像¶

调用 comfyui_generate 时，可覆盖默认参数：

comfyui_generate
comfyui_generate(steps=50, cfg=7.0, width=1024, height=1024, seed=12345)

注意事项¶

运行时依赖：插件零运行时依赖，仅使用 Node 内置模块与全局 fetch，不需要 pip 或常驻 Python 进程。
视觉服务：comfyui_describe_image 默认关闭。如需使用，需显式传递 enable_vision=true。默认使用宿主视觉模型 deepseek-v4.1-flash。
文件归属：插件不包含任何模型文件，所有模型文件需自行准备或通过 Agent 下载。

总结¶

dsh-comfyui-control 是连接 DSH Agent 与本地 ComfyUI 的桥梁，通过 19 个工具实现了从环境检查到图像生成的全流程自动化。它要求本地环境具备完整的 Anima 管线模型与 5 件套 LoRA，并需启动 8899 对比页服务。安装后选择「绘图模式」预设即可使用。