xworkmate-app/docs/architecture/README.md

架构文档

核心架构

• 分层架构总览
• 核心模块清单（2026-04-13）
• 统一路由架构

桥接与运行时

• Bridge 迁移方案
• Bridge 运行时路由映射
• Bridge 云共存优先级

会话与任务

• 任务控制面统一主线
• 任务线程 Session Key 隔离（2026-03-29）
• Task Dialog Provider 选择主线
• TaskThread 跨仓库主流程与状态图

设置与配置

• Account Sync / Settings / Bridge 状态模型
• Settings Integration 配置模型
• 安全本地持久化架构

工程实践

• No-part 文件组织 ADR
• Simple Theme 默认值记录

Public API 文档

• Public API 阅读指南
• App Orchestration
• Models & Config
• Runtime Contracts
• Feature Surfaces
• FFI & Rust
• Symbol Inventory（自动生成）

归档

已过时的文档移至 archive/。

已归档的文档：

• Cloud Session Service 多设备架构（2026-03-30） — 未实现的目标架构
• Stage4 Helper 归属映射（2026-03-28） — 一次性调研快照
• Assistant Thread Working Directory Flow — workspaceRef/workspaceRefKind/cwd 旧版流转

---

维护约定：与当前主线不匹配的文档应及时更新或移至 archive。新增架构文档应在此 README 中注册。