# @beacon-ai/vercel 中文文档

规范地址：https://npmcn.com/package/%40beacon-ai/vercel/

版本：0\.1\.1
npm 元数据更新时间：2026-04-12T16:40:09.873Z
中文译文更新时间：2026-11-08T09:38:46.783Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40beacon-ai/vercel
原文对照：https://npmcn.com/package/%40beacon-ai/vercel/?lang=original
项目主页：https://github.com/Beacon-AI-Journey-Management/BeaconMVP#readme
源码仓库：https://github.com/Beacon-AI-Journey-Management/BeaconMVP

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

- 包体积（解压后）：9 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：next \>=14\.0\.0
- 首次发布：2026-04-12T16:31:28.287Z
- 最新版本发布：2026-04-12T16:40:09.736Z
- 近 30 天下载量：1829（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

追踪人工智能爬行者的活动 在你的Vercel主持的网站。 从灯塔的中线软件.

## 安装

```sh
npm install @beacon-ai/vercel
```

也可以使用：`pnpm add @beacon-ai/vercel`、`yarn add @beacon-ai/vercel`、`bun add @beacon-ai/vercel`

## README

# @beacon-ai/vercel (韩语)

追踪人工智能爬行者的活动 在你的Vercel主持的网站。 Next.js 中间软件 [灯塔](https://usebeacon.ai/)。 。 。 .

看看哪些人工智能提供者在爬行你的网站,多久一次,以及他们访问哪些网页. Beacon识别出130+AI代理并按用途分类(训练,搜索,用户发起).

## 安装

```bash
npm install @beacon-ai/vercel
```

## 设置

添加到您的 `middleware.ts`数字 :

```ts
import { beaconLogger } from '@beacon-ai/vercel'

export default beaconLogger({
  apiKey: process.env.BEACON_API_KEY!,
  brandId: process.env.BEACON_BRAND_ID!,
})
```

或者将您现有的中间软件包起来 :

```ts
import { withBeacon } from '@beacon-ai/vercel'

const myMiddleware = clerkMiddleware(async (auth, request) => {
  // your auth, redirects, etc.
})

export default withBeacon(myMiddleware, {
  apiKey: process.env.BEACON_API_KEY!,
  brandId: process.env.BEACON_BRAND_ID!,
})
```

在您的Vercel仪表板中设置环境变量 :

| 变量 | 说明 |
| --- | --- |
| `BEACON_API_KEY` | 您的灯塔 API 密钥( 从您的灯塔仪表板) |
| `BEACON_BRAND_ID` | 你的品牌ID(UUID,从灯塔仪表板) |

## 它捕捉到的东西

只请求元数据 。 永远不要要求或回应机构.

-   时间戳
-   主机名+路径
-   HTTP 方法
-   用户代理
-   IP 地址
-   参考文献

## 它不捕捉到的东西

-   请求机构
-   反应机构
-   饼干
-   认证信头
-   查询参数值( 只有路径)

## 业绩

对反应延迟性的影响为零。 伐木是火和遗忘 批量的Aync交付。 如果灯塔端点无法通达,则会默默地抛出原木.

## 配置

```ts
beaconLogger({
  apiKey: '...',           // required
  brandId: '...',          // required — your brand ID (UUID)
  batchSize: 50,           // entries to buffer before sending (default: 50)
  flushInterval: 5000,     // ms before flushing buffer (default: 5000)
})
```

## 许可证

麻省理工学院

## 常见问题

### @beacon-ai/vercel 是什么？

追踪人工智能爬行者的活动 在你的Vercel主持的网站。 从灯塔的中线软件\.

### 如何安装 @beacon-ai/vercel？

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

### @beacon-ai/vercel 支持 TypeScript 吗？

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

### @beacon-ai/vercel 支持 ESM 还是 CommonJS？

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

### @beacon-ai/vercel 可以商用吗？

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

### @beacon-ai/vercel 的下载量有多少？

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

### @beacon-ai/vercel 还在维护吗？

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