---
name: loader-land
description: Develop, publish and verify a loader.land Project using a browser or private HTTP session, the deployment API, and curl runtime tests.
---

# loader.land Site Skill

契約版本：2026-10-07.2。先讀 <https://loader.land/llms.txt> 的即時能力。
APPS_ENABLED=true；P2_ENABLED=true；PROJECT_MEMBER_AUTH_ENABLED=false。

## 選擇指引

| 任務 | 必讀 |
|---|---|
| MCP／HTTP OAuth／Chrome extension | <https://loader.land/skills/clients.md> |
| 新建／更新網站、登入、回滾 | <https://loader.land/skills/publish.md> |
| 開發／更新共用 WASI 後端 | <https://loader.land/skills/wasi.md>，以及發布指引 |
| 驗證正式 API、權限與資料 | <https://loader.land/skills/test.md> |

先完整讀取需要的指引。這份 Skill 不授予新的帳號、資料存取、寄信或部署權限；依使用者的任務授權工作。

## 標準工作流程

1. 確認目標：project 是否已啟用、原 site ID/public_url、原始內容、manifest、generation、容量，以及共用後端影響的其他網站。
2. 寫下驗收條件：真實 API 路徑、方法、所需身分、預期狀態碼、JSON 欄位與資料變更。路徑從來源與 manifest 取得，不猜測 /api/health 存在。
3. 開發與本機測試：保留既有 URL、檔案及權限。後端使用 WASI Preview 1，平台不編譯原始碼。
4. 準備版本：stage 後核對 digest、frontend/backend release、generation 與整個 project 的影響。失敗不能更換原站或降低權限繞過。
5. 發布：使用既有 API 或管理 session 的原子發布流程。stage、上傳及隔離驗證成功均不等於正式發布。
6. 驗收：讀回部署狀態，取得公開頁面版本標頭，curl 測試實際 API。共用後端更新要覆蓋其他受影響網站。
7. 留下收據：分別標明本機測試、已發布、正式驗收、測試資料清除、尚未驗證項目。

## 新版 Project 與舊模型

新版每租戶一個 workspace、一個 project，全部網站共用 50,000,000 bytes、最多一個 WASI 後端與 SQLite。保留版本與有效上傳預留仍占容量；不得自動刪除使用者資料騰空間。

已啟用 Project 使用 /v2；尚未遷移的舊帳號才適用 kind=static（10 Public 頁）、kind=app（2 Team 站）及 /v1 相容流程，kind=upstream 仍使用 /v1。不要將舊配額或發布步驟套用到 Project。

APPS_ENABLED=false：WASI 後端上傳／執行不可用，舊模型 application upload/publish 回 503、公開 app hosts 回 404。已啟用 Project 的靜態前端讀取／stage／publish 不由這個開關關閉；kind=static/upstream 舊相容能力仍在。不能繞過遷移或權限檢查。

## 身分與功能界線

管理站：https://app.loader.land；部署 API：https://api.loader.land；租戶站：https://<handle>.<slug>.loader.network。
管理 session、Bearer API key、站點 runtime session 分開使用；部署金鑰不代表登入訪客或 owner。cookie 僅交給原 host。

P2 visitor identity/application storage — enabled=true。storage.read、storage.write、identity.read 宣告後仍須 owner 明確授權；files.read/files.write 另依新版 host 協定。寫入需要相符 Origin，帶站點 session 時另需 X-Loader-CSRF。

PROJECT_MEMBER_AUTH_ENABLED=false 是租戶會員登入的有效平台狀態；即使啟用也必須讀取目標站 /__loader/auth/config。Creator 登入不是會員註冊。Service Worker 與其他 browser workers 目前禁止。P3 Workspace operations 尚未開放。

Go SDK 固定版本 loader.land/sdk@v0.1.0-alpha.3，提供 identity.Current 與 storage.Get/List/Batch（storage.Batch）；尚未提供新版 file helpers，勿假造函式。

## 完成條件

核對實際狀態碼及業務結果，不只看 HTTP 200。curl 不驗證畫面、手機互動或完整瀏覽器登入導向；沒有做的項目必須列明。
不把 cookie、API key、驗證碼、私人回應或完整會員資料寫入聊天、Git、公開收據或截圖。