前言¶
在本地或局域网里跑 ComfyUI，常见做法是自己在 Agent 里拼 HTTP 请求、维护节点图，或把 workflow 再导出一份给脚本读。若你已经在 JMCAI Comfypet 桌面应用里配好了 workflow 和对外暴露的参数，更希望对话里直接「选 workflow → 填参数 → 等结果」，而不是重复造桥接层，JMCAI Comfypet（SkillHub 坐标 @user_8dd3bc37/comfypet-jmcai-skill）就是面向这条路径的 Agent Skill。它通过桌面端自带的 Workflow Bridge 查询、提交与轮询任务，而不是替你改图或直连原生 ComfyUI API。
这是什么¶
JMCAI Comfypet 是 SkillHub 社区技能（design-media 分类，当前版本 1.2.5，发布者 user_8dd3bc37）。一句话定位：在 Agent 侧调用 JMCAI Comfypet 桌面应用中已经配置好的 ComfyUI workflow。技能包内提供 jmcai_skill.py 命令行入口；Agent 按 SKILL.md 指引执行检查、选 workflow、提交运行并查询状态。标签标明 requires_api_key=false，不依赖云端 API Key，但必须本机（或你信任的 bridge 地址）运行 JMCAI 桌面端。桌面应用分发地址见技能元数据：comfypet-jmcai-Dist。
核心功能¶
以下能力均来自官方 SKILL.md 与参考文档，可与已安装包核对：
- 健康检查：
python jmcai_skill.py doctor，确认能否连上桌面端 Workflow Bridge。 - 列出面向 Agent 的 workflow：
python jmcai_skill.py registry --agent，可读summary、tags、input_modalities、output_modalities、example_prompts等，用于选型。 - 按 alias schema 提交运行：只使用 registry 返回的暴露参数名；
run后得到run_id。 - 轮询与结果：
status查询单次状态；成功时优先返回已下载到当前机器的本地输出路径；history可回看近期记录。 - 多模态输入：
image、mask、video、audio、file等类型在本机 bridge 下可传绝对路径；远程bridge_url时由 skill 自动上传为upload:<id>（file类型有格式白名单）。 - 明确不做的事：不适用于导入 workflow、修改 schema、修改 target 绑定，或直连原生 ComfyUI 接口。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 官方说明执行完整安装脚本（见 skillhub.md）。
安装本技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。Cursor 常用路径为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/（其他客户端路径以 skillhub.md 为准）。
skillhub install comfypet-jmcai-skill --namespace user_8dd3bc37 --dir ~/.cursor/skills/
也可让 Agent 按 SkillHub 页面提示，参照 skillhub.md 安装 @user_8dd3bc37/comfypet-jmcai-skill。安装后按所用客户端要求重启或刷新技能列表。
配置 bridge¶
在技能目录内复制并编辑 config.json（示例见包内 config.example.json）。默认与本机桌面端通信：
{
"bridge_url": "http://localhost:32100",
"request_timeout_ms": 15000,
"upload_timeout_ms": 60000,
"download_timeout_ms": 120000,
"network_retry_count": 1,
"retry_backoff_ms": 1500,
"min_bridge_version": "1.2.0"
}
运行环境需具备 python、python3 或 py 之一（技能元数据中的 requires 要求）。
典型用法¶
下面介绍一条可复现的主流程：先确认桌面端与 bridge，再选 workflow、提交并查结果。
1. 检查与注册表
python jmcai_skill.py doctor
python jmcai_skill.py registry --agent
根据 registry 中的 modalities 与示例提示词选定 workflow_id，且只填 schema 里暴露的 alias 参数。
2. 提交运行（文生图示例）
python jmcai_skill.py run --workflow <workflow_id> --args '{"prompt_1":"a cinematic scene"}'
带图片输入时（本机路径示例，见 references/usage.md）：
python jmcai_skill.py run --workflow demo-image --args '{"prompt_1":"a clean product photo","image_6":"/absolute/path/to/input.png"}'
3. 查询状态
python jmcai_skill.py status --run-id <run_id>
若状态为 queued 或 running，应在后续独立调用中继续查询，勿伪造已完成。成功时优先向用户展示 outputs 中的本地文件路径。
4. 可选：历史记录
python jmcai_skill.py history --workflow <workflow_id> --limit 5
Bridge 契约与更多图片/视频/资产示例见包内 references/bridge.md、references/usage.md。
适用场景与注意¶
适合谁
- 已在 JMCAI Comfypet 桌面端维护 ComfyUI workflow，并希望 Cursor、Claude Code 等 Agent 用自然语言触发生成图片、视频，或带遮罩、音视频、文件输入的任务。
- 接受「参数与 workflow 边界由桌面端暴露」，不在 Agent 里改图或改绑定。
限制与常见问题
- 硬依赖桌面端：
doctor失败时应提示用户启动或升级 JMCAI 应用；Cannot reach Workflow Bridge时优先检查桌面端是否运行、bridge_url是否正确。 - 无可用 workflow：报错如
No enabled workflows are currently exposed by Workflow Bridge.表示桌面端当前未公开 workflow。 - 安全与隐私：默认连
127.0.0.1；远程 bridge 需信任对端。通用file上传仅限常见媒体、字幕与部分文档后缀，任意本地文件不在支持范围。 - 错误处理：
run失败应把错误原文反馈用户；warnings表示任务成功但自动下载输出时可能有网络或写入问题。
SkillHub 页面显示本技能评分 100000，下载 725 次，安装 26 次（统计以页面为准，会随时间变化）。
结尾¶
经过上面的步骤，可以把 Agent 对话接到你已配好的 ComfyUI workflow 上：查询、填参、运行、轮询，而不必在 Agent 里维护一套平行接口。官方 Skill 页：JMCAI Comfypet on SkillHub；API 入口：https://api.skillhub.cn/user_8dd3bc37/comfypet-jmcai-skill。
