Appearance
Cursor 与 GitHub 深度集成：连接 GitHub App 后，可以把代码任务推送到云端 Agent 执行（不占用本地资源），Bugbot 自动审查 PR 并追踪发现的 bug。本文介绍如何连接 Cursor GitHub App、各项权限说明，以及 GitHub Enterprise Server 的企业级配置方式（PrivateLink、IP 白名单）。
Cursor GitHub 集成
Cursor 的 GitHub 集成解锁了两个核心功能：
- Cloud Agents：把耗时任务推到云端跑，本地继续干别的
- Bugbot：自动审查每个 PR，发现 Bug 和代码质量问题
连接 GitHub App
前提条件：
- 你在 Cursor Dashboard 有管理员权限
- 你在 GitHub 组织里有管理员权限（或 repo 级别权限）
连接步骤：
- 打开 Cursor Dashboard
- 进入 Integrations > GitHub
- 点击"Connect GitHub App"
- 在 GitHub 授权页面选择要连接的组织/仓库
- 完成授权后回到 Cursor Dashboard 确认连接状态
GitHub App 权限说明
连接时会请求以下权限：
| 权限 | 用途 |
|---|---|
| 克隆代码 / 创建工作分支 | Cloud Agent 执行任务时使用 |
| 创建 PR / 添加审查评论 | Bugbot 和 Cloud Agent 提交工作成果 |
| 追踪 Bug 和任务 | Bugbot 建立 Issue 追踪发现的问题 |
| 读取代码质量和测试结果 | Bugbot 分析 CI 状态 |
| 监控 CI/CD 流水线 | Cloud Agent 跟踪部署状态 |
Cloud Agents：云端异步执行
连接 GitHub 后，可以把任务推送到云端 Agent：
bash
# CLI 里用 & 前缀
& add comprehensive tests to the auth module
# 或在 IDE Agent 里说：
"在云端帮我给 auth 模块写完整的测试"云端 Agent 会：
- Clone 仓库到云端沙箱
- 执行任务（读写文件、运行测试）
- 创建一个 PR 或在现有分支提交改动
- 把结果报告给你
适合：长时间重构、批量代码生成、不想等在电脑前的任务。
Bugbot：自动 PR 审查
启用后，每次有人提 PR，Bugbot 自动扫描：
- 潜在 Bug（空指针、边界条件、资源泄漏等）
- 代码质量问题
- 与已有代码的不一致
结果以 PR Review 形式出现，包含具体的行号和建议。
企业级配置
GitHub Enterprise Server
企业内网 GitHub 也支持集成，在连接时选择"GitHub Enterprise Server"并填入内网地址。
网络连接选项：
- PrivateLink（AWS）：通过 AWS PrivateLink 连接，不走公网
- Private Service Connect（GCP）：GCP 版本的私有连接
- Reverse Proxy Tunnel：通过反向代理隧道，适合防火墙严格的环境
IP 白名单
如果 GitHub 组织开启了 IP 白名单，需要把 Cursor 的 IP 地址加入允许列表。在 Cursor Dashboard 查看当前出口 IP 地址，然后在 GitHub 组织设置里添加。
也可以开启"Allow access by GitHub Apps"选项，让 GitHub App 继承已有的 IP 白名单规则，不需要单独添加。
常见问题
Q: 连接 GitHub App 需要组织管理员权限吗？
通常需要。如果你不是组织管理员，需要让管理员帮你在 GitHub 组织设置里授权 Cursor App。安装完成后，普通成员也可以使用集成功能。
Q: Cloud Agent 会把我的代码上传到哪里？
Cloud Agent 在 Cursor 的云端沙箱运行，代码临时克隆到隔离环境，任务完成后清理。具体数据处理策略参考 Cursor 隐私政策。
Q: Bugbot 会影响 PR 审查流程吗？
Bugbot 以 Review 形式添加评论，不会阻塞 PR merge（除非你在分支保护规则里配置了"需要 Cursor 审查"）。可以把 Bugbot 当成一个额外的自动审查者。