#用 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，先查詢，再決定。