comfyui-runner 是一款专为 ComfyUI（流行的节点式 AI 绘画工具）设计的本地实例管理技能，通过简洁的 JSON 指令实现对服务器的精准控制。该技能以 Node.js CLI 形式运行，允许用户通过统一的接口完成服务器的启动、停止及健康状态检查，特别适用于需要将 ComfyUI 集成到自动化工作流或进行远程状态监控的场景。
核心用法
用户通过发送包含 action 字段的 JSON 指令与技能交互，支持三种操作模式：run（启动服务）、stop（停止服务）和 status（健康检查）。配置灵活性是该技能的一大特色，ComfyUI 服务器的主机地址、端口号及基础认证信息均通过环境变量或 .env 文件动态注入，无需修改代码即可适配不同的网络环境和安全策略。技能内部使用标准的 HTTP 协议与 ComfyUI 的 /health 端点通信，利用 Node.js 原生的 fetch() API 实现轻量化的状态探测。
显著优点
从安全架构角度看，该技能展现出极高的代码质量。首先，代码层面完全摒弃了 eval()、exec() 或系统级子进程调用等高危操作，仅依赖 Node.js 内置模块和标准网络请求，彻底杜绝了代码注入风险。其次，输入参数经过严格的 JSON 解析和类型校验，配合完善的错误处理机制，确保异常情况下不会泄露敏感系统路径或配置信息。此外，权限申请遵循最小化原则，仅申请必要的网络访问权限，且敏感凭证（如用户名密码）严格通过环境变量管理，避免了硬编码带来的安全隐患。
潜在缺点与局限性
尽管代码安全，但该技能仍存在若干使用限制。来源可信度方面，项目托管于个人 GitHub 账号（T3 级别），缺乏知名组织或企业的背书，长期维护的稳定性存在一定不确定性。功能实现上，当前版本仅支持 HTTP 协议通信，缺乏 HTTPS 加密支持，在公网或不信任网络环境中传输认证信息时存在被截获的风险。此外，在容器化部署环境中，run 和 stop 操作被主动限制，仅能执行 status 检查，这限制了其在云原生场景下的完整管理能力。
适合的目标群体
该技能最适合以下用户群体：本地部署 ComfyUI 进行 AI 绘画创作的开发者、需要构建自动化工作流以监控 ComfyUI 服务状态的技术团队，以及希望通过脚本批量管理多个 ComfyUI 实例的系统管理员。对于追求代码安全、依赖简洁的极简主义者而言，该技能零外部依赖的特性尤其具有吸引力。
使用风险
常规风险主要集中在网络配置和协议安全层面。用户需自行确保 ComfyUI 服务器所在网络环境的可信性，特别是在使用基础认证时，HTTP 明文传输可能导致凭证泄露。建议仅在受控的局域网或 VPN 环境中使用该技能。此外，虽然代码本身无恶意行为，但用户应妥善保管 .env 配置文件，防止敏感信息被未授权访问。性能方面，该技能仅执行轻量级的健康检查，对系统资源占用极低，但频繁的状态轮询可能对 ComfyUI 服务器造成轻微负载。