request-pull 是什么
git request-pull 为基于 Git 地址的协作生成一段可直接发送的摘要：给定起点与仓库 URL，它列出区间内的提交、统计与差异概览，供收件人据此拉取与评审，常用于邮件列表、内网工单等没有 PR 系统的环境。它只是「生成说明」：不推送、不鉴权、不检查对方是否可达；地址对方访问不到，摘要就没有意义。
基本信息
| 语法 | git request-pull <起点> <仓库URL> [<端点>] |
|---|---|
| 输出 | 提交清单与 diffstat 的文本摘要 |
| 前提 | 对方可访问该仓库地址（本地路径或公网 URL） |
| 起点写法 | 分支、标签或提交，常用上游分支名 |
| 端点缺省 | 省略时默认取 HEAD |
| 不负责 | 不推送、不鉴权、不创建评审单 |
典型使用场景
- 邮件列表协作：内核风格流程里把摘要发帖，维护者按地址拉取
- 内网工单：把摘要贴进工单，留档提交流水
- 自建裸仓库：无平台评审时通知上游维护者来取
- 发布候选评审：正式推送前先发摘要让人预审
- 档案留痕：摘要存入发布记录，便于审计追踪
- 区间自查：用同一区间跑 log/diff，确认摘要内容无误
常用示例
常用示例
git request-pull origin/main https://git.example.com/team/repo.git feature/login # 生成摘要
git request-pull v1.4.0 /srv/git/repo.git release/1.4.1 # 以标签为起点生成
git log --oneline origin/main..feature/login | head # 自查摘要对应的提交区间
git diff --stat origin/main..feature/login # 自查摘要中的统计来源输出段落读法
| 段落 | 内容 | 用途 |
|---|---|---|
| 摘要头 | 仓库地址与分支、拉取说明 | 对方据此定位来源 |
| 提交清单 | 区间内提交逐条列出 | 浏览改动范围 |
| diffstat | 文件级增删统计 | 评估改动规模 |
| 告警信息 | 地址不可达或对象缺失时给出提示 | 判断摘要是否可用 |
平台化协作中较少直接用；在没有 PR 系统的环境（邮件列表、内网工单）仍然实用。
地址形态要按收件人视角选：本地路径只有对方能访问同一文件系统时才有用，跨机器协作给可达的 URL。
多分支仓库里显式写清要拉的分支（端点），避免对方按默认 HEAD 拉错。