Camofox Browser
理解 Camofox Browser：面向智能体的浏览器服务，不只是 HTML 抓取器
区分 Camofox 的 REST 服务与 Camoufox 引擎，理解无障碍快照和元素引用，并定义经过授权的首次使用场景。
你将学会
- Camofox 是服务层，Camoufox 是浏览器引擎。
- 语义快照与截图回答不同观察问题。
- 页面变化后需要新状态对应的元素引用。
开始前需要
- 基础 HTTP 与 JSON 知识
- 隔离服务与自有或获准测试页面
解释本章真实服务边界，并核验建议的观察或生命周期样例。
先看结论
- Camofox 是服务层，Camoufox 是浏览器引擎。
- 语义快照与截图回答不同观察问题。
- 页面变化后需要新状态对应的元素引用。
两个名称代表不同层次
Camofox Browser 把 Camoufox 浏览器引擎包装为面向自动化客户端和 AI 智能体的服务。所查包名为 @askjo/camofox-browser，版本为 1.14.0。REST 接口负责创建标签页、返回观察结果和执行操作。Camoufox 是底层基于 Firefox 的浏览器；包装层 API、会话生命周期和部署配置属于另外的工程职责。
README 强调对检测自动化的网站的兼容性。这是上游主张，不是本次审查建立的保证。浏览器兼容性不代表有权访问账户、受保护内容或拒绝自动访问的服务。应在自有页面或明确允许的任务中评估项目，遇到访问限制时停止，而不是将其视为必须突破的错误。
操作之前先观察页面
服务提供无障碍快照和 e1 一类简短元素引用，让智能体获取角色与名称的紧凑描述，而不必读取原始 HTML。截图是另一种观察方式：它帮助判断外观，语义快照则帮助定位控件。两者用途不同，任一表示都不能单独证明页面的全部信息已被捕获。
引用不是网站的永久元素标识。所查服务器将引用映射到角色、名称和出现序号，适用时还包含框架信息。导航和页面变化会让映射失效。集成应先观察、选择一个适当操作、再观察；页面变化后重放旧引用，可能针对错误状态执行操作。
采用之前先定义产品边界
浏览器服务持有资源，也可能持有登录状态。调用方需要管理用户标识、标签组、标签 ID 和清理；HTTP 连接成功并不等于智能体工作流完整。架构和安全章节将区分浏览器上下文与调用方授权，也区分健康的空闲服务与真正成功渲染页面的浏览器。
包装层包声明 MIT 许可，但这并不覆盖每个依赖、访问的网站或捕获的素材。本系列检查固定提交，仅运行部分纯辅助函数，不宣称完成完整浏览器安装、在线兼容性基准测试或托管部署安全认证。读者应把源码观察与完整运行验收分开理解。
实施步骤
- 1
选择自有或明确允许测试的页面。
- 2
识别客户端、服务和引擎之间的边界。
- 3
创建标签前定义预期观察和允许操作。
可复制示例
{
"task": "检查自有测试表单",
"authorization": "测试所有者批准",
"observation": "快照及可选截图",
"action": "先只读",
"success": "预期标题和字段标签存在"
}常见问题
Camofox 与 Camoufox 是同一个项目吗？
不是。Camofox 围绕 Camoufox 引擎提供自动化服务，两者职责与配置层次不同。
e1 这类引用能跨导航保持稳定吗？
不能假设如此。所查服务器会重建引用映射，并在页面变化后报告过期引用。
资料来源
- README.md来源核查 2026-09-08
- package.json来源核查 2026-09-08
- Dockerfile来源核查 2026-09-08
- lib/auth.js来源核查 2026-09-08
- lib/snapshot.js来源核查 2026-09-08
- lib/extract.js来源核查 2026-09-08
- lib/config.js来源核查 2026-09-08
- lib/reporter.js来源核查 2026-09-08
- lib/page-lease.js来源核查 2026-09-08
- server.js来源核查 2026-09-08
- tests/unit/snapshot.test.js来源核查 2026-09-08
- tests/unit/auth.test.js来源核查 2026-09-08