Cursor Cookbook 是 Cursor 官方推出的开源示例集，它不是一款独立软件，而是一套开箱即用的「AI 编程智能体（Coding Agent）集成指南」。它帮你把 Cursor 强大的本地+云端双模 AI 编程能力，像插件一样接入自己的脚本、命令行工具、Web 应用甚至项目管理看板中——告别在编辑器里点点点的碎片化体验，真正实现「用代码调度 AI」的自动化开发新范式。
核心功能
- 一键调用 Cursor 智能体 SDK：通过 TypeScript API，在 Node.js 脚本或前端应用中直接启动、控制和监听 Cursor 的 AI 编程代理，支持本地 workspace 与 Cursor Cloud 双环境无缝切换
- 实时流式响应处理：不再等待“生成完成”，而是像监听日志一样逐块接收 AI 的思考过程、代码输出、文件修改建议等事件流，便于构建反馈闭环和调试体验
- 可视化云代理管理看板：内置 Kanban 看板（agent-kanban），可按状态（运行中/已完成/失败）、仓库分组查看所有云端 AI 任务，预览生成的代码/文档等产物，点击即复用
- 终端友好型编码 CLI 工具：无需打开 IDE，一条命令即可在终端中启动 AI 编程代理，输入自然语言需求，实时生成并应用代码变更，适合 DevOps 流水线或快速原型验证
- 低门槛沙盒应用搭建器：app-builder 示例提供一个 Web 界面，让你在浏览器中零配置启动隔离的云代理，安全地尝试新框架、重构旧项目或生成 demo，所有操作不污染本地环境
- 全链路可控性设计：从 prompt 模板管理、模型切换、运行中断（cancel）、会话状态持久化到产物（artifacts）提取，每个环节都暴露为可编程接口，满足工程化集成需求
适合哪些人用
如果你是以下角色，这套 Cookbook 就是为你量身定制的「AI 编程工业化入口」：
• 前端/全栈开发者：想把 AI 能力嵌入内部工具平台、低代码系统或团队知识库；
• 技术负责人与架构师：需要评估 AI 编程如何融入 CI/CD、代码审查、自动化文档生成等标准化流程；
• DevOps 工程师：希望用自然语言触发部署脚本、日志分析或故障修复任务；
• 教育者与技术博主：快速构建可演示的 AI 编程教学案例或交互式学习沙盒；
• 热爱探索的个体开发者：厌倦了重复配置，想用几行 TS 代码就拥有属于自己的「AI 编程指挥中心」。
快速上手
只需三步，5 分钟启动第一个 AI 编程代理：
1️⃣ 访问 Cursor 集成控制台，免费创建一个 API Key；
2️⃣ 将密钥保存为环境变量：CURSOR_API_KEY=sk_xxx；
3️⃣ 克隆项目后进入 sdk/quickstart 目录，运行 npm install && npm start —— 你会看到 AI 在终端中逐步思考、编写并输出一段完整功能代码。其他示例（如 CLI、Kanban 看板）也均采用相同模式，README 中已提供清晰的启动命令和截图说明。
项目信息
2.6k
Stars
287
Forks
TypeScript
—
TypeScript | ⭐ 2588 Star | 协议未明确声明（建议使用前查阅官方文档确认合规要求） | GitHub 项目地址
这是 Cursor 官方出品的高质量工程实践资源，虽托管于 GitHub，但对中文开发者极其友好——所有示例注释、CLI 提示、Web 界面文案均为英文，但逻辑清晰、结构规范，配合 VS Code 中文插件与 Copilot 辅助，学习成本极低。
它不教你“怎么用 Cursor”，而是告诉你“怎么让 Cursor 为你所用”——这才是 AI 编程从玩具走向生产力的关键跃迁。
