DesktopRuntime 是唯一的权威状态所有者；桌面工作台、无头服务端、移动端和远程传输都通过共享契约访问它。
架构边界
了解 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/ 下：