fix(chv-muse-round12): 移植 round-11 的 Page.aria_snapshot() 纠正到 CDP broker

Playwright 1.64.1 没有 page.accessibility(Puppeteer 的 API),
broker 的 snapshot 调它必走异常分支。改调 Page.aria_snapshot()
(字符串);guard 的 truncate_a11y 换成字符串版 truncate_aria
(179a86d 原样),detect_injection/detect_form_risk 加字符串
分支(dict 分支保留);两边 fake 与 P4 文档同步改。a11y-only
契约不变:不读原始 DOM、不走 JS eval。

测试:test_chv_muse_p2 + test_chv_muse_p4 114 OK;全量 2523 OK
(skipped=10)。
This commit is contained in:
host committed 2026-11-07 18:24:58 +00:00
1 parent 9da74c2a78
commit 114b444554
6 files changed
+209 -129

No files matched your search

+11 -8
View File
@@ -43,13 +43,13 @@ P2(提交 `c61484a`)已把浏览器子代理独立出来:`chv-guest/chv-br
| 项 | 现状(P2 已交付,代码为准) | Muse 目标 | 本轨做法 |
|---|---|---|---|
| 子代理看到什么 | `accessibility.snapshot()` 无障碍树(截断 200 节点/64KB)+ 标题/URL;`evaluate`/`content` 已拒 | 只见无障碍树快照,不见原始 DOM | 收紧到底:快照路径上所有回包与错误信息过 `sanitize_error`(去 HTML 标签、截断 200 字符、含尖括号即丢弃原文),任何响应字段不得含 `ws://`、DevTools 地址、原始 HTML;AST 测试钉住两个客机脚本里不存在脚本注入面 |
| 页面内 JS | socket 层拒 `evaluate` 等操作,但 Playwright 直连在 `chv-browser.py` 进程内——代码里今天没调,不等于调不了 | 不能在页面上下文运行 JS,无脚本动词 | Chromium 的所有权移到单元外 CDP broker;broker 只调白名单调用(`goto`/`title`/`url`/`accessibility.snapshot`/`screenshot`/`close` + 只读监听 `on(request/download)`);`evaluate`/`add_script_tag`/`add_init_script`/`expose_function`/`set_content`/`eval` 等一律不在代码里出现,AST 测试扫两个脚本的全部属性名 |
| 子代理看到什么 | `Page.aria_snapshot()` 的 ARIA 快照字符串(截断 200 节点行/64KB)+ 标题/URL;`evaluate`/`content` 已拒 | 只见无障碍树快照,不见原始 DOM | 收紧到底:快照路径上所有回包与错误信息过 `sanitize_error`(去 HTML 标签、截断 200 字符、含尖括号即丢弃原文),任何响应字段不得含 `ws://`、DevTools 地址、原始 HTML;AST 测试钉住两个客机脚本里不存在脚本注入面 |
| 页面内 JS | socket 层拒 `evaluate` 等操作,但 Playwright 直连在 `chv-browser.py` 进程内——代码里今天没调,不等于调不了 | 不能在页面上下文运行 JS,无脚本动词 | Chromium 的所有权移到单元外 CDP broker;broker 只调白名单调用(`goto`/`title`/`url`/`aria_snapshot`/`screenshot`/`close` + 只读监听 `on(request/download)`);`evaluate`/`add_script_tag`/`add_init_script`/`expose_function`/`set_content`/`eval` 等一律不在代码里出现,AST 测试扫两个脚本的全部属性名 |
| 浏览器进程内 exec | 无此操作 | 无浏览器进程内 exec | 同上:broker 与子代理的代码里不存在任何经浏览器执行命令的调用;`page.keyboard`/`mouse` 等交互调用也不在白名单内(本轨无点击/填表操作) |
| DevTools | 未显式开 `--remote-debugging-port`,但 Playwright 直连默认持有 CDP 端点,且 `chv-browser.py` 进程内可及 | DevTools 被禁用;CDP 由单元外 broker 管理 | launch 参数白名单(见 §2),无 `--remote-debugging-port`、无 `devtools=True`;CDP 端点(ws 地址)绝不进任何响应;Chromium 由 `chv-cdp-broker`(单元外、用户 `chv-browser`)独家启动,子代理只经 broker socket 说话 |
| CDP broker | 无(P2 是子代理直连 Playwright) | CDP 连接由单元外 broker 管理 | 新 `chv-guest/chv-cdp-broker.py`:单元外进程,Unix socket `/run/chv/cdp-broker.sock`,独家持有 Playwright/Chromium;`chv-browser.py` 改为 broker 的客户端 |
| 接管/填表暂停 | 无此语义 | 用户接管或凭证注入填表时代理被暂停、完全不能行动 | 状态机 `active/paused` 落在 CDP broker(`pause`/`resume`/`status` 操作);暂停时除 `ping`/`resume`/`status` 外一切操作拒绝;触发源:显式 `pause` 操作(供将来用户接管通道调用)、POST 表单提交被观测到时自动暂停、高风险下载命中时自动暂停;凭证注入填表联动是 P3 的 authd 注入点,本轨只留 `pause` 操作接口与接线设计 |
| 高风险表单提交 | 无(P2 的 API 里根本没有点击/填表操作) | 支付/密码类表单提交前停下等审批 | 确定性规则(不冒充模型分类器):`detect_form_risk` 扫无障碍树,密码/支付字段即标 `form_risk`;高风险表单在页时 `open` 导航即返回 `ask`(入待审批队列、执行停止);观测到 POST 请求即自动暂停 + 入队。审批队列与 P3 的 `ApprovalQueue` 同语义(见 §4) |
| 高风险表单提交 | 无(P2 的 API 里根本没有点击/填表操作) | 支付/密码类表单提交前停下等审批 | 确定性规则(不冒充模型分类器):`detect_form_risk` 扫 ARIA 快照字符串,密码/支付字段即标 `form_risk`;高风险表单在页时 `open` 导航即返回 `ask`(入待审批队列、执行停止);观测到 POST 请求即自动暂停 + 入队。审批队列与 P3 的 `ApprovalQueue` 同语义(见 §4) |
| DOM 内提示注入 | 无标注 | 外部数据进模型上下文时标注“不受信任输入” | `detect_injection` 启发式扫描快照文本(中英文注入模式,见 §2),命中即回包带 `untrusted: true` + `injection_flags`;快照本身恒带 `untrusted_input: true`(外部页面文本永远是数据、不是指令) |
| 下载文件 | 无处理 | 下载文件中的提示注入要检测/阻断 | `scan_download` 钩子:一条可测规则(可执行扩展名与双扩展名即拦:`.exe/.msi/.bat/.cmd/.ps1/.sh/.dmg/.pkg/.apk/.scr/.vbs` 及 `*.pdf.exe` 形),命中即取消下载 + 暂停 + 入队;接口留好,后续规则只加条目 |
| 恶意网站拦截 | 只有 localhost/私有地址字面量拒绝 | 恶意网站拦截(Meta 现有系统名单) | 静态名单 `chv-guest/browser-blocklist.txt`(一行一个域名/后缀),导航前检查;名单来源与更新机制见 §2;本轮只做静态名单 + 测试,不冒充实时情报 |
@@ -59,11 +59,14 @@ P2(提交 `c61484a`)已把浏览器子代理独立出来:`chv-guest/chv-br
- `chv-guest/chv_browser_guard.py`(新,纯标准库,无 Playwright):
共享纯函数,两脚本共用:`validate_url`(P2 规则:只 http/https、
拒 localhost/私有地址字面量)、`check_blocklist`(读名单文件、
后缀匹配)、`truncate_a11y`(P2 的截断逻辑原样搬入)、
后缀匹配)、`truncate_aria`(round-11 的字符串版截断,round-12
从 chv-browser.py 移植到共享 guard;旧 dict 版已废止)、
`sanitize_error`(错误信息去 HTML、截断 200 字符、凭据形
key=value 与 sk- 形 token 打码、含尖括号即丢弃原文)、
`detect_injection`(启发式模式表,中英文各 6 条,命中返回标签)、
`detect_form_risk`(无障碍树扫密码/支付字段)、`scan_download`
`detect_injection`(启发式模式表,中英文各 6 条,命中返回标签;
输入为 ARIA 快照字符串,旧 dict 树仍接受)、
`detect_form_risk`(ARIA 快照字符串扫密码/支付字段,旧 dict 树
仍接受)、`scan_download`
(一条可执行扩展名规则)、`enqueue_ask`/`list_asks`/`resolve_ask`
(文件型待审批队列,`/run/chv/ask-queue/`,一条 ask 一个 JSON 文件,
`pending/allowed/denied` 三态)、`LAUNCH_ARGS`(Chromium 启动参数
@@ -78,7 +81,7 @@ P2(提交 `c61484a`)已把浏览器子代理独立出来:`chv-guest/chv-br
自动暂停;所有回包与日志过 `sanitize_error`,绝不返回 ws 端点。
- `chv-guest/chv-browser.py`(P2 版基础上改):不再直连 Playwright,
改为 CDP broker 的客户端(每请求一连接,Unix socket JSON 行);
保留 `validate_url`/`truncate_a11y` 二次校验(纵深防御)、
保留 `validate_url`/`truncate_aria` 二次校验(纵深防御)、
`FORBIDDEN_OPS`(扩到 `click/fill/type/press/hover/select/check/
evaluate/content/devtools/js/route/expose/add_init_script/
add_script_tag/set_content/eval`)、暂停镜像状态(broker 暂停时
@@ -159,7 +162,7 @@ P2(提交 `c61484a`)已把浏览器子代理独立出来:`chv-guest/chv-br
正常启动(`--no-sandbox` 未加时仍能起);启动参数里无
`--remote-debugging-port`。
2. 经 broker `browser open https://example.com` 返回标题 Example
Domain 与无障碍树,响应里无 `ws://`、无 DevTools 地址、无 HTML。
Domain 与 ARIA 快照字符串,响应里无 `ws://`、无 DevTools 地址、无 HTML。
3. 单元内进程连不上 CDP 端点(broker 的 socket 只在单元外,单元内
无 Chromium 可连;`python3 -c "import playwright"` 在单元内仍失败)。
4. 含密码字段的测试页快照带 `form_risk: password`;此时 `open` 导航