#用 Codex 上传本地素材

向 Codex 提供需要使用的文件路径。HolyCrab 会先在本机检查，并在开始上传前展示完整清单。

#让 Codex 上传

#1. 向 Codex 提供文件路径

请替换为自己文件的实际绝对路径，示例中的 Demo/demo 是用户名占位符。

Windows： C:\Users\Demo\Pictures\front.jpg 和 C:\Users\Demo\Videos\motion.mp4。

macOS： /Users/demo/Pictures/front.jpg 和 /Users/demo/Movies/motion.mp4。

Linux： /home/demo/Pictures/front.jpg 和 /home/demo/Videos/motion.mp4。

向 Codex 说明：“用 HolyCrab 准备上传这两个参考素材：[图片路径] 和 [视频路径]。先显示完整清单，我确认后再上传。”

#2. 核对预览

逐个检查目标、真实绝对路径、文件名、识别类型、大小和已知时长。目录、设备、FIFO、伪造类型或不支持的文件会让整批在联网前停止。

#3. 只确认一次

确认全部信息正确后，再批准整批上传；如有任何错误，请取消并让 Codex 重新准备清单。

#4. 不要再改文件

正式执行前会再次核对。预览后替换或编辑过的文件不会上传。

#5. 等待素材处理

让 Codex 等待返回的素材 ID 变为可用。该编号用于后续在生成任务中引用对应文件。

#批量上传中断后的结果

#使用终端上传（可选）

holycrab assets upload /absolute/path/front.jpg /absolute/path/motion.mp4

holycrab assets upload "C:\Users\Demo\Pictures\front.jpg" "C:\Users\Demo\Videos\motion.mp4"

holycrab assets wait ASSET_ID --timeout 600

#未成功时

• 本地检查失败时，修复或替换被指出的文件；这一批没有文件被上传。
• 线上处理失败时，先看公开错误，不自动重传。
• 结果不明确时保留素材 ID，先查询，再决定。