upstream-sync-curator

Upstream Sync Curator

仅用于本仓库 nervmor/codexui 与上游 friuns2/codexUI 之间的选择性同步。

固定上游地址：

https://github.com/friuns2/codexUI.git

不要直接同步整个 upstream。 固定执行“两阶段”流程：先分析 upstream 提交与代码变更，按功能主题整理候选变更；再根据用户选中的功能主题做选择性引入。

触发条件

当用户提到以下意图时触发：

• upstream sync
• 同步源仓库
• 选择性合并 upstream
• 分析上游提交
• 挑功能合并

仅适用于本仓库及其 upstream friuns2/codexUI。

第 1 阶段：准备环境

1. 检查主工作区是否干净。 如果主工作区不干净，先停止并让用户决定如何处理，不要把已有修改卷入 upstream 同步流程。

git status --short

1. 检查 origin 是否指向当前 fork nervmor/codexui。

git remote -v

1. 配置或校验 upstream，并强制使用 HTTPS 地址，不要使用 SSH。

git remote get-url upstream
git remote remove upstream
git remote add upstream https://github.com/friuns2/codexUI.git

1. 创建带时间戳的临时分支和临时 worktree，避免污染主工作区。

ts="$(date +%Y%m%d-%H%M%S)"
tmp_branch="upstream-sync-${ts}"
tmp_dir="$(mktemp -d -t codexui-upstream-sync-XXXXXX)"
git worktree add -b "${tmp_branch}" "${tmp_dir}" main

1. 后续所有 fetch、log、diff、cherry-pick、merge 都只在临时 worktree 内执行。 不要在主工作区直接做任何 upstream 分析或引入操作。

第 2 阶段：分析 upstream 变更

1. 在临时 worktree 中获取最新的 origin/main 和 upstream/main。

cd "${tmp_dir}"
git fetch origin main
git fetch upstream main

1. 计算当前 fork 与 upstream 的 merge-base。

base_commit="$(git merge-base origin/main upstream/main)"
echo "${base_commit}"

1. 列出 upstream-only commits，并按时间顺序和改动范围整理。

git log --reverse --no-merges --oneline "${base_commit}..upstream/main"
git diff --stat "${base_commit}..upstream/main"

1. 按“功能主题”分组候选变更。每组至少输出以下内容：

• 功能主题名
• 涉及 commit 列表
• 主要改动文件或目录
• 风险等级
• 与当前 fork 可能冲突的区域
• 是否推荐引入

1. 分析完成后，必须先向用户给出分组结果和建议。 在用户明确选择功能主题之前，不得直接合并全部 upstream，也不得提前进入实际引入步骤。

建议输出格式：

功能主题：<name>
commits：<sha1>, <sha2>, ...
范围：<files/dirs>
风险：低 / 中 / 高
冲突点：<areas>
建议：推荐引入 / 可选 / 暂不建议

第 3 阶段：选择性引入策略

默认粒度是“功能主题”，而不是“整支 upstream”。

1. 首选实现方式：按主题对应的 commit 序列执行 cherry-pick。

git cherry-pick <commit-a> <commit-b> <commit-c>

1. 如果某个主题跨多个零散 commit，但文件边界清晰，则退化为按文件或目录从 upstream/main 引入。