JMCAI Comfypet Skill

[!IMPORTANT] Dependency Requirement: This skill MUST be used with the JMCAI Comfypet Desktop Application. Download the desktop app here: https://github.com/allen-Jmc/comfypet-jmcai-Dist

先运行：

python jmcai_skill.py doctor
python jmcai_skill.py registry --agent

然后按以下顺序执行：

1. 根据 summary、tags、input_modalities、output_modalities、example_prompts 选择最合适的 workflow。
2. 只填写 alias schema 中暴露的参数。
3. 提交运行：

python jmcai_skill.py run --workflow \x3Cworkflow_id> --args '{"prompt_1":"a cinematic scene"}'

4. 读取 run_id 后，单次查询状态：

python jmcai_skill.py status --run-id \x3Crun_id>

5. 如需回看，再读取：

python jmcai_skill.py history --workflow \x3Cworkflow_id> --limit 5

Parameter Rules

• 缺少 required: true 的参数时，向用户追问或在上下文足够明确时补齐
• 只能使用 registry --agent 返回的 alias 参数名
• image | mask | video | audio | file 类型参数对本机 bridge 仍可直接传本机绝对路径
• bridge_url 指向局域网另一台桌面端时，skill 会自动把本机资产上传成 upload:\x3Cid>，不用手工改写参数
• file 类型远程自动上传只覆盖常见 workflow 资产格式，例如图片、音视频、txt/csv/pdf/srt/vtt/ass
• 不要修改 schema、workflow 或 target 配置

Privacy & Security

• Secure Upload: This skill only supports uploading workflow asset files needed by exposed schema fields (image, mask, video, audio, file).
• Access Control: Generic file uploads stay restricted to a narrow whitelist (.txt, .csv, .pdf, subtitles, and common media assets) instead of arbitrary local files.
• Local First: By default, it communicates with 127.0.0.1. If using a remote bridge, ensure you trust the endpoint.

Failure Handling

• doctor 失败：提示用户启动或升级 JMCAI 桌面应用
• run 返回错误：把错误原文反馈给用户，不要伪造成功
• status 返回 queued 或 running：告诉用户仍在生成，并在下一次独立调用中继续查询
• status 返回 success：优先返回 outputs 中已经自动下载到当前机器的本地文件路径
• status 或 history 返回 warnings：告诉用户任务已成功，但自动下载输出到当前机器时出现了网络或本地写入问题

需要 bridge 契约细节时，读取 references/bridge.md。
需要图片 / 视频 / 资产输入工作流示例时，读取 references/usage.md。