系统概览

本页是整站的架构入口，不试图替代所有专题文档，而是先给出稳定的系统地图。

仓库主要模块

• crates/ Rust 后端与内核能力
• web-console/ 旧 React 控制台
• web-console-dx/ 新 Dioxus 控制台
• docs/ 历史设计文档、审计记录、专题说明
• docs-site/ 新的统一文档站

高层结构

可以先把系统理解成五层：

1. 用户入口层
2. 内核与服务层
3. Agent / Tool / Perception 能力层
4. 浏览器运行层
5. 运行态输出与观测层

对应关系大致是：

Web / Desktop / CLI
  -> soulbrowser-kernel
  -> agent-core / tools / perception
  -> cdp-adapter / local-bridge / Chrome
  -> session snapshot / task status / observations / timeline

聊天任务主链路

1. 用户在聊天页发送 prompt
2. 前端请求 POST /api/chat
3. 后端创建或复用 session，并触发 task
4. 前端从 session 和 task 接口恢复运行态
5. 右侧展示实时画面和步骤进度

这条链路里最容易出问题的层

• 前后端返回字段不一致
• 前端状态源重复
• Auto/默认态的业务语义不清晰
• 页面绑定的是旧 session 而不是当前 session

继续往下看什么

如果你需要：

• 看运行时对象关系：去 运行时模型
• 看 crate 和层级边界：去 分层架构
• 看未来拆分方向：去 微服务设计
• 看 Agent 如何规划与重规划：去 Agent 与规划
• 看动作原语、定位和校验：去 浏览器工具系统
• 看结构、视觉和语义输入：去 感知系统
• 看时间线、证据与事件事实源：去 事件存储
• 看横切式安全控制：去 策略与权限
• 看前端为什么会空白或错绑：去 前端运行态排障

文档站的职责

这个 docs 站不替代全部设计文档，只负责：

• 给开发者提供稳定入口
• 把高频知识整理成可导航内容
• 把常见问题沉淀为可检索文档