沙盒與 .sam
遊樂場裡的活動單位叫沙盒(程式識別 sandboxId)。一個沙盒對應一份本機工作區與畫布上的執行結果。
防護邊界在瀏覽器 origin/OPFS,不是「再包一層桌面沙盒」的敘事。跨場(換子域)不共用儲存。
沙盒裡跑的是 SAM(Single-page Application Module/單頁小程式):至少有 index.html 入口;可選 functions.js(Infrastructure)、controller.js(Controller)。詳見 SAM。
介面用語是「匯入/匯出沙盒」。檔案副檔名 .sam(內容為 ZIP,只接受 .sam)。
從舊場或另一個場搬家:
- 在來源場匯出
.sam - 在目標場(例如 play.samkuo.me)匯入
- 密鑰庫、WebAuthn、介面偏好須在新 origin重設——不會跟著
.sam自動過去(密鑰庫內容預設也不進包裹)
「重置遊樂場」會清光目前這個 origin 的本機遊樂場持久化,回到首次開啟的空場。這是介面操作,不是 Host API。