Lightpanda
Lightpanda 架构：连接级浏览器状态与协议域
追踪浏览器、会话、页面和目标的生命周期，区分可选观察能力与完整 Web 平台兼容。
你将学会
- 明确 Browser、Session 与目标的所有权。
- 单连接不提供无限的同时活动上下文。
- 观察格式和加载策略彼此独立。
开始前需要
- 基础 HTTP、JSON 与浏览器生命周期知识
- 具有明确预期输出的自有样例
解释本章实现边界，核验拟议任务或独立字节教学模型。
先看结论
- 明确 Browser、Session 与目标的所有权。
- 单连接不提供无限的同时活动上下文。
- 观察格式和加载策略彼此独立。
按所有权追踪，而不只看熟悉的 API 名称
Browser.zig 持有 JavaScript 环境、HTTP 客户端、可选会话以及页面相关分配池。注释描述一个 Browser 实例拥有一个会话，还保存权限、选择器缓存、视口覆盖与延迟创建的截图渲染器。理解这些所有者，才能解释哪些状态跨导航保留、哪些需要在销毁时释放。
帧 ID 生成器属于 Browser 而不是 Session，使同一 CDP 连接新建上下文时不会立即复用目标标识。递增使用回绕算术。这个作用域选择解决跨会话生命周期里的标识复用问题，并不是密码学身份，也不能当成授权令牌。
Target 域实施具体限制
createBrowserContext 遇到已存在的上下文时返回错误，不会在该连接上再建立一个同时活动的上下文。createTarget 在目标已经加载时同样拒绝，getBrowserContexts 返回当前上下文或空列表。对客户端池设计而言，这些分支比方法名称类似 Chrome 协议更重要。
部分上下文选项只产生未实现警告，而代理设置会修改浏览器 HTTP 客户端。不能把成功响应理解为每个传入选项都已生效。应测试隔离和清理设计真正依赖的选项，并在并发负载中明确连接由哪个任务持有。
观察形式与资源加载是独立控制
LP 域实现 Markdown 和语义树输出，后者可设置裁剪、仅交互内容和最大深度等参数。图片、子框架、worker 和外部样式表则由独立的资源设置控制。改变观察输出格式，本身不能证明任务所需的全部资源已经加载。
基础 LoadResources 结构把这四项默认设为 false，但具体模式的代码可能调整行为。实验应报告实际模式和有效设置，不要把一个默认值套到所有调用方式。本章配图是编辑绘制的所有权图，不是实测线程拓扑，也不是完整浏览器隔离证明。
实施步骤
- 1
画出一个 CDP 连接的所有权结构。
- 2
加入并发前先测试上下文创建和释放。
- 3
记录有效资源加载与观察选项。
可复制示例
CDP 连接
Browser：JS 环境、HTTP 客户端、帧 ID
当前会话与上下文
当前页面目标
LP 观察输出与资源加载使用不同设置。常见问题
一个连接能创建无限个同时活动上下文吗？
不能。所查 Target 处理器明确拒绝第二个活动浏览器上下文。
Markdown 输出代表资源全部加载了吗？
不代表。输出形式与资源策略分开，需要核对所选模式的有效设置。
资料来源
- README.md来源核查 2026-09-08
- LICENSE来源核查 2026-09-08
- Dockerfile来源核查 2026-09-08
- build.zig.zon来源核查 2026-09-08
- src/Config.zig来源核查 2026-09-08
- src/browser/Browser.zig来源核查 2026-09-08
- src/server/cdp/domains/target.zig来源核查 2026-09-08
- src/server/cdp/domains/page.zig来源核查 2026-09-08
- src/server/cdp/domains/lp.zig来源核查 2026-09-08
- src/server/cdp/SafeString.zig来源核查 2026-09-08
- src/network/RobotsGate.zig来源核查 2026-09-08
- src/telemetry/telemetry.zig来源核查 2026-09-08