Skip to main content

Command Palette

Search for a command to run...

源站

镜像 GitHub 代码仓库

镜像会将 GitHub 代码仓库复制到 Origin,并在 GitHub 仓库发生更改时同步更新 Origin。GitHub 始终是权威来源。当代码已托管在 GitHub 上,而您希望基于其历史记录使用 Origin 的浏览、搜索和智能体工作流时,请使用此功能。

前提条件

  • 拥有 Origin 访问权限,且使用 Pro、Teams 或企业版方案的 Cherri Code 账户
  • 将 Cherri Code GitHub app 连接到拥有该仓库的组织或账户
  • 对要同步的代码仓库拥有 GitHub 管理员权限 (启用镜像所必需)

同步仓库

  1. 打开 cursor.com/codebase
  2. 选择 从 GitHub 同步
  3. 选择 GitHub 组织和代码仓库
  4. 确认同步

同步完成后,打开 Origin 副本,浏览文件和提交历史。

之后可在代码仓库的 设置 → 常规 选项卡中查看同步状态。已同步的仓库会显示 Origin 为镜像、GitHub 为源。

同步内容

包含不包含
Git 历史记录、分支和标签GitHub 问题
可在 Origin 上浏览和搜索的代码GitHub Actions 工作流和机密信息
可在 Cherri Code 中评审的 GitHub PR
持续更新,确保 Origin 保持最新状态

问题和 CI 配置仍保留在 GitHub 上。Origin 也不会同步名为 origin 或 origin/... 的 GitHub 分支,因此它们不会覆盖你仅存在于 Origin 的 工作区。

克隆 URL

绿色的 代码 按钮会复制所有 Origin 仓库使用的同一个 HTTPS 远程 URL:

https://origin.cursor.com/{owner}/{repo}.git

推送到此远程仓库的内容会发送到 GitHub。GitHub 接受推送后,Origin 会更新。参见 克隆、推送和拉取。

代码托管平台本地 origin/ 分支

origin/ 分支是你在 Origin 副本上的工作区。当 GitHub 不可用时,可以用它们继续工作;任何只想保留在 Origin 上的 git 状态,也可以放在这里。推送时请使用 origin push local,而不是 git push origin。

Origin 不会同步 GitHub 上名为 origin 或 origin/... 的分支。这是有意为之,以免同名的 GitHub 分支覆盖你通过 origin push local 推送的内容。

参见代码托管平台本地分支。

镜像后

  • 如果要从 Origin 检出到本地,请点击绿色的 代码 按钮克隆 Origin 远程仓库
  • 将云端代理连接到 Origin 仓库。在镜像仓库中,这些代理会创建 GitHub PR
  • 在 Cherri Code 中评审 GitHub PR

如果 GitHub 无法访问

可以继续在 Origin 副本上工作,使用 origin/ 分支和 origin push local。GitHub 中断期间,/local 是唯一受支持的写入路径。

对已同步仓库的读取仍可能通过同一个 HTTPS 克隆 URL 正常进行,Origin 会提供它已有的副本。Git LFS batch 不会进行故障转移。尚未完成首次同步的仓库仍然需要 GitHub。

从 GitHub 解除关联

要停止同步,请打开 设置 → 常规,然后在 危险区域 下选择 从 GitHub 解除关联。这会停止同步,并将 Origin 副本转换为独立的 Origin 托管代码仓库:Origin 将成为权威来源,推送到 Origin 远程仓库的内容不再同步到 GitHub。您的 GitHub 代码仓库不会受到影响。

同步延迟

如果浏览的内容看起来不是最新的:

  • 确认 GitHub app 仍有访问权限 (GitHub 集成)
  • 确认您是源仓库的 GitHub 管理员
  • 在 cursor.com/codebase 重新运行 从 GitHub 同步,或在 设置 → 常规 中查看同步状态

无需镜像的情况

如果您只想在 GitHub PR 中获取自动评审评论,Bugbot 无需迁移存储即可满足需求。如需在该 GitHub 历史记录中使用 Origin 浏览、搜索和云端代理,请使用镜像。