前端架构
OpenHuman 桌面 UI 是 Vite + React 19 应用,位于上游仓库 app/src/。它使用 Redux Toolkit 保存会话状态,通过 REST、Socket.io 和 Core JSON-RPC 与后端和 Rust Core 通信。
Provider 链路
典型顺序是 Redux、持久化门、用户上下文、Socket、AI、Skill,再进入 HashRouter 和页面路由。这个顺序保证认证、实时连接和 AI/Skill 状态在页面使用前已经初始化。
服务层
前端不应把 Core RPC URL 或后端地址写死。运行时会优先使用登录页配置、Tauri 命令返回值、开发环境变量,最后才落到默认地址。组件应通过统一服务层读取配置。
贡献建议
改 UI 时先确认状态来源和服务调用边界。重逻辑应尽量留在 Core 或服务层,页面组件负责展示和用户交互。