SuperAPI AI 工具集

panel-node-pack-sync

智能体与模型

查看项目

更新于 10-15 19:57

技能介绍

用途:编排器 comfyui-mcp(npm 包)与侧边栏面板 comfyui-agent-panel(Comfy Registry、仓库 comfyui-mcp-panel)分开发布,更新一个不会更新另一个;旧面板配新编排器会出现桥接命令未实现等难以诊断的故障。本技能用于检测并处理这种版本漂移。

主要能力:先用 install_comfyui(action:'panel', panel_action:'status') 读取 installedVersion、sync.requiredPanelVersion、sync.decision、sync.summary、pin、shadows、isDevSymlink;不要自行比版本,sync.decision 已考虑固定、遮蔽副本、开发符号链接、远程/云模式与不可读版本。decision 为 sync 时执行 install_comfyui(action:'panel', panel_action:'sync');为 pinned-warn 时只警告不同步;为 blocked 时先解决遮蔽副本或不可读固定文件;unknown、dev-install、not-applicable 分别报告、让用户自行 git pull、说明面板由 ComfyUI 主机管理。

结果判定:synced:true 时报告从磁盘重读的 verifiedVersion,并说明必须重启 ComfyUI(restartRequired:true,不会自动重启);stillBehind 为 false/true/null 分别表示已达标、仍未闭合差距、无法比较。synced:false 是正常结果;工具报错即同步失败,需转述错误。

固定与环境限制:用户固定面板时不得覆盖,须明确同意后才能 unpin 再 sync;pin.source 为 env 时无法通过 unpin 清除,需用户自行在环境或 ~/.comfyui-mcp/.env 中取消并重启编排器。面板是普通自定义节点包,pin 生效时 install_custom_node、id=all、update_all 等批量操作也会拒绝;fix、panel_install_node、panel_update_node 一律拒绝面板目标,应改用 install_comfyui(action:'panel')。遮蔽副本需移出 custom_nodes 并硬刷新;开发符号链接不可改动;同步落地后始终需要重启。