Cursor SDK 迎来重磅更新：自定义工具、自动审查、嵌套子代理，编程 Agent 开发更自由
draft.md
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
Cursor SDK 迎来重磅更新：自定义工具、自动审查、嵌套子代理，编程 Agent 开发更自由
Cursor 正在把触手伸向 IDE 之外的更广阔天地。近日，Cursor 同时更新了 TypeScript SDK 和 Python SDK，推出了自定义工具（Custom Tools）、自动审查（Auto-review）、嵌套子代理（Nested Subagents）和 JSONL 持久化等一系列功能。这些更新让开发者可以在 CI 脚本、本地自动化和生产系统中更自由地编排 Cursor Agent——不再只依赖鼠标点按，而是真正把 Cursor 能力接入自己的代码管道。
自定义工具：告别自建 MCP 服务
此前，如果想让 Cursor Agent 调用你自己写的工具，必须自己搭建一个 stdio 或 HTTP MCP 服务器，再把它接入 agent，整个流程门槛不低。
现在，只需给 agent 传一个函数定义就行了。通过 local.customTools 传入函数签名，Cursor SDK 会自动在后台生成一个名为 custom-user-tools 的内置 MCP server，让模型通过同一套权限门控调用你的代码。
更重要的是：你在父 agent 里定义一次工具，子 agent 全链路都能用。一个 reviewer subagent 调用 test-writer subagent，再由它调用你的代码，不需要在每一层重复注册。
自动审查：本地跑 Agent 也有人把关
在 headless/CI 环境中跑 Agent，默认没有任何审批机制——工具调用直接执行，没有人在回路里。
新引入的 auto-review 机制填补了这个空白。通过 local.autoReview 开启后，工具调用会被路由到一个分类器 subagent，由它决定：直接放行、换种方式尝试、还是暂停等人工确认。
分类器的行为通过 permissions.json 中的自然语言指令来配置，比如：
```json
{
"autoRun": {
"allow_instructions": ["Read-only inspections of build artifacts under ./dist are fine."],
"block_instructions": ["Always pause delete operations so I get a chance to review them."]
}
}
```
这样本地跑 Agent 既不用每次都弹窗确认，也不会因为"无脑全放行"而埋下安全隐患。
嵌套子代理：Task() 可以递归调用
现在 subagent 可以再派生子 agent，支持任意深度的递归嵌套。一个 reviewer subagent 调用 test-writer subagent，后者再调用 lint subagent——每一层都可以持独立的 prompt 和 model，互不干扰。
启用方式没有特殊开关：subagent session 注册需要的 executor 后，嵌套自动生效。
附加：JSONL 持久化和自定义 Store
之前 agent 运行状态的存储只支持 SQLite。现在可以切换到 JSONL 模式，写入一个 append-only 的纯文本文件，可读、可 diff、可 check in 版本控制。
如果默认方案都不合适，可以实现 LocalAgentStore 接口，自定义存储逻辑：内存存储用于临时 CI run，或者接 Postgres 让 agent 状态和应用数据共存。Python SDK 额外提供了 host、JSONL 和组合式 JSONL 三种 bridge 模式。
怎么升级
```bash
npm install @cursor/sdk
或
基于已整理草稿生成的网页版文章，适合先稳定落地，再做局部润色与发布检查。
pip install cursor-sdk
```
脚本中如果指定了 composer-2，会自动迁移到 Composer 2.5。requestId 字段作为 metadata 添加是安全增量，可以直接引入。
完整文档见 [TypeScript SDK](https://cursor.com/docs/sdk/typescript) 和 [Python SDK](https://cursor.com/docs/sdk/python)。
为什么值得关注
Cursor SDK 的这波更新，代表了它从"AI 代码编辑器"向"可编程 AI Agent 平台"的演进。用函数定义替代 MCP 服务、用自然语言配置权限、用 JSONL 替代数据库——每一步都在降低把 AI Agent 集成到自己系统的门槛。
对于已经在用 Cursor 的团队，这些新能力意味着：可以把日常的测试、审查、部署等重复流程封装成 Cursor Agent 任务，在 CI 里跑；也可以在本地用 subagent 分解复杂任务，各层用不同的模型和提示词。
---
*来源：Cursor 官方更新日志（2026年6月）及官方文档，基于多家开发者社区转述整理。*
参考来源
说明：该页面由基础模板稳定生成，后续可继续局部润色样式或补充模块，再进入发布检查。