收尾

箱子怎麼收尾:要人試結果就 sandbox_review,沒有東西可看就 sandbox_stop,以及各自會留下什麼。

開了的箱子,在你不再動它之前都要收尾:

  • 要人試結果時用 sandbox_review:箱子立即出現在 app「待驗收」,呼叫在 client 支援的上限內等待回饋或驗收完成:未宣告時最多 25 秒,完成長等待設定後最多 30 分鐘。先讀回傳的回饋再繼續;逾時後用 reviewId 接續,或用 sandbox_report 重讀已知回饋。箱子之後停掉,最近 7 天內的截圖與錄影仍可在「全部沙盒」的已停止清單查看;箱子與 /work 不會保留。待驗收的箱子仍照一般閒置規則凍結、停掉(見箱子狀態);凍結時人打開交件會把它叫醒,已經停掉的要在新的箱子重新交件。用 open 指定人打開什麼:web 加上頁面所在的 port,或 box 交箱子的畫面。box 交件因為螢幕上什麼都沒有而失敗時,先在箱子的螢幕或裝置上啟動 App,再呼叫一次。
  • 沒有要讓人試用的程式時用 sandbox_stop。箱子會停止,截圖與錄影仍保留到各自拍攝後 7 天,可在 app 已停止清單打開;需要的 /work 檔案應先下載。

兩個都沒做就留著跑的箱子,在人的 app 裡顯示為「AI 停手了」(見下面),等人決定怎麼處理。對話也可能在走到那一步之前就結束(筆電闔上、client 被關掉),所以邊做邊在 /work 裡 commit,訊息寫清楚做完什麼、還差什麼,要緊的就 push 或用 sandbox_pull 拉回來:steps[] 記的是跑過什麼,不是檔案。MCP 伺服器的 instructions 對每個 client 也這樣說:每個 sandbox_start 都要給 goal,每個箱子都以 sandbox_review 或 sandbox_stop 收尾,接手別的對話留下的箱子之前先讀 sandbox_status。

箱子留下的東西,以及箱子停掉之後誰還看得到(細節見各自連結的段落):

什麼 何時刪除 箱子停掉之前 箱子停掉之後
截圖與錄影:每一步自動留下的,以及 sandbox_shot 正常拍攝/停止錄影後留下的(sandbox_exec、sandbox_shot) 各自拍下 7 天後 app 的「截圖與錄影」與 GET /v1/boxes/{id}/media app「全部沙盒」→「已停止(7 天內)」與 /media,直到各自到期
sandbox_get 取出的檔案,包括取回的錄影(sandbox_get) 約 1 天後自動刪除,不計保存量;網址有效 1 小時 箱子還在時可重取新網址,或用 sandbox_pull 直接下載 只能用手上仍有效的網址,不能重取
箱子凍結時的 posterUrl 與 sandbox_review 卡片圖:各只保留最新一張,舊圖會被替換(點數) 帳號刪除時;目前不能在 app 單獨刪 app 可顯示最新圖片 已停止清單及 GET /v1/boxes?all=1 可顯示最新封面圖
被自動停掉、你還沒拿回來的錄影(sandbox_shot) 跟 /work 一起 你用 sandbox_get 拿;app 與 /media 都沒有 沒了
/work 箱子停掉時 你用 sandbox_exec、sandbox_get、sandbox_pull 沒了

所有工具與主題都列在工具參考。