Edge Workers 手冊
一個部門，一個 Worker。提交 manifest 為先的 JS/TS 專案，取得確定性建置、不可變修訂版、簽章調度通道，以及受政策保護的公開 URL。這份手冊涵蓋後端實作的一切。
這份手冊怎麼讀
先把 快速開始 完整跑一次：teamsync-worker init 建立骨架 → validate → dev → submit（產生不可變的 ready 修訂版）→ deploy 並輪詢票證 → 透過閘道或公開 URL 呼叫。之後其餘內容都是查閱資料。
概念 值得在串接前先讀。最常踩雷的幾件事：驗證只收 JWT，未帶憑證回 418 而不是 401（驗證與角色）；沒有回滾 — 部署只能往前走，遇到 409 就重新讀取 Worker（版本與部署）；uncertain 不是終態 — Worker 會暫停，直到公司管理者執行修復（公司管理員）；依賴是只收一個套件、版本釘死的目錄，不是 npm（npm 依賴政策）；在雲端，Worker 程式碼的對外 fetch() 不受限制 — 沒有 Outbound Worker — 但每次呼叫預設限 500 個子請求／50 ms CPU（地端：網際網路與區域網路扣除拒絕清單、30 秒牆鐘時間預算、共用的子請求額度；架構）；新的 runtime 功能需要重新建置 — Worker 機密、逐操作存取與服務帳號，只有在以目前 builder policy 建置的修訂版部署後才會出現在 Worker 上（提交管線）；以及 存取模式在 runtime 內強制執行，靠 X-TeamSync-Worker-Key 摘要與 IP 允許清單判定（支援的修訂版會依操作判定）— 部門的第一次部署起始為 teamsync_internal，公開 URL 在管理者開放之前一律關閉（存取模式）。
自後端 5.21.0 起，這個模組還提供僅可寫入的 Worker 機密、附操作 API 金鑰的逐操作存取、讓 Worker 程式碼用來呼叫 TeamSync API 的部門服務帳號、已刪除部門之 Worker 的退役、範本與修訂版原始碼下載，以及地端 runtime。
操作流程 是任務導向的，一頁一個工作。參考資料 欄位完整：端點、schema、列舉、錯誤（含所有 builder 拒絕代碼）、CLI、manifest 規格、環境變數、資料庫模型、背景任務。平台維運 涵蓋平台佈建、地端附加元件與測試地圖。變更紀錄 釘住這份手冊稽核時的後端 SHA。
快速開始 →
模組是什麼、驗證與角色，以及完整跑一次 CLI 生命週期。
概念 →
架構、manifest 契約、建置管線、部署、存取模式、調度協定。
操作流程 →
提交、部署與輪詢、呼叫、管理政策與設定、公司修復。
參考資料 →
端點、schema、列舉、錯誤、CLI、manifest 規格、環境變數、資料庫、任務。
給 LLM / Agent 讀
與 sandbox-docs 、custom-tables-docs 同一套慣例：
/llms.txt— 索引：閱讀順序、契約摘要、每頁.md連結。/llms-full.txt— 雙語全文（先 zh-TW 再 en）。- 每一頁都有 Markdown twin，例如
/zh-TW/concepts/architecture.md。
內容來源
每一頁都對照後端釘選的 release 原始碼撰寫 — 目前釘選見變更紀錄（9d7e0c69ad，tag v5.22.1，2026-10-09）。路由位於 base /private/module/edge-workers 之下。文字與程式碼衝突時，以程式碼為準。若後端與本手冊不一致，以後端為準 — 請回報讓我們修正文件。