用途:在保留本地定制(如系统提示词、自动化、记忆阈值等)的前提下,把上游 Boop 的更新合入自定义 fork,避免覆盖本地修改。
主要能力:在仓库内通过 Codex 运行 /upgrade-boop;预检工作区是否干净、补全 upstream 远程;在做任何改动前创建带时间戳的回滚分支和标签;按 Core(server/)、Integrations、UI(debug/)、Schema(convex/)、脚本/配置、文档等类别预览上游变更;让你选择 merge(默认)、cherry-pick、rebase 或中止;用 dry-run 预演冲突;合并后执行 npm install 与 npm run typecheck;解析 CHANGELOG.md 中的 [BREAKING] 条目,并可运行其中引用的迁移技能;最后输出回滚标签、新旧 HEAD、冲突列表和需补入 .env.local 的环境变量。
使用方式:在目标仓库中执行 /upgrade-boop。若缺少 upstream 远程,会询问并添加(默认 https://github.com/raroque/boop-agent.git),随后 git fetch upstream --prune,优先使用 upstream/main,否则 upstream/master。工作区不干净时(git status --porcelain 非空)会停止并要求先 commit 或 stash。安全网示例:git branch backup/pre-upgrade-$HASH-$TIMESTAMP、git tag pre-upgrade-$HASH-$TIMESTAMP。合并后回滚可用 git reset --hard pre-upgrade-<HASH>-<TIMESTAMP>。
适用场景:长期维护 Boop fork、希望安全跟进上游更新并保留自定义改动的开发者。
限制:不支持 dirty working tree;默认 MERGE,REBASE 仅在明确要求时提供;冲突时只解决冲突标记,不做额外重构;Convex schema 变更需下次运行 convex dev 才生效,需重启 npm run dev;.env.example 变更需手动比对并补入 .env.local;typecheck 若在合并差异之外报错会提示但不阻塞。