AskaEth
f1fbc249fd
- browsercfg 接进组合根：配置读 $DATA_DIR/config/plugins/browser.json（零 env）→ 探测（本机
Chromium → 已在跑的 CDP）→ 不可用就不注册（原因码入日志）
- 自研最小出站 CDP 客户端（不 Enabled Runtime、隔离世界求值、不发 --enable-automation）+
导航 + 截图 0600 落盘 + 指纹自检；工具 browser（open/screenshot/info，owner-only）
- 3 个变异自检（启动恢复 --enable-automation/无视可用性/空闲回收失效）
- 真机对照（两站各 1 次，**如实结论**）：两侧都 pass ⇒ 「headless 被拦 / headful 通过」**未被证明**；
但测到两处硬差异：无头 UA 带 HeadlessChrome、screen 800 vs 2632；两模式 webdriver 均 false
（把 L6 的推断变成实测）。跑完 0 残留 Chrome、无对外监听端口
⚠️ 未做：MCP 自动接入（口径委派未落地）/自动注入上下文/面板页/搜索降级/docker 配方/Windows 用
pipe（Go ExtraFiles 不支持）；SSRF 落了第三份同策实现待收口；浏览器会话未挂进程关闭链
40 lines
2.6 KiB
Go
40 lines
2.6 KiB
Go
// Package browser 是 design/28（浏览器与页面截图）B2 的自研**薄层**：把「本机真
|
||
// Chromium 有头」跑起来，对它做**出站 CDP** 调用，并把页面截图按 0600 落到
|
||
// `$DATA_DIR/browser/shots/`，供既有 image/vision 管线读取。
|
||
//
|
||
// 为什么这么薄（AGENTS §9.5）：
|
||
//
|
||
// - **工具面优先复用 MCP**：`goto` / `click` / `type` / `snapshot` / `extract`
|
||
// 这一整套成熟动作由 Playwright/Puppeteer 的官方 MCP server 提供（design/28 §0
|
||
// 「Playwright MCP / Puppeteer MCP」行、§2 结论）；本包**不重造**它们。
|
||
// - **本项目独有的价值只有两处**：① 宿主真 Chromium 的**默认有头 + 持久 profile**
|
||
// 启动（design/28 §2 的过风控三件套）；② 截图 → 落盘（0600）→ 进上下文/面板的
|
||
// 闭环入口。本包只做这两处，外加够它们用的**最小 CDP 客户端**。
|
||
//
|
||
// 运行形态（design/28 §2「选型修正」的主路径）：
|
||
//
|
||
// 1. **本机真 Chromium 有头**（默认档，`browsercfg.DefaultHeadless=false`）：
|
||
// 真显示 + 真 GPU/字体/时区，指纹最像真人；
|
||
// 2. **次选：已跑的 CDP 端点**（容器 + Xvfb + 真 Chromium，配置显式给出）：
|
||
// 本包只**出站连接**它。
|
||
//
|
||
// 红线（design/28 §3/§4、AGENTS §9/§10）：
|
||
//
|
||
// - **不新开对外监听端口**：调试端口由 Chromium 自己绑在 `127.0.0.1` 的**随机**
|
||
// 端口（`--remote-debugging-port=0`，端口从 profile 目录的 `DevToolsActivePort`
|
||
// 读回），我们是**出站连接方**；容器路径同理（我们连它）。
|
||
// - **profile 含凭据**（cookie / 登录态）：目录 0700、不得位于 git 工作树内
|
||
// （`browsercfg.EnsureProfileDir`），内容绝不进上下文与长期记忆。
|
||
// - **截图可能含凭据/二维码**：文件 0600、默认不进长期记忆（design/28 §4）。
|
||
// - **CDP 层不自曝**：本包**不发** `Runtime.enable`（主流反爬用它判定「被自动化
|
||
// 控制」，见 `DevDocs/reference/browser-stealth/06`）；`Runtime.evaluate` 一律走
|
||
// `Page.createIsolatedWorld` 出来的执行上下文。
|
||
// - **失败如实报**：探测不到就不注册工具；跑不起来 / 被拦 / 超限都返回**分类原因**，
|
||
// 绝不假装成功（design/28 §6 坑 5）。
|
||
//
|
||
// 已知未做（本片如实登记，见交付报告）：
|
||
// - 面板「看一眼」入口（B4）、搜索降级档（B5）未做；
|
||
// - 除「导航 + 截图 + 页面指纹自检」之外的动作（click/type/extract/wait）**交给 MCP**，
|
||
// 本包不实现。
|
||
package browser
|