GitHub 镜像与 forge-local 分支
理解双平台写入方向、origin/ 保留命名空间和停止镜像的影响。
This page has not been translated into English yet. The original Chinese version is shown below.
Mirror 复制 Git history、branches、tags 和可评审的 GitHub PR，并持续同步；Issues、GitHub Actions 平台工作流配置与 secrets 仍留在 GitHub。它不是把 CI 或 issue 管理整体迁移到 Origin。
开始同步
需要 Origin 访问、连接源组织/账号的 Cursor GitHub App，并具有源仓库 GitHub admin 权限。在 codebase 首页 Sync from GitHub 选择组织和仓库，完成后从 Settings > General 看状态。
镜像专题的套餐示例比 Origin 总览窄，实际以账号获准功能为准，不据示例排除总览已列的新套餐。
普通 push 仍去 GitHub
镜像使用同样的 https://origin.cursor.com/{owner}/{repo}.git URL，但 git push 会送到 GitHub，GitHub 接收后再更新 Origin。GitHub 不可用时，已同步代码可能仍能读；首次同步与 Git LFS batch 不具备此 failover。
只写 Origin 的分支
git branch origin/my-state HEAD
origin push local --dry-run
origin push localorigin push local 检查当前 origin remote 是 inbound mirror，建立 origin-local remote 指向 .git/local，只为 refs/heads/origin/* 配置 fetch/push，并推送本地这些分支。
分支前缀必须是 origin/ 后有路径，单独 origin 或 original/backup 不合格。GitHub 上同名前缀分支被入站同步跳过，避免覆盖本地专有状态。
git push origin origin/my-state 仍推 GitHub，不能替代 origin push local。命令 --remote 可换 local remote 名，但不能是 origin/github。/local 按仓库开放，未开放可报 repository not found，非 origin/ ref 则 remote rejected。
这些分支不在 GitHub，不能作为 GitHub PR head。需要 GitHub PR 的功能分支使用普通 git push。Git 的 remote-tracking origin/main 与名为 origin/my-state 的本地 branch 也不是同一概念。
Detach 与滞后排查
Danger Zone > Detach from GitHub 停止同步，Origin 变为独立主仓库，此后 Origin push 不再流向 GitHub；源 GitHub 仓库不受影响。
内容滞后时先查 App 仓库权限、源 admin 资格和 Sync Status，再重新触发同步，不以 detach 代替诊断。