SuperAPI AI 工具集

upstream-fork-sync

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:为长期存在的 fork 建立定时同步自动化,避免反复重新实现本地定制,使本地改动能跨上游版本保留并自动保持可用。

主要能力:每次运行会克隆 fork 并拉取上游远端最新提交;把本地定制提交 rebase 到最新上游 HEAD 之上,在描述表明意图时冲突优先保留本地改动;运行验证命令,未提供时从构建系统推断(如 make test、npm test、pytest);成功后强制推送 rebase 后的分支并用新构建替换当前部署版本;失败则保留运行中的版本并报告冲突或失败检查。自动化幂等,上游无新提交时为空操作;强制推送仅针对 fork 工作分支,不涉及上游。

使用方式:需在 OpenHands Settings -> Secrets 中设置 GITHUB_PERSONAL_ACCESS_TOKEN(经典 PAT 需 repo 权限;细粒度 PAT 需 Contents 读写、Metadata 读)。可用 curl 调用 GitHub API 校验令牌。随后依次确认仓库(owner/repo)、上游远端(可选,默认 GitHub 父仓库)、本地改动描述(可选)、验证命令(可选)、同步计划(默认每晚 0 3 * * *)。再通过 POST $AUTOMATION_API_URL/v1/preset/prompt 创建自动化,确认返回 HTTP 201 并记录 ID。Windows PowerShell 等价片段见 references/windows.md。

适用场景:需要长期维护定制分支、希望自动跟随上游发布并保持可部署状态的项目。

限制:令牌缺失或无效时应停止并提示用户;rebase 冲突无法自动解决时运行安全失败,旧版本继续运行,需人工介入。其他细节暂未提供。