dsh-comfyui-control

dsh plugin --profile web add dsh-comfyui-control

dsh-comfyUI-control



DeepSeek Harness（DSH）0.2 bundle：

把本地 ComfyUI 接进一个名为 绘图模式 的 Agent 预设里，完整复刻

xingxue-ux/good-comfyui-mcp 的 13 个工具，

并补齐 ComfyUI 控制面与复刻自检，共 **19 个 comfyui_* 工具**。

安装：dsh plugin add --profile <profile> dsh-comfyui-control（见[安装](#安装)）。

只在「绘图模式」预设里生效：标准模式、极简模式、PTC 模式、创造模式等其他预设都不挂载这个插件，

也就看不到任何 comfyui_* 工具。

零运行时依赖：只用 Node 内置模块 + 全局 fetch，不需要 pip、不需要常驻 Python MCP 进程。

0.2 与旧版预设机制的区别（重要）

DSH 0.1 从 $DSH_HOME/.agent-presets/<id>/ 读取用户预设；0.2 已经不再读这个目录。

0.2 的预设是 bundle patch 里的 @deepseek-ai/dsh-agent-preset 声明，必须用

plugin_manager 安装 bundle 才能出现在预设选择器里。本包就是按 0.2 机制交付的。

功能（19 个工具）

工具 · 说明 · 对应上游

comfyui_status · 依赖自检：ComfyUI / 管线模型 / 8899 对比页服务 / camofox / Civitai 凭据 / 视觉服务状态，返回 missing[] 与 on_demand[] · server_info

comfyui_setup_guide · 初始化清单（每步含操作 / 验证 / 是否必需） · setup_guide

comfyui_get_model_guide · Anima 官方用法：模型版本、采样参数、提示词规则、限制 · get_model_guide

comfyui_list_models · 列出 ComfyUI 各模型目录（loras / diffusion_models / text_encoders / vae / upscale_models …） · —

comfyui_generate · 出图：Anima 管线（默认）或 Krea2 引擎；可覆盖 steps/cfg/sampler/尺寸/seed；参考图自动生成对比页 · generate

comfyui_repro_check · 复刻自检：按上游样例元数据原样出图（1216 宽 × 30 步 / CFG 4 / euler_ancestral + 5 件套 LoRA），把结果与上游原图并排展示给你自己目视对比；不做自动评分 · run_example.py

comfyui_run_workflow · 提交任意 workflow JSON 并等待结果 · —

comfyui_history · 历史记录查询与 mcp/manual 来源标注 · —

comfyui_queue · 队列查看 / 中断 / 清空 · —

comfyui_node_info · 节点输入输出定义查询 · —

comfyui_extract_image_info · PNG 元数据解析：ComfyUI prompt/workflow、WebUI parameters、LoRA 配置 · extract_image_info

comfyui_describe_image · 识图，默认关闭（你通常已有多模态模型，直接读图）；显式 enable_vision=true 后优先用宿主视觉模型 deepseek-v4.1-flash，Ollama 为可选的本地回退（qwen3-vl:8b → llava:7b，detail 11 问模式） · describe_image

comfyui_deconfuse_image · 小番茄（Gilbert 曲线）混淆图还原，可 enc/dec 多次 · deconfuse_image

comfyui_lookup_character_tags · Danbooru 角色规范 tag（camofox 反检测浏览器，30 天缓存） · lookup_character_tags

comfyui_lookup_character_appearance · 角色外貌 tag 统计（solo 图 tag 频率） · lookup_character_appearance

comfyui_list_cached_characters · 已缓存角色列表（离线） · list_cached_characters

comfyui_search_lora · Civitai LoRA 精确版搜索（网页搜索端点 models_v9，比 API 全） · search_lora

comfyui_download_lora · Civitai 下载 + safetensors 头校验 · download_lora

comfyui_lookup_lora_hash · 本地文件 SHA256 → by-hash 反查精确来源 · lookup_lora_hash

安装

已发布到 npm：dsh-comfyui-control（dsh.bundle.patch 已声明，装进 profile 即自动成为一层 bundle）。

方式一：npm / dsh plugin add（推荐）

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

它做三件事：pnpm 把包装进 <DSH_HOME>/profiles/<profile>/node_modules/、写完 package.json 依赖、

并把 dsh-comfyui-control 追加到该 profile 的 dsh.profile.bundles。装完重启 DSH 即可。

也可以手动把包放进 profile：在 profile 目录跑 npm i dsh-comfyui-control（或 pnpm add），

再在 package.json 的 dsh.profile.bundles 里加上 "dsh-comfyui-control"。

方式二：本地目录

git clone https://github.com/xingxue-ux/dsh-comfyUI-control

对 Agent 说：

用 plugin_manager 安装 E:\AI\ComfyUI\dsh-comfyUI-control 这个 bundle（action: install_bundle）。

也可以在「设置 → 插件」里安装同一个目录。

选择预设

预设名 绘图模式（id drawing）。装完后 plugin_manager 的 list_bundles 会列出这个 bundle，

list_plugins 里会出现 preset-drawing 行。在 Agent 预设选择器里选 绘图模式，或设为默认预设后新建会话。

预设只对新会话生效；已在运行的会话保持启动时的插件版本。

环境依赖

依赖 · 必需 · 说明

ComfyUI（默认 http://127.0.0.1:8188） · ✅ · 出图与模型列表

Anima 管线模型 · ✅ · anima-base-v1.0.safetensors（models/diffusion_models/）、qwen_3_06b_base.safetensors（models/text_encoders/）、qwen_image_vae.safetensors（models/vae/）、RealESRGAN_x2plus.pth（models/upscale_models/，开 upscale 时用）

默认 5 件套 LoRA · ✅（默认挂载） · 见下节；缺了就用 comfyui_search_lora + comfyui_download_lora 拉

8899 对比页服务 · ✅ · 出图返回的 view_url 指向它。启动：npm run serve-compare（即 node tools/serve-compare.mjs，只读服务 <DSH_HOME>/storages/dsh-comfyui-control/compare/）；没启动时 comfyui_status 会把它列进必需项并从 missing[] 报告，comfyui_generate 也会在结果里带 view_warning

camofox-browser（默认 http://127.0.0.1:9377） · 可选 · npm install -g @askjo/camofox-browser && camofox-browser；不装则角色 tag / 外貌统计不可用

Civitai 凭据 · 可选 · CIVITAI_TOKEN（下载）、CIVITAI_SEARCH_KEY（搜索）；不配时 by-hash 反查仍可用

视觉服务 · 可选（默认关闭） · comfyui_describe_image 默认不发请求 —— 你通常就是多模态模型，直接读图即可。需要时传 enable_vision=true，默认走宿主视觉模型 deepseek-v4.1-flash（opencode-go），用不到 Ollama；想走本地 Ollama 则传 model=qwen3-vl:8b 并先 ollama pull qwen3-vl:8b（+ llava:7b 作为 NSFW 回退）

装好后在新会话里先调 comfyui_status，它会返回 missing[] 逐项告诉你缺什么。

默认 5 件套 LoRA（需要自己下载，插件不会自动拉）

comfyui_generate 不传 lora_text 时自动挂这 5 个；本包不包含任何模型文件，缺任何一个都会提交失败：

LoRA · 权重 · 用途

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 · 画风

补齐方式（四选一）：

1. 让 Agent 代下（推荐，需要 CIVITAI_TOKEN）：

comfyui_search_lora(filename='surtr945_v1.safetensors') → comfyui_download_lora(version_id=3023314, filename='surtr945_v1.safetensors')

→ comfyui_lookup_lora_hash 核对来源。内置 KNOWN_EXACT 表让这 5 个都能离线命中精确版。

2. 自己下：从 Civitai 下到 <COMFYUI_ROOT>/models/loras/，文件名保持一致。

3. 不用默认套：显式传 lora_text="" 空载，或传 lora_text='<lora:你的LoRA:0.7>' 覆盖。

4. 补齐后复查：comfyui_status 的 default_loras.missing 应为 []，models_ok 才会是 true。

comfyui_status 会单独检查这 5 个文件（default_loras.present/missing）：它们不在 pipeline.json 里，

是生成时动态注入的，所以不检查的话新装环境会误报 ready: true。

复刻自检

…(truncated)