# 原生后端增量测试与验证报告 2026-11-05 · v0.1.1 · 基线 `cfbrowser-202611051438.zip`。 ## 本次实际结果 执行环境:Ubuntu 24.04 amd64,Go 1.25.0。应用与 worker 使用 CGO_ENABLED=0 构建;仅 race 测试运行时启用 cgo。vendored 依赖支持离线单元测试。 | 检查 | 实际结果 | | --- | --- | | 完整 Go 单元测试,CGO=0、GOPROXY=off/GOSUMDB=off | 通过 | | 完整 race 测试 | 通过 | | Linux go vet | 通过 | | Windows amd64/macOS arm64 原生相关包 go vet | 通过,仅静态检查 | | 六目标应用/worker 构建 | 通过,仅编译 | | Nativehost、Native 客户端、integration 测试二进制 | Windows amd64/arm64、macOS amd64/arm64 共 12 项编译通过;未运行 | | 五组真实 CDP 集成流程 | 通过,包含新增隔离世界测试 | | 已插桩 CDP demo、CLI 长度前缀管道 demo | 通过 | | Python 覆盖率合并与 macOS bundle 元数据测试 | 两项均通过 | | Windows WebView2 实际运行 | 未执行,当前没有 Windows 宿主 | | macOS WKWebView / block ABI 实际运行 | 未执行,当前没有 macOS 宿主 | | 本次 Linux GTK/WebKitGTK 实际运行 | 未重跑,当前环境缺少 WebKitGTK 运行库 | | ClusterFlow 签名安装包 / UI 生命周期 | 未执行,已更新宿主接入文档 | 六目标为 linux/amd64、linux/arm64、windows/amd64、windows/arm64、darwin/amd64、darwin/arm64。Windows/macOS worker 现已包含实际原生 API,而非 unsupported 入口;交叉编译不能证明原生 ABI 或 WebView runtime 能正常运行。 CDP 回归采用原型相同的 Chrome Headless Shell 131.0.6778.204 测试引擎,只访问确定性的本地 HTTP 测试站。隔离容器显式使用 NoSandbox;未验证生产环境沙箱开启的运行。工具链与浏览器二进制不作为交付物。 本次日志以 `test-results/native-update-` 开头;原有日志与 manifest 已原样移到 `test-results/baseline-v0.1.0/`,只代表历史版本证据。 ## 覆盖率与适用范围 - 公共 `internal/nativehost` dispatcher、运行循环、CDP 调用编排:Linux 单元测试 **100.0% Go 语句覆盖率**。 - Native RPC 客户端:单元测试 **84.1%**。 - 当前 Linux 构建选中的全模块代码:单元测试 **68.3%**;合并本次单元、CDP 集成与已插桩 CLI 后为 **76.3%**。 - Windows/macOS 平台文件被 Linux build tag 排除,本次**没有它们的运行覆盖率数据**;公共层 100% 不包含两个平台适配器。 - 排除 vendor;未执行的示例与 Linux worker 计入未覆盖语句。Go 包装层覆盖率不等于 JavaScript 分支覆盖率。 此前的 82.42% 包含 GTK worker 实际执行,且源码版本不同;只保留为历史结果,不能沿用为本次覆盖率。Windows/macOS 运行后才能生成对应平台数据。 `native-update-coverage.txt` 保存本次合并函数结果;原始 `.cover` 在本地生成并被 Git 忽略,需要时按命令重现,禁止跨源码布局合并 profile。 ## 新增测试内容 公共层覆盖配置校验/失败重试/重复配置、未知方法、页面查找/配额、历史导航、NUL 拒绝、JSON/脚本限额、原生错误、重复完成回调保护、排队取消、取消创建后的页面清理、关闭页面/worker 时求值结束与迟到回调、RPC 取消后仍保留原生求值配额、长度前缀 RPC/EOF 和 pump 故障。 WebView2 求值编排测试检查主 frame、隔离世界参数、context ID、return-by-value、各阶段原生错误、无效 JSON、缺少结果与 JS 异常。Windows 专有测试实际调用 COM trampoline,检查 UTF-16、HRESULT 和 Win32 布局。macOS 专有测试实际 copy/invoke/release 原生 block,检查回调所有权与在途限额;本次只编译了这两组平台测试。 新增真实引擎测试检查网页全局不可见、隔离全局连续调用保留、DOM 对象身份、注入网页脚本无法读取隔离全局、JS 异常、导航后状态清空与 Native viewport。既有动态表单/表格、旧 ref/取消/Owner、cookie/历史/生命周期、认证/blob 下载继续保留。Native 下载按不支持跳过,不能视作下载测试通过。 ## 复现与目标系统验收 ```sh CGO_ENABLED=0 go test -buildvcs=false -mod=vendor ./... -count=1 -coverprofile=test-results/unit.cover go vet -mod=vendor ./... CGO_ENABLED=1 go test -mod=vendor -race ./... -count=1 sh scripts/cross-build.sh python3 -m unittest discover -s scripts -p 'test_*.py' -v ``` Windows 在 PowerShell 执行 `./scripts/test-native.ps1`;macOS 在已登录图形会话执行 `sh scripts/test-native.sh`。构建、打包、诊断与期望结果详见 [NATIVE.zh-CN.md](NATIVE.zh-CN.md)。设置 CFBROWSER_TEST_ENGINE=native 可避免只运行 CDP 却误以为原生通过;cdp 表示仅 CDP,both 表示两者;为空保留原 CDP 加可选 CFBROWSER_NATIVE=1 行为。 macOS/Linux 可这样收集 worker 与 CLI 的原生运行覆盖率: ```sh mkdir -p test-results/coverage-native CGO_ENABLED=0 go build -cover -coverpkg=./... -o bin/cfbrowser ./cmd/cfbrowser CGO_ENABLED=0 go build -cover -coverpkg=./internal/nativehost,./cmd/cfbrowser-worker,./protocol,./api -o bin/cfbrowser-worker ./cmd/cfbrowser-worker GOCOVERDIR="$PWD/test-results/coverage-native" ./bin/cfbrowser --engine native --worker "$PWD/bin/cfbrowser-worker" demo go tool covdata textfmt -i=test-results/coverage-native -o=test-results/native.cover ``` PowerShell 中用 `$env:GOCOVERDIR` 设置已存在的绝对目录,输出文件名使用 .exe。强杀 worker 可能来不及写覆盖率,需要正常关闭。保留各 OS 单独报告,不把不同平台 profile 混成一个容易误解的百分比;统一排除 vendor。 目标验收仍需 Windows/macOS 原生脚本、真实签名包、前后台行为与关闭清理检查。通用 popup/dialog、任意外站、Native 截图/下载/可信输入、严格网络隔离、持久 profile、Job Object/进程组、宿主被强杀后的进程树清理不属于当前原型承诺。