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 對比頁服務。安裝後選擇「繪圖模式」預設即可使用。