# @cursor/bdk 中文文档

规范地址：https://npmcn.com/package/%40cursor/bdk/

版本：0\.6\.0
npm 元数据更新时间：2026-11-03T16:40:50.319Z
中文译文更新时间：2026-11-11T05:04:11.838Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

原始 npm 页面：https://www.npmjs.com/package/%40cursor/bdk
原文对照：https://npmcn.com/package/%40cursor/bdk/?lang=original
项目主页：https://cursor.com/
源码仓库：https://github.com/cursor/cursor

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

- 包体积（解压后）：16.6 MB，2124 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13
- 运行依赖：34 个
- peer 依赖：zod ^3\.25\.0 \|\| ^4\.0\.0
- 首次发布：2026-09-22T18:26:14.733Z
- 最新版本发布：2026-11-03T16:40:50.020Z
- 近 30 天下载量：127402（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 32 个）

## 中文简介

建立,测试,并部署代理 作为密码Cursor的代理牵引.

## 安装

```sh
npm install @cursor/bdk
```

也可以使用：`pnpm add @cursor/bdk`、`yarn add @cursor/bdk`、`bun add @cursor/bdk`

## README

# SDK探员

SDK探员是Cursor如何建立bots和 探员 这是Bugbot背后的引擎开源版本, 安全审查,批准瓶,和推出.

一个代理SDK项目是Markdown和TypeScript的文件夹. 组合模式 ,然后提供结果 源控,Slack,发行跟踪器,和Cursor.

## 为什么用它

-   **鲍茨和特工都住在你的保险箱里.** 评论、版本和船舶 指令,工具,还有你的代码.
    
-   **光标运行回路.** 您的项目获得 Cursor 的模型和工具 呼叫,技能,MCP,和子剂.
    
-   **使用它的地方你的工作.** 从源控制触发一个工程 事件, 黑线,自定义的webhooks,或调度.
    
-   **测试普通类型脚本 .** 添加无 evals 和 单元测试 单独的配置语言.
    
-   **选择它运行的地方.** 部署到光标管理的主机或运行 您的基础设施的过程 .
    

## 何时使用 SDK 代理

|  | 光标自动化 | 格鲁克瓶 | SDK探员 |
| --- | --- | --- | --- |
| **用于** | 由迅速和触发驱动的可重复的工作 | 在 Cursor 中工作的互动代理 | 需要自定义代码、集成、测试或部署选择的代理人 |
| **您定义** | 仪表板上的快取、模型和触发器 | 应用程序中的指令、技能和相关工具 | 一个版本的 Markdown 和 TypeScript 工程 |
| **它运行的地方** | 光标管理 | 光标管理 | 光标管理托管或您的基础设施 |
| **选择何时** | 任务符合时间表或事件触发器 | 您想要不创建软件工程的代理 | 你要用定型的代码来决定模型判断 你的团队可以审查和测试一个项目 |

## 开始吧

SDK特工需要22.13节点或更新. 安装 `@grok/agent-sdk`创建一个 ,并启动开发服务器:

```bash
npm install --global @grok/agent-sdk
agent-sdk init ./my-bot
cd my-bot
agent-sdk dev
```

对于没有全局安装的一次性脚手架:

```bash
npx @grok/agent-sdk init ./my-bot
```

在 Cursor 中打开工程 。 SDK 代理用户 `bot/` 为代理人保留 `evals/` 项目根 :

```text
my-bot/
├── package.json
├── bot/
│   ├── agent.ts
│   ├── instructions.md
│   ├── tools/
│   ├── skills/
│   ├── mcp-connections/
│   ├── subagents/
│   ├── channels/
│   ├── hooks/
│   └── schedules/
└── evals/
```

在 Cursor 中描述机器人或代理, 或者自己编辑文件 .

## 从模板开始

传递模板到 `agent-sdk init` 当一个符合你的目标时:

| 模板 | 能力 |
| --- | --- |
| `security-reviewer` | 审查可开发错误的拖取请求 |
| `thermo-quality-review` | 审查结构代码质量 |
| `thermo-review` | 审查错误和断开 |
| `agentic-owners` | 应用所有者政策来拉动请求 |
| `triage-linear` 或者说 `triage-jira` | 跟踪仪问题 |

```bash
agent-sdk init ./security-reviewer --template security-reviewer
```

`--template triage` 选择 `triage-linear`。 。 。 .

## 今后的步骤

运行 `agent-sdk docs` 打开全部文档。 默认, `agent-sdk serve` 也提供同一地点的文件 `/docs`。 。 。 .

文件包括:

-   一个完整的公关审查员快速启动
-   GitHub、Slack、webhook和MCP指南
-   木卫一和山地攀登
-   部署和解决问题
-   项目布局、 CLI 和 API 参考

## 常见问题

### @cursor/bdk 是什么？

建立,测试,并部署代理 作为密码Cursor的代理牵引\.

### 如何安装 @cursor/bdk？

在项目目录运行 npm install @cursor/bdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：zod（^3\.25\.0 \|\| ^4\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 bdk、agent-sdk，可以用 npx bdk 直接运行。

### @cursor/bdk 支持 TypeScript 吗？

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

### @cursor/bdk 支持 ESM 还是 CommonJS？

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

### @cursor/bdk 需要什么版本的 Node\.js？

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

### @cursor/bdk 可以商用吗？

@cursor/bdk 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @cursor/bdk 的下载量有多少？

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

### @cursor/bdk 还在维护吗？

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