执行模式

SoulBrowser 目前支持三种执行模式。

模式概览

模式	浏览器位置	是否可见	适用场景
Cloud	服务器	否	生产环境、后台任务、批量自动化
Local	用户桌面	是	本地调试、人工接管、交互式任务
Hybrid	优先本地，失败回退云端	视情况	灵活部署、开发过渡场景

开发时怎么选

本地联调

优先使用 Local：

• 最容易看见浏览器实际状态
• 最容易确认截图、页面、步骤是否一致
• 适合调试右侧实时预览和操作链路

服务端验证

使用 Cloud：

• 更贴近 serve 的默认部署语义
• 更适合验证无头执行和任务稳定性

这类问题为什么常和执行模式混在一起

前端运行态问题经常会被误判成执行模式问题，因为它们都会表现成：

• 没截图
• 没步骤
• 会话状态异常

但排查顺序不应该先怀疑模式切换，而应该先确认：

1. 当前页面绑定到哪个 session
2. 当前 session 是否关联到正确 task
3. session snapshot 是否已经有 last_frame 和 overlays

如果这些都正常，再看执行模式。

参考来源

旧版详解文档仍保留在仓库：

• docs/EXECUTION_MODES.md