Document Lightpanda learnings and proxy notes

2026-08-13 17:00:21 +08:00
parent f4e354a9ba
commit 691f96e8a6
3 changed files with 77 additions and 0 deletions
@@ -29,3 +29,30 @@

 ---

+## [LRN-20260326-002] best_practice
+
+**Logged**: 2026-03-26T08:35:04Z
+**Priority**: high
+**Status**: pending
+**Area**: config
+
+### Summary
+使用 Lightpanda 做网页自动化时，应优先把它视为“待验证的特定站点浏览器”，而不是默认当作通用浏览器
+
+### Details
+在连接本地 9222 端口的 Lightpanda 实例后，已验证其支持基本 CDP 流程：可连接 websocket、创建 target、attach session、打开 example.com，并读取 document.title 与 document.body.innerText。同时也验证到站点兼容性非常不均匀：cn.bing.com 搜索页可正常加载并提取结果；但 Google 搜索会话会中途断开，DuckDuckGo、Wikipedia、lightpanda.io、Hacker News 等站点出现 SslConnectError，GitHub 及多站点并发探测时还出现 Connection reset by peer。由此可知，当前实例更适合单站点、串行、小范围验证，不适合直接假设为稳定的通用浏览器后端。
+
+### Suggested Action
+后续使用 Lightpanda 时，先用一小组目标站点做串行兼容性验证并记录结果；默认优先使用已验证可用的站点（如 Bing），避免一开始并发探测或直接依赖复杂站点。
+
+### Metadata
+- Source: conversation
+- Related Files: tmp/lightpanda_probe.py, tmp/lightpanda_nav.py, tmp/lightpanda_probe_site.py
+- Tags: lightpanda, cdp, browser-automation, compatibility, best-practice
+- Pattern-Key: lightpanda.validate_target_sites_before_generalizing
+- Recurrence-Count: 1
+- First-Seen: 2026-03-26
+- Last-Seen: 2026-03-26
+
+---
+