SuperAPI AI 工具集

ngit-pr

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

本技能说明 Amethyst 仓库的两种贡献路径:GitHub 与 git-over-nostr。两种远端最终都汇入 GitHub main。GitHub 远端(github.com/vitorpamplona/amethyst)是权威主线,变动频繁;git-over-nostr 远端(nostr://…/relay.ngit.dev/amethyst)推送后会分发到 GitHub 与 GRASP 服务器并发布 nostr 事件,PR 作为提案在 gitworkshop.dev 上评审。

第一步用 git remote -v 按 URL 识别本地远端名,不要假设名称;示例中用 $GH_REMOTE 与 $NOSTR_REMOTE 代指。默认走 GitHub 路径,需 GitHub 远端且 gh auth status 正常,用 gh pr create/list/view/merge 完成创建、查看与合并;修订时向同一分支再推提交。nostr 路径需 nostr:// 远端且 ngit ≥ 2.5.0,用 ngit pr list/view 查看、推送 pr/ 前缀分支创建提案、ngit send --in-reply-to 发布新版本、ngit pr merge 合并。

关键限制是“三主对齐门”:GitHub main、nostr main 与本地 main 可能漂移,创建、修订、合并都要求提案基线与 nostr main 一致,且推送到 nostr 远端时 GitHub main 必须是祖先;不对齐时 ngit 会在预检阶段拒绝且不发布任何内容,应重新对齐而非使用 --force。推送、ngit send 与 ngit pr merge 因分发到中继和 GRASP 常超过 2 分钟,应在后台运行并轮询验证。ngit 使用签名密钥,维护者可用自己的密钥修订或合并他人提案。状态 applied 等同 merged,合并后需改写默认合并信息并清理临时分支。资料给出常见失败模式与修复方向,如基线与过期 nostr main 不一致需重基后重发、GitHub 与 nostr 分叉需维护者执行强制同步并先询问人工。其他未提及细节暂未提供。