用途：修复 ComfyUI 工作流中缺失或损坏的模型元数据，生成 ComfyUI-RunpodDirect 可消费的 properties.models 记录。仅标注 UI 工作流 JSON，不修改 API prompt JSON，也不得编辑、替换或覆盖原始 JSON/PNG。
主要能力：从 ComfyUI 输出 PNG 中提取内嵌 UI 工作流；清点所有加载器选择（含子图）；按证据与来源顺序解析模型身份；将已确认的元数据写入新工作流。每个可恢复工作流都输出恰好一份 <workflow-stem>.repaired.json，即使解析不完整、有歧义、受限或中断。
使用方式：无工件时询问一次“Please attach the workflow JSON or the original ComfyUI output PNG.”。有工件后直接提取、清点、解析、写出修复副本并返回。命令包括：python3 -B extract_png_workflow.py（从 PNG 提取 UI 工作流）、python3 -B inventory_workflow_models.py（清点加载器选择）、python3 -B apply_model_metadata.py --allow-unresolved（写入新工作流）。仅在用法错误后查阅 --help。
适用场景：模型元数据完整时保留内容不变并写出新 JSON；仅有文件名无可信 URL 时从原始模板、ComfyUI-Manager、Hugging Face 或 Civitai 解析候选；文件名通用或多个可信匹配时不应用歧义元数据，发布部分工作流并让用户选择；受限或许可证限制时先发布部分工作流，确认访问与许可前停止下载；RunpodDirect 路由不可用时仍产出修复工作流。
限制：不编造模型、不下载歧义元数据、不覆盖原文件；API-only JSON 或剥离工作流的 PNG 无法恢复，需原始 UI 工作流或 PNG；截图与重编码图像通常丢失工作流。工作状态存于临时目录，修复 JSON 是唯一持久产物。