Lightpanda
用 Lightpanda 构建带兼容记录的浏览器证据实验室
设计基于样例的学习项目，记录预期输出、协议限制与可复现升级。
你将学会
- 一个样例回答一个兼容问题。
- 版本变化时保留实际输出。
- 实验、文章和线上发布需要不同完成证据。
开始前需要
- 基础 HTTP、JSON 与浏览器生命周期知识
- 具有明确预期输出的自有样例
解释本章实现边界，核验拟议任务或独立字节教学模型。
先看结论
- 一个样例回答一个兼容问题。
- 版本变化时保留实际输出。
- 实验、文章和线上发布需要不同完成证据。
把实验室组织成一组问题
一个实用学习项目可以包含少量自有样例：静态文字、延迟 DOM 文字、嵌套框架、依赖 worker 的值和编码边界。每个样例回答一个兼容问题。使用合成数据并避开账户，这样失败可以复现，不会泄露凭据或私人内容。
逐项记录传输方式、加载标志、等待条件和预期观察。实验室应区分功能未支持、超时、策略拒绝和测试预期错误，因为它们需要不同修复。只留下一个笼统失败计数，会把真正原因掩盖掉，也不利于后来解释版本差异。
把升级看作证据变化
每次运行固定源码或程序身份及客户端版本。升级改变结果时，检查对应实现分支并保留前后记录。SafeString 案例说明，即使页面看起来没有变化，小型序列化变更也可能影响客户端；协议正确性同样属于兼容性。
配图应解释失败边界，而不是重复漂亮封面。资源加载问题适合依赖图，字节转换适合决策树，上下文复用适合生命周期时序。只有真正的空间问题才需要三维交互，不应在一个 JSON 结果旁仅为了装饰加入沉重动画。
连接发布之前先定义完成标准
完成一个实验案例，需要样例、预期结果、实际保留结果和明确执行环境。完成一篇文章还需要准确解释、完整翻译、可访问配图和有效发布路由。完成一次发布则必须验证线上产物，不能只看本地生成器成功。
本章提出扩展设想，不宣称 Lightpanda 已经提供这套编辑实验室，也不是说本站已部署它。下一项有用实验是比较样例集的证据完整度，并用失败结果改善文章。未执行案例应保持可见，不能把计划中的测试转换成绿色状态。
实施步骤
- 1
建立自有静态、动态和编码样例。
- 2
记录模式、加载、等待和预期结果。
- 3
保留实际输出并分类失败原因。
- 4
内容与线上产物检查通过后再发布。
可复制示例
{"proposedLab":true,"fixtures":["静态","延迟 DOM","框架","worker","编码"],"actualBrowserRuns":0,"status":"已设计，未执行","releaseVerified":false}常见问题
实验室是已有上游功能吗？
不是。它是围绕所查浏览器提出的学习和编辑集成方案。
为什么不给每章都加 Three.js？
只有空间交互有助解释时才使用。协议和字节流程用可访问的二维图更清楚。
资料来源
- 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