@agentproto/adapter-browser-camofox

中文文档
0.2.6发布于 2026/11/01Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 4959

Camofox 为Agentproto提供浏览器服务:一个定义的Browser提供商在camofox septth-Firefox REST服务器上,拥有一相机启动,健康映射,浏览器Driver.

中文使用文档
文档目录4 节
  1. 它会做什么
  2. 认证
  3. 环境
  4. 服务器来源和许可证

@ agentproto/ 适应器浏览器- camofox

这个 camofox 浏览器提供者 @agentproto/driver-browser: 一等号 发射装置,一个REST客户端和一个 BrowserDriver 用于相机的服务器,一个隐形 Firefox (Camoufox)),位于一个小型的REST API后.

import { camofox } from "@agentproto/adapter-browser-camofox"

const instance = await camofox.launch({ port: 9377 }, { log: console.log })
console.log(instance.wasAlreadyRunning) // true when a healthy server was already up
const driver = await instance.attach({ initialUrl: "https://example.com" })
await driver.close()
await instance.stop()

它会做什么

  • launch() 探测器 GET /health。任何相册解答,包括一个503 浏览器正在启动或崩溃扫瞄, 算作运行中的服务器, 所以没有 第二个是产出 wasAlreadyRunning 实值 true。只有在什么都没有时 答案是否开始一个: launchCmd,则 CAMOFOX_SERVE_CMD,则 launchctl start <label> 在macOS上。 一个产入的服务器 CAMOFOX_PORT。 。 。 .
  • health() 地图 /health 进入工具箱的生命周期bootId, (中文(简体) ), startedAt, (中文(简体) ), browserState, (中文(简体) ), launchedAt, (中文(简体) ), lastLaunchMs, (中文(简体) ), lastRestartReason) (中文(简体) ). 一个503 browserState: "crash-looping" 是一个状态 (单位:千美元)ok: false),不是抛出的错误.
  • 驾驶员没有CDP: listRequests, (中文(简体) ), getRequestBody 财务报告和审定财务报表 send 掷出 BrowserUnsupportedError (能力) cdp),以及全页截图.
  • REST 客户端丢弃 CamofoxHttpError 任何非-2xx的回答.

认证

设定 CAMOFOX_API_KEY (或通过) apiKey每一个请求都带有 Authorization: Bearer <key>。密钥从未被记录并被擦除 错误文本 . /health 在服务器上保持无认证状态.

环境

变量使用
CAMOFOX_URL当启动时服务器来源为否 baseUrl 或者说 port默认 http://127.0.0.1:9377。 。 。 .
CAMOFOX_API_KEY持枪钥匙.
CAMOFOX_SERVE_CMD启动服务器的 shell 命令( 需要关闭 macOS) .
CAMOFOX_NATIVE_VIDEOtrue 当服务器在本地录入视频时.
BUREAU_BEHAVIOR附加驱动程序的默认间距配置 .

服务器来源和许可证

相机的服务器是 jo-inc/camofox-browser,麻省理工学院许可,版权Jo, Inc. 我们的补丁住在叉子上 bureau-sh/camofox-browser; HTTP 合同此软件包 目标就是叉子 docs/BUREAU-API.md此套件只与 服务器通过 HTTP 并包含其代码 。 这个包裹是Apache-2.0.

版本与发布记录

@agentproto/adapter-browser-camofox 共发布 8 个版本,首次发布于 2026/09/30;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.6latest2026/11/016 天前
0.2.52026/10/2711 天前
0.2.42026/10/1919 天前
0.2.32026/10/1820 天前
0.2.22026/10/1029 天前
0.2.12026/10/0929 天前

关于 @agentproto/adapter-browser-camofox 的常见问题

@agentproto/adapter-browser-camofox 是什么?

Camofox 为Agentproto提供浏览器服务:一个定义的Browser提供商在camofox septth-Firefox REST服务器上,拥有一相机启动,健康映射,浏览器Driver.

如何安装 @agentproto/adapter-browser-camofox?

在项目目录运行 npm install @agentproto/adapter-browser-camofox,或使用 pnpm add / yarn add / bun add。

@agentproto/adapter-browser-camofox 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@agentproto/adapter-browser-camofox 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@agentproto/adapter-browser-camofox 可以商用吗?

@agentproto/adapter-browser-camofox 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@agentproto/adapter-browser-camofox 的下载量有多少?

根据 npm 官方下载统计,@agentproto/adapter-browser-camofox 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,959 次,日均约 165 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@agentproto/adapter-browser-camofox 还在维护吗?

最新版本 0.2.6 发布于 2026/11/01(6 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/09/30。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。