DesktopRuntime 是唯一的權威狀態所有者；桌面工作台、無頭服務端、行動端、TUI 和遠端傳輸都通過共享契約訪問它。
架構邊界
瞭解 crate 劃分、權威執行階段、客戶端和 Relay 的職責。
本地設定
準備 Rust、Node、pnpm 和圖形構建環境。
構建與測試
執行日常檢查、smoke test 和釋出構建門禁。
平台支援
各平台的產物格式、構建方式和驗證要求。
Remote v2 與 Relay
配對、握手、同步和自託管傳輸的協議邊界。
貢獻程式碼
提交變更時的架構、測試和隱私要求。
開發時必須保持的約束
DesktopRuntime負責 Agent、會話、時間線、檔案、Git、PTY、供應商、權限和持久化。- 同一個核心有兩種前端：
apps/desktop加 GPUI 視窗，apps/server加守護程序生命週期。新增能力要同時適用於兩者。 - 客戶端只消費共享的遠端投影併發送型別化操作，不復制業務狀態。
- 新能力應經
BackendFacade觸達權威端，而不是隻走本地執行階段路徑。 - Remote v2 的 DTO、錯誤、能力和序列號契約位於共享
crates/core層。 - Relay 只轉發加密幀，不擁有業務授權、檔案或會話資料庫。
- 跨層行為變更必須補充確定性檢查或證據，並執行與風險匹配的最小測試集。
推薦閱讀順序
倉庫內的設計文件
公開文件站只覆蓋使用者需要的內容。更細的設計與運維資料在倉庫docs/ 下：