← Agents

本赛道架构最激进的三个之一：云端 Agent 合上笔记本不中断、自托管代码不出网、代码审查拆成两个 bot 分工。

模型与开放条件

三档个人付费都标「Access to frontier models」，Pro / Pro+ / Ultra 的差别是额度倍数 而非模型可得性（官方原文分别为 extended / 3x / 20x Pro limits on Agent）—— 这一条与常见误解相反，值得单独记。 官方首页列出可选模型范围为OpenAI / Anthropic / Gemini / SpaceXAI / Cursor 自研， Auto 模式的具体候选（2026-10-01 官网示例）：Grok 4.7、GPT-5.6 Sol、 Fable 5.1、Max Opus 5.5、Gemini 3.1 Pro、Composer 2.5。 Cursor Router 按 cost / balance / intelligence 三档在多模型间路由， 官方说明按被路由到的模型标价计费；Router 先在 Teams / Enterprise 推出， 个人档「数月后」跟进。Hobby 档仅可用 Auto 模型。 供应方已明确不止一家：导航含 Grok / Grok Bot，各档另列「Grok 使用额度」。

运行位置

支持云端与自托管两种形态，这是本赛道最独特的架构。 2026-09-02 官方推出自托管支持： 代码库、构建产物与密钥保留在你自己基础设施内运行的机器上， 由智能体在本地处理工具调用。 另有 My Machines 形态——把单台笔记本或 VM 连到账户用于个人工作流。 官方文档同时说明 Cursor Router 可在编辑器 / CLI / Cursor SDK / iOS 应用中使用。

本地文件

通过 VS Code 衍生的编辑器形态访问工作区文件。 自托管形态下代码与产物不离开你的基础设施。 索引策略官方写了（2026-10-03 补，取自官方 Search 文档页）： 检索用自研的 Instant Grep，官方称在大型代码库上优于 ripgrep， 「runs automatically; no configuration needed」，无需配置。 一条值得单独记的数据边界（官方原文）： 「Instant Grep builds and queries its index on your machine. Cursor does not upload file paths or code to build a search index, and it does not store embeddings of your codebase for search」。 即检索索引完全在本机，且官方明说不为检索存embedding。 ⚠ 但同一页紧接着留了一句：「When Agent opens a match, that file content can still be included in the model request」—— 「建索引不出本机」≠「文件内容不出本机」，命中后内容照样进模型请求。 Explore 子智能体是官方给的上下文控制手段：跑在独立上下文窗口、 用更快的模型、执行并行搜索后只回传相关发现， 「returning only the relevant findings」—— 官方明说这是为了避免「把原始文件内容整段倒进主对话」。 ⚠ 大仓库的索引性能与规模上限，官方文档未给数字。

关机后的任务

云端 Agent 能力很强且有官方明确表述： 「项目」在云端独立计算机上运行， 合上笔记本电脑也不会中断； 需要本机测试时，协调智能体会启动本地智能体。 官方另称可让协调智能体监听 Slack 频道、按计划运行、 跟踪所有 PR，主动行动而无需等待提示。

工具与扩展

Pro+ 及以上档官方列出 MCP、技能（Skills）和钩子（Hooks）， 以及云端智能体与按用量计费的 Bugbot（智能体驱动的代码审查）。 Teams 档另有面向内部规则、技能与插件的团队应用市场。 MCP 接入细节（2026-10-03 补，取自官方 MCP 文档页）： 三种传输方式 —— stdio（本地，由 Cursor 启动，shell 命令启动，手动认证）、 SSE 与 Streamable HTTP（均可本地或远程部署为服务器，多用户，OAuth 认证）。 协议能力六项全支持：Tools / Prompts / Resources / Roots / Elicitation / Apps。 配置分两层：项目级 .cursor/mcp.json（可用 ${workspaceFolder}）、 全局 ~/.cursor/mjsson（可用 ${userHome}）； 变量插值支持 ${env:NAME}、${userHome}、${workspaceFolder}、 ${pathSeparator}，且支持 envFile 从 .env 读密钥（仅 stdio）。 工具审批默认开启：「Cursor asks for approval before using MCP tools by default」， 且工具级 allowlist 可限制某服务器哪些工具能自动运行。 每个 MCP 服务器有独立网络模式：Allow all / Allowlist / Deny all / No sandbox。 ⚠ 注意 ~ 是 home 目录，与「Pro+」无关。 Hooks 事件清单（2026-10-03 补，取自官方 Hooks 与插件参考页）： agent 钩子 18 个 —— sessionStart sessionEnd preToolUse postToolUse postToolUseFailure subagentStart subagentStop beforeShellExecution afterShellExecution beforeMCPExecution afterMCPExecution beforeReadFile afterFileEdit beforeSubmitPrompt preCompact stop afterAgentResponse afterAgentThought；另有 Tab 钩子 beforeTabFileRead afterTabFileEdit 与应用生命周期 workspaceOpen。 钩子是命令型（{"command": "./hooks/audit.sh"}，可带 matcher 过滤）， 官方给了 TypeScript 变体（由 Bun 驱动）可做结构化 I/O 与 HTTP。

上下文与记忆

「项目」的核心设计是长期上下文维持—— 官方原文：能在长达数月的工作中持续保持上下文， 将任务委派给成千上万个子智能体， 还可无需提示自动执行周期性工作。 共享上下文会在多个云端与本地机器间同步： 一个智能体摸清如何测试某服务后，后续智能体可直接复用。

权限与限制

安全审查以 bot 形式提供，且分两个职责： Security Review 结合全库上下文读每个 PR，报告可被利用的缺陷 （注入、认证绕过、密钥提交、SSRF、不安全反序列化、 引入已知漏洞的依赖变更等），每项标明严重级别、攻击路径与修复建议； 代码风格与质量问题仍由 Bugbot 负责。 支持为仓库添加规则（如外部调用必须走哪个客户端、 哪些表不能在请求处理程序里查），Security Review 会在每个 PR 强制执行。 草稿 PR 会被跳过。

适合什么任务

需要云端 Agent 且希望合上笔记本任务继续跑的人； 需要长周期（数月级）上下文维持与大规模子智能体编排的人； 代码不能离开自有基础设施的企业（自托管形态）。 Free 档适合想低成本试智能体的人（有限额度 + Composer 访问）。

本页由 ai-agent-guide 数据层生成（CC BY 4.0）。 方法论与坐标系定义见仓库内 METHODOLOGY.md。