Cursor SDK 3.7 重大更新：自定义存储、自定义工具、自动审核与嵌套子 Agent，从 AI IDE 到 Agent 平台

核心结论

如果你在搜「Cursor SDK 2026年更新了什么」，简短结论是：Cursor 在 6 月 4 日推出了 SDK 3.7 重大升级，同时支持 TypeScript 和 Python。新增四种核心能力——自定义存储（JSONL/Postgres）、自定义工具（把自己的函数暴露给 Agent）、自动审核（Auto-Review 路由到人工/CI 管道）、以及无限深度嵌套子 Agent。这标志着 Cursor 从"IDE 里的 AI 助手"正式进化为"可编程 Agent 平台"，开发者现在可以用 @cursor/sdk 构建自己的 CI/CD 机器人、PR 审查管道、以及自动化代码迁移工具。

正文

Cursor 在 2026 年 4 月 29 日发布了 TypeScript SDK 的公测版（@cursor/sdk），让开发者可以在 Node 环境里编程式调用 Cursor 的 Agent 运行时。不到六周后的 6 月 4 日，Cursor 发布了 SDK 3.7——这是迄今为止最大的一次 SDK 升级，同时覆盖 TypeScript 和 Python，新增了四个核心原语。

一、自定义存储（Custom Stores）：Agent 元数据持久化

之前的 Cursor SDK 只支持内存式存储——Agent 跑完后所有状态就丢了。3.7 引入了可插拔的存储层：

• JSONL Store：最简单的持久化方式，Agent 运行结束后将元数据写入 JSONL 文件，可用于调试和分析。
• Custom Store（自定义后端）：通过实现 Store 接口，可以把 Agent 元数据写入任何后端——Postgres、SQLite、Redis、S3 等。
• Store 携带的数据：包括 Agent 的运行日志、工具调用记录、子 Agent 调用链路、以及人工审核结果。

这意味着开发者可以构建可恢复的 Agent：当一个长时间运行的 Agent 因为进程重启而中断时，可以从存储中恢复上下文并继续执行。

二、自定义工具（Custom Tools）：把任何函数变成 Agent 的能力

这是 3.7 最核心的更新。开发者现在可以把自己的 TypeScript/Python 函数注册为 Agent 的工具：

import { Agent } from '@cursor/sdk'

const agent = new Agent({
  tools: [
    {
      name: 'deploy_to_staging',
      description: '部署当前分支到 staging 环境',
      handler: async (args) => {
        // 调用你的 CI/CD 系统
        return { success: true, url: 'https://staging.example.com' }
      }
    }
  ]
})

• 工具可以调用内部 API、数据库、云服务、或者任何 Node/Python 能做的事
• 工具定义支持 JSON Schema 参数验证
• 自定义工具会与 Cursor 内置工具（文件读写、终端命令、代码分析等）合并使用

三、自动审核（Auto-Review）：Agent 工具调用的安全闸门

在 CI/CD 场景中，让 Agent 自主执行"危险操作"（如部署、删除文件、修改数据库）是有风险的。Auto-Review 机制解决了这个问题：

• 开发者可以标记某些自定义工具为 require_review: true
• 当 Agent 尝试调用这些工具时，会生成一个 Review Request，等待外部批准
• 批准可以通过人工（API/Webhook 回调）或 CI 管道自动化完成
• 审核结果会写回到 Store，形成审计追踪

四、嵌套子 Agent（Nested Subagents）：递归 Agent 架构

3.7 允许 Agent 在运行时动态创建子 Agent，并且子 Agent 可以再创建子 Agent，形成任意深度的树形结构。

这个能力的意义在于：

• 并行化：父 Agent 可以拆解任务，分发给多个子 Agent 并行执行
• 专业化：每个子 Agent 可以配备不同的工具集和模型配置
• 递归分解：复杂任务（如"迁移整个代码库"）可以按目录/模块递归分解

五、其他改进

• Run Correlation ID：每个 Agent 运行会生成一个 requestId，方便跨系统追踪
• 更轻量导入：减少了包体积和启动时间
• 可靠性修复：修复了子 Agent 上下文丢失和工具调用超时的问题

这意味着什么？

SDK 3.7 的发布标志着 Cursor 战略的明确转向：它不再仅仅是一个"AI 辅助编程的 IDE"，而是一个Agent 运行时平台。开发者可以用 @cursor/sdk 构建：

• CI/CD 自主修复 Agent：监控构建失败 → 读取日志 → 修复代码 → 提交 PR
• 代码库迁移 Agent：扫描代码 → 识别 deprecated API → 自动替换 → 人工审核 → 生成 PR
• PR 审查 Agent：自动审查代码质量、安全性、风格 → 加评论 → 标记 approver 注意项
• 文档生成 Agent：扫描代码 → 提取 API 签名 → 生成 markdown 文档 → 提交 PR

对标与定位

Cursor SDK 的直接竞品是 Claude Code 的 CLI 模式（claude 命令行）和 OpenAI Codex CLI。但 Cursor SDK 有两个独特优势：

1. 完整的 Agent 运行时：不是调用一个模型 API 完事，而是内置了文件系统访问、终端执行、代码搜索等工具链
2. 双语言生态：同时支持 TypeScript 和 Python，覆盖了前端和后端开发者

目前 Cursor SDK 仍处于公测阶段，价格包含在 Cursor Pro ($20/月) 和 Pro+ ($40/月) 订阅中。

总结

Cursor SDK 3.7（2026 年 6 月）是 Cursor 从"AI IDE"到"Agent 平台"转型的关键一步。自定义存储、自定义工具、自动审核和嵌套子 Agent 这四个原语，让开发者可以用 Cursor 构建的 Agent 运行时远超代码补全场景，进入 CI/CD、代码迁移和自动化 PR 审查等企业级工作流。