使用指南
浏览器模式与兼容性
浏览器模式与兼容性.
Chromium 与 Moli
| 需求 | 选择 |
|---|---|
| 完整浏览器流程、持久化 Context、扩展 | Chromium（normal） |
| 轻量正文提取与 Agent 任务 | 使用真实目标页面评估 Moli（light） |
| 持久化回放 | Chromium；Moli 始终关闭 |
| 控制台的存储下载、Context 操作 | 使用 Chromium 流程 |
Moli 是产品名，SDK/API 参数仍为 light。这不表示它实现了所有 Chromium CDP 方法。DevTools 可能调用不支持的命令，而基础导航仍正常。如果任务依赖截图、复杂布局、扩展或特定 CDP domain，应先验证所选引擎。
连接模型
创建会话并等待 active，再使用 connectUrl（Python 为 connect_url）。Playwright 使用 chromium.connectOverCDP；Puppeteer 使用 puppeteer.connect。这些示例针对 Chromium，不启动本地浏览器，也不表示所有框架功能都支持 Moli。
这里记录的远端接口是 CDP，不能替换为 WebDriver 或 WebDriver BiDi 地址。Lightpanda 的本地二进制、PandaScript、性能基准和 HTTP/MCP 接口不是 Lexmount API 合约。正文提取使用 Web Fetch，终端或 Agent 操作使用 Browser CLI。
排查兼容性
用一个页面和一个具体操作复现，记录 SDK 版本、引擎、会话 ID 和失败方法，不包含凭据。在 Chromium 上重复同一操作，区分引擎兼容性、认证、网络和目标站点问题。参见故障排查。