sandbox_media

依時間列出帳號所有箱子（停掉的也算）每一步留下的截圖與錄影，舊的在前，每張附下載網址。只讀，不會喚醒箱子。

用來整理一段期間做了什麼、驗了什麼，不用知道是哪些箱子做的，例如替上週的更新寫發布說明或週報。它涵蓋帳號的每一個箱子，隊友的、停掉的都算，也不受 sandbox_list 只列 100 個箱子的限制。

sandbox_media { "since": "2026-09-28T00:00:00+08:00", "until": "2026-10-05T00:00:00+08:00" }
sandbox_media { "since": "2026-09-28T00:00:00+08:00", "query": "checkout", "limit": 50 }
sandbox_media { "since": "2026-09-28T00:00:00+08:00", "until": "2026-10-05T00:00:00+08:00", "cursor": "<nextCursor>" }

• since、until 是帶時區的 RFC3339 時間；since ≤ 步驟的 at < until 的才列。沒給 since 就從 30 天前（留著的最舊截圖；錄影只往回 7 天）開始，沒給 until 就到現在。一段期間有幾步都撈得完，沒有總數上限，一頁一頁翻就好。不是 RFC3339 的時間會回錯誤並講明。
• query 只留箱子的 name 或 goal、或步驟自己的 note 或 summary 含有這段文字的步驟，不分大小寫。它把整段文字當一個詞比對，不是用「或」連起來的多個詞，也不會看圖片裡的內容。你給箱子取的名字與 goal、給 sandbox_exec 的 note，就是之後找得到一段期間的依據。
• 一頁最多 limit 步，預設 20、最多 50。還有下一頁時，把 nextCursor 當 cursor 傳回來，since、until、query 照舊（limit 可以換）；最後一頁沒有 nextCursor。cursor 不會過期。
• 每一步有 at（記下這一步的時間，UTC；命令是結束的時間）、boxId、箱子的 boxName 與 goal、步驟的 kind（命令是 exec，sandbox_shot 是 shot）、summary（命令，或拍了什麼）、note，以及 media[]：kind（image 或 video）、bytes、影片的 durationSec，與 url：下載網址，至少一小時有效，過期再呼叫一次拿新的。
• 截圖拍下後留 30 天。錄影留 7 天：過了之後有截圖的步驟只剩截圖，只有錄影的步驟（sandbox_shot 錄的）整步消失。所以每週一整理上週的工作拿得到整週的截圖，但最前面一兩天的錄影可能已經沒了。
• 只列留下畫面的步驟：命令只有在執行時箱子畫面有變才會留下畫面，用 urls 的 sandbox_shot 只記一步、沒有圖（sandbox_shot）。帶 clearActivity: true 的 sandbox_review 藏起來的步驟照樣列：它們只是離開箱子的時間軸，沒有離開帳號。被刪掉的畫面才不列：DELETE /v1/boxes/{id}/media 或 DELETE /v1/boxes/{id}/events（連藏起來的步驟一起刪）。
• 只列這個帳號的箱子：帳號裡任何一把 key、任何隊友開的都算，別的帳號的不會出現。呼叫它不會喚醒、使用或接手任何箱子，呼叫本身也不扣點；留著的畫面在刪掉之前照樣算儲存量（點數）。
• 只有 MCP 工具：REST 只有下面那個單一箱子的清單，沒有跨箱子的呼叫。
• 只要一個箱子的畫面（app 顯示的就是這份）：GET /v1/boxes/{id}/media（REST）。哪些步驟會留下畫面：見 sandbox_exec 與 sandbox_shot。

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