哪都通圖生影片（Antigravity）
使用本 Skill 的獨立 Python 用戶端產生候選影片。預設模型為已實測的 seedance-2.5；製作流程不依賴特定工程、其他工作樹或部署狀態。
本機配置與執行入口
- 統一憑證為
NXTPATH_API_KEY，預設從環境變數或~/.config/nxtpath/env讀取。環境變數優先，NXTPATH_ENV_FILE可指定另一份私有配置。不要讀取其他應用程式的聊天 token，不要把金鑰放入命令列、Skill、報告或任務記錄。 - 新 zsh 行程由
~/.zshenv載入本機配置；GUI 或舊行程沒有繼承環境時，用戶端仍能直接讀取上述檔案。只報告配置是否存在，不展示內容。 - 從當前載入的 Skill 目錄定位
scripts/nxtpath_video.py。優先使用~/.config/nxtpath/venv/bin/python；若不存在時，HTTPS 參考圖與影片 API 可用 Python 3.9+ 直接執行。本地圖片託管還需要scripts/requirements.txt中的 boto3。 - 在目標專案先讀適用的資源與隱私約定。任務預設放在該專案被忽略的
tmp/artwork/generations/<run-id>/<asset-id>/<attempt-id>/；無專案時用使用者選定的輸出目錄。不要覆蓋舊 attempt，不要把候選自動加入建置或正式資源。
一次製作或恢復已有任務
使用者已明確要求生成某條影片時，按該請求完成一次候選，不重複詢問泛泛確認。僅詢問路線、配置或 Skill 用法不授權付費生成。批次數量、返工次數和費用範圍沿用本次使用者約定；若未約定，先做一條，不自動擴大或重生成失敗任務。
- 透過
run_command執行doctor --check-api檢查憑證和可用模型。這是唯讀請求，不生成影片。 - 確認參考圖與動作描述（本地參考圖先用
read_file查看）。明確動作階段、鏡頭、構圖、時長、需要保持的角色與道具；未指定的小樣預設 4 秒 / 480p，不要把預設低清小樣當正式成片。原生幀率、角色一致性、首尾姿態和透明度以實際影片為準。 - 把提示詞儲存為 UTF-8 檔案，用
prepare建立不可變輸入。--reference可重複傳入本地 PNG/JPEG/WebP 或 HTTPS 圖片 URL；這些是普通引導圖，不能宣稱 API 鎖定了首尾關鍵幀。文字生成影片可不傳參考圖。 - 存在本地圖片時執行
host，將輸入快照上傳或複用在已配置的私有 R2 桶，簽發 24 小時 GET 並核對下載雜湊。此操作會把參考圖傳給託管服務及影片提供商；應在使用者請求的素材範圍內。託管失敗時不要提交影片，不自動換帳號、公開桶或服務。已有 HTTPS 參考圖無需host。 - 僅執行一次
submit。它先持久化排他提交記錄，再發出付費 POST。之後用獨立的status查詢，成功後用download取得video.mp4；各命令透過run_command獨立執行，不要把分鐘級輪詢塞進單次長 shell 呼叫，也絕不使用 shellsleep作為計時器。需要等待時使用schedule(DurationSeconds=...)設定單次計時器並結束當前回合等待喚醒，然後再次執行status，不能因超時重發生產請求。 - 跨對話恢復時使用原 job 路徑，先
inspect，再status/download。已有提交、結果不明或無任務 ID 的 attempt 均不得重複 POST；無任務 ID 時依據私有提交記錄向提供方核對。下載失敗只重試下載。401/403、額度不足或模型不可用時停止提交，報告原因，不自動換金鑰、模型或介面。
命令範例（CLIENT 指實際 Skill 中的腳本；PY 指本機 Python；JOB 為此次新建任務目錄）：
"$PY" "$CLIENT" doctor --check-api
"$PY" "$CLIENT" prepare --job "$JOB" --prompt-file "$PROMPT_FILE" --reference "$REFERENCE_IMAGE" --duration 4 --resolution 480p --ratio 1:1
"$PY" "$CLIENT" host --job "$JOB"
"$PY" "$CLIENT" submit --job "$JOB"
"$PY" "$CLIENT" status --job "$JOB"
"$PY" "$CLIENT" download --job "$JOB"
交付與邊界
以可播放的本地影片和 job 路徑交付，使用 [video.mp4](file:///absolute/path/to/video.mp4) 連結展示影片，並說明它是候選以及實際檢查過的內容。需要審看成片時，直接使用 Antigravity 的 read_file 工具讀取下載好的 video.mp4（原生支援影片多模態讀取），檢查原速、關鍵動作及首尾姿態，不要把 HTTP 成功等同於動作或美術通過。
任務記錄包含提示詞、輸入快照、精確請求、提供方任務句柄、結果和檔案雜湊，權限預設僅當前使用者可讀；這些記錄可能含臨時簽名 URL，不能整份貼進聊天或提交 Git。控制台只展示任務句柄指紋。透明去底、SVG 銜接和 App 接入屬於後續製作，按目標專案的工具與授權處理。
更換裝置、更新憑證或託管失敗時才讀 配置與故障恢復。介面依據見 提供方 Seedance Skill。