SoulBrowser Docs

Appearance

分层架构 ​

主体层级 ​

SoulBrowser 的核心可以粗分成这些层：

层职责
接入层Web Console、Desktop App、CLI、HTTP API
Kernel路由、会话、任务、调度、鉴权、计费
Agent/Planning规划、重规划、任务执行控制
Browser AbstractionCDP Adapter、Local Bridge、Stealth
Browser EngineCloud Chrome / Local Chrome

与前端最相关的层 ​

前端开发最需要关心的是三层：

1. Server Router ​

负责暴露 chat / sessions / tasks 接口。

2. Session Service ​

负责 session 生命周期、task 绑定、snapshot 恢复。

3. Chat Page Runtime Controller ​

负责把 session 和 task 接口拼成右侧运行态。

为什么这层关系必须写清楚 ​

这次前端问题会拖很久，一个重要原因是：

  • 大家看到了“右侧空白”
  • 但没有先确认它属于哪一层

正确拆法应该是：

  1. Router 有没有返回数据
  2. Session 有没有绑定 task
  3. Frontend controller 有没有绑定 session
  4. 展示组件有没有吃到 props

后续文档规划 ​

后面如果继续细化，可以把这页再拆成：

  • session-task 模型
  • chat runtime 数据流
  • local/cloud 执行链差异

相关页面 ​

参考来源 ​

更详细的历史文档仍保留在：

  • docs/ARCHITECTURE.md
  • docs/ARCHITECTURE_DETAIL.md

SoulBrowser Documentation

Docs in monorepo