# @browserless/ai 中文文档

规范地址：https://npmcn.com/package/%40browserless/ai/

版本：14\.1\.8
npm 元数据更新时间：2026-11-07T20:34:32.485Z
中文译文更新时间：2026-11-08T16:33:48.654Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40browserless/ai
原文对照：https://npmcn.com/package/%40browserless/ai/?lang=original
项目主页：https://browserless.js.org/
源码仓库：https://github.com/microlinkhq/browserless#master

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：47.2 kB，13 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>= 24
- 运行依赖：1 个
- peer 依赖：browserless \>=13
- 首次发布：2026-08-23T20:05:29.217Z
- 最新版本发布：2026-11-07T20:34:32.339Z
- 近 30 天下载量：3844（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：50（近 12 个月 50 个）

## 中文简介

使用无浏览器从Node.js运行 Chrome Built-in AI APIs(Prompt, Summariers, 翻译, 语言检测器).

## 安装

```sh
npm install @browserless/ai
```

也可以使用：`pnpm add @browserless/ai`、`yarn add @browserless/ai`、`bun add @browserless/ai`

## README

![browserless](https://github.com/microlinkhq/browserless/raw/master/static/logo-banner.png#gh-light-mode-only) ![browserless](https://github.com/microlinkhq/browserless/raw/master/static/logo-banner-light.png#gh-dark-mode-only)  
  
[![Powered by microlink.io](https://img.shields.io/badge/powered_by-microlink.io-blue?style=flat-square&color=%23EA407B)](https://microlink.io/) ![Last version](https://img.shields.io/github/tag/microlinkhq/browserless.svg?style=flat-square) [![Coverage Status](https://img.shields.io/coveralls/microlinkhq/browserless.svg?style=flat-square)](https://coveralls.io/github/microlinkhq/browserless) [![NPM Status](https://img.shields.io/npm/dm/browserless.svg?style=flat-square)](https://www.npmjs.org/package/browserless)  
  

> @browserless/ai:从Node.

见 [ai 节](https://browserless.js.org/#/?id=ai) 我们的网站有更多信息.

## 安装

使用 npm :

```sh
npm install @browserless/ai --save
```

要求节点.js 24+和a [无浏览器](https://www.npmjs.com/package/browserless) 鼠标.

## 关于

此软件包运行 [Chrome 内建AI](https://developer.chrome.com/docs/ai/built-in-apis) 从Node.js. 它在一个没有浏览器的页面上评价了Expony,Summerizer, Translaters,和Language Detectionor,所以您可以从脚本而不是可见的Chrome窗口调用这些API.

Chrome for Testing 不下载双子纳米为你。 把它打入一个目录 然后通过 `dir` 改为 `createAi` 编号 : `launch`。 。 。 .

Chrome的文档允许基础模型打开 **GPU (> 4 GB VRAM) 或 CPU (16 GB RAM, 4+ 核心)** 在运行时间。 仅当桌面 Chrome 首次下载 Nano 时, 才适用 22 GB 配置文件卷空间和未实现的连接 `dir`。 。 。 .

### 使用量

```js
const createAi = require('@browserless/ai')

const { dir } = await createAi.unpack(createAi.download)
const ai = createAi({ dir })

await ai.capabilities()
await ai.detectLanguage('https://example.com', { text: 'Hello, how are you today?' })
await ai.summarize('https://example.com', { type: 'tldr' })
await ai.prompt('https://example.com', { prompt: 'What is this page about?' })
const schema = { type: 'object', properties: { title: { type: 'string' } } }
await ai.extract('https://example.com', { schema })
await ai.translate('https://example.com', { text: 'Hello', sourceLanguage: 'en', targetLanguage: 'es' })
await ai.close()
```

`unpack` 接受本地zip路径或下载功能. `createAi.download` 是一个已签名的 R2 获取对象 (`R2_ENDPOINT`, (中文(简体) ), `R2_ACCESS_KEY_ID`, (中文(简体) ), `R2_SECRET_ACCESS_KEY`) (中文(简体) ). 桶和物件键可以活在 `R2_ENDPOINT` (单位:千美元)`https://<account>.r2.cloudflarestorage.com/<bucket>/<key>`),或者在 `R2_BUCKET` 编号 : `R2_KEY`。函数可以返回路径, `Buffer`,流,或S3 `GetObject` 结果,或写到 `dest` 它接收的路径。 如果目录已经解开, `unpack` 重新使用,除非你通过 `{ force: true }`。 。 。 .

如果您已经有一个无浏览器实例 :

```js
const createBrowser = require('browserless')
const createAi = require('@browserless/ai')

const browser = createBrowser(createAi.launch({ dir: process.env.BROWSERLESS_AI_DIR }))
const ai = createAi(async teardown => {
  const browserless = await browser.createContext()
  teardown(() => browserless.destroyContext())
  return browserless
})
```

每种页面处理方法都是 `(url, options)`。通过 `options.text` 。否则软件包将读取 `document.body.innerText` 导航后. `capabilities` 接受 `{ timeout, url }` 和供给违约.

| 方法 | 创建选项 |
| --- | --- |
| `prompt` 编号 : `extract` | `temperature`, (中文(简体) ), `topK`, (中文(简体) ), `initialPrompts`, (中文(简体) ), `expectedInputs`, (中文(简体) ), `expectedOutputs` |
| `summarize` | `type`, (中文(简体) ), `format`, (中文(简体) ), `length`, (中文(简体) ), `sharedContext`, (中文(简体) ), `expectedInputLanguages`, (中文(简体) ), `outputLanguage`, (中文(简体) ), `expectedContextLanguages` |
| `translate` | `sourceLanguage`, (中文(简体) ), `targetLanguage` (必须) |
| `detectLanguage` | `expectedInputLanguages` |

### 选项

| 选项 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `dir` | `string` | `BROWSERLESS_AI_DIR` | 未包装的型号树( E)`nano/`, (中文(简体) ), `prompt/`, (中文(简体) ), `summarize/`, (中文(简体) ), `detect/`(中文(简体) ) |
| `timeout` | `number` | `300000` | 启动和评估超时(毫秒). `protocolTimeout` 跟着它 |

`unpack(source, { dir, force })` 写到 `dir` 当你通过一个。 否则就用 `BROWSERLESS_AI_DIR`,或 `~/.cache/browserless-ai`。 。 。 .

### 装入模型

从已经拥有纳诺的机器(桌面Chrome,或 `BROWSERLESS_AI_DIR`:

```sh
pnpm --filter @browserless/ai pack-model
pnpm --filter @browserless/ai pack-model -- --upload
```

写作 `/tmp/browserless-ai-nano.zip`。 。 。 . `--upload` 并被推到R2(`R2_ENDPOINT`, (中文(简体) ), `R2_ACCESS_KEY_ID`, (中文(简体) ), `R2_SECRET_ACCESS_KEY`;桶/键可能在端点URL中. 测试运行 `install-model` 首先,在同一变量设定时下载该对象.

### 示例

```sh
pnpm --filter @browserless/ai start
pnpm --filter @browserless/ai start https://example.com
```

### 方法

| 方法 | 缩写 API | 颜色 |
| --- | --- | --- |
| `prompt` | `LanguageModel` | 148国 |
| `extract` | `LanguageModel` + 键 `schema` 编号 : `responseConstraint` | 148国 |
| `summarize` | `Summarizer` | 138号 |
| `detectLanguage` | `LanguageDetector` | 138号 |
| `translate` | `Translator` | 138号 |
| `capabilities` | 特性检测 | —— 说 |

`extract` 需求 `schema` 或者说 `responseConstraint`。 。 。 . `translate` 需求 `sourceLanguage` 财务报告和审定财务报表 `targetLanguage`语言探测器和翻译器的下载与双子座纳诺分开。 即时及总结用纳诺.

### 如何适合在单体

这个 **扩展功能包**它没有被接入 `browserless` 核心——安装 `@browserless/ai` 当你需要来自Node.js的Chrome Built -in AI时.

## 许可证

**@ 浏览/ ai** © [微链接](https://microlink.io/),在 [麻省理工学院](https://github.com/microlinkhq/browserless/blob/master/LICENSE.md) 执照.  
作者和维护者 [微链接](https://microlink.io/) 由来自 [捐助者](https://github.com/microlinkhq/browserless/contributors)。 。 。 .

这个 [标志](https://thenounproject.com/term/browser/288309/) 设计由 [辛赫工作室](https://xinh.studio/)。 。 。 .

> [微链接.io](https://microlink.io/) • GitHub 软件 [微链克](https://github.com/microlinkhq) • X [@microlinkhq (英语)](https://x.com/microlinkhq)

## 常见问题

### @browserless/ai 是什么？

使用无浏览器从Node\.js运行 Chrome Built-in AI APIs\(Prompt, Summariers, 翻译, 语言检测器\)\.

### 如何安装 @browserless/ai？

在项目目录运行 npm install @browserless/ai，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：browserless（\>=13）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @browserless/ai 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/browserless\_\_ai 是否存在。

### @browserless/ai 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @browserless/ai 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>= 24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @browserless/ai 可以商用吗？

@browserless/ai 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @browserless/ai 的下载量有多少？

根据 npm 官方下载统计，@browserless/ai 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,844 次，日均约 128 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @browserless/ai 还在维护吗？

最新版本 14\.1\.8 发布于 2026/11/08（今天）；至今共发布 50 个版本，其中过去 12 个月发布了 50 个；首次发布于 2026/08/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。