gh-stack Webhooks完全指南:pull_request的stacked新事件详解
gh-stack Webhooks完全指南pull_request的stacked新事件详解【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stackgh-stack 是 GitHub 堆叠式拉取请求Stacked PRs的官方配套 CLI 工具。本文面向新手详解 gh-stack 的 Webhooks 机制pull_request事件负载如何扩展出stack对象、全新的stacked事件在何时触发以及你如何用它打通 CI/CD 与通知工具。先用30秒看懂 Stacked PRs 是什么常规工作流里一个大改动只能PR1 合并完 → 再开 PR2地串行推进。而 Stacked PRs 允许多个 PR 上下叠放成一摞每个 PR 指向下方 PR 的分支形成链条同时每个 PR 都按指向主干分支如main来评估——分支保护规则和 CI 检查一个都不少。feat/frontend → PR #3指向 feat/api ← 顶层 feat/api → PR #2指向 feat/auth feat/auth → PR #1指向 main ← 底层 main主干分支上图的stack map堆叠导航图会出现在每个堆叠 PR 页面顶部点一下就能看到整摞 PR、各自状态并一键跳转任意层。而这套我在堆叠中的位置信息现在也能通过 Webhooks 以结构化数据拿到。pull_request 负载扩展stack 对象当一个拉取请求属于某个堆叠时GitHub 会在 Webhook 的pull_request事件负载中、pull_request对象内部附加一个stack属性。这让应用和集成工具不仅能看到 PR 的直接父分支还能检查整个堆叠的终极目标分支。stack对象会出现在该 PR 属于堆叠时的所有PR 生命周期事件opened、synchronize、closed等中对独立 PR不属于任何堆叠该字段为null。字段一览字段类型含义pull_request.stack.idinteger堆叠的全局标识符pull_request.stack.numberinteger堆叠编号仓库范围内与界面显示一致pull_request.stack.sizeinteger堆叠中 PR 总数pull_request.stack.positioninteger本 PR 在堆叠中的位置从 1 起1 为最底层pull_request.stack.base.refstring整个堆叠最终指向的分支如mainpull_request.stack.base.shastring堆叠基础分支的 HEAD SHA 最容易踩的坑pull_request.base.ref是 PR 的直接父分支堆叠里它下面那一层而pull_request.stack.base.ref是整个堆叠的终极目标。两者只有在堆叠最底层 PR 上才相同其余 PR 都不同。详解 stacked 新事件何时触发、负载长什么样一个自然的问题PR 是先创建、后加入堆叠的那怎么监听它成为堆叠一员的那一刻答案就是pull_request事件的新stackedaction——当一个拉取请求被加入堆叠时GitHub 会以action stacked投递pull_request事件。stacked 事件的三种触发场景实践中 PR 加入堆叠主要有三条路径都会触发stacked事件1️⃣创建第二个 PR 时勾选 Create stack——第一个 PR 照常创建之后创建下一个 PR 并勾选堆叠选项它即成为堆叠顶层2️⃣把已有 PR 加到现有堆叠顶部——在 stack map 中点击 Add to stack为新 PR 自动设置好基础分支3️⃣把已存在的 PR 链自动转成堆叠——多个已打开 PR 的分支首尾相接时页面会出现推荐横幅点击预览确认后即成堆叠3 分钟读懂 stacked 负载事件X-GitHub-Event头pull_requestActionstacked触发时机一个拉取请求被加入堆叠时stacked事件负载有一个关键特点除了pull_request内嵌的stack它还会把刚加入的堆叠以顶层stack对象的形式直接带出来。两个对象字段相同、取值始终一致读哪个都行。{ action: stacked, number: 42, stack: { id: 123456, number: 50, size: 5, position: 2, base: { ref: main, sha: def456... } }, pull_request: { number: 42, title: Add API routes, base: { ref: feat/auth-layer, sha: abc123... }, stack: { id: 123456, number: 50, size: 5, position: 2, base: { ref: main } } } }⚙️ 注意opened、synchronize等其他pull_requestaction 只在pull_request内部携带嵌套的stack顶层stack对象是stacked事件独有的。 实现建议监听器先判payload.pull_request.stack ! null确认属于堆叠再对action stacked做特殊处理——这是捕获刚加入堆叠这一时刻唯一可靠的信号非常适合发通知或记录堆叠成员变化。GitHub Actionsstack 自动识别零配置stack对象的收益不止于 Webhook 监听器。GitHub Actions 评估工作流触发条件时会自动采用堆叠的基础分支如果你的工作流配置为针对main的 pull_request 事件运行那么指向main的堆叠里每个 PR 都会触发它——无需改动任何工作流。你也可以在 workflow 表达式中通过github.event.pull_request.stack读取堆叠元数据- name: Show stack info if: github.event.pull_request.stack ! null run: | echo 堆叠目标分支: ${{ github.event.pull_request.stack.base.ref }} echo PR 位置: ${{ github.event.pull_request.stack.position }} / ${{ github.event.pull_request.stack.size }}省钱技巧CI 按需运行由于工作流对堆叠中每个 PR 都会跑大堆叠会成倍放大 CI 用量。用stack字段就能精准控制最底层未合并 PR条件stack.base.ref base.ref成立只有最底层直接指向堆叠基础分支顶层 PRposition size包含完整变更集适合跑端到端检查。- name: Run for the lowest unmerged PR in the stack if: github.event.pull_request.stack ! null github.event.pull_request.stack.base.ref github.event.pull_request.base.ref run: echo 仅对堆叠中最低的未合并 PR 运行 CI随着底层 PR 陆续合并最底层未合并 PR会自动下移——条件无需维护逻辑始终正确。边界提醒PR 离开堆叠之后堆叠成员关系不是永久的。既可以在界面上执行Unstack也可以用 CLI 命令gh stack unstack解除堆叠。解除后 PR 回归独立状态后续 Webhook 负载里的stack字段会重新变回null——所以监听器请务必先判存在、再读字段避免空指针。新手接入清单 ✅监听pull_request事件X-GitHub-Event: pull_request判读pull_request.stack非空 属于堆叠null 独立 PR对action stacked做专属分支处理可顺带读取顶层stack对象在 GitHub Actions 中直接用github.event.pull_request.stack.*做条件判断与 CI 优化需要按需补查时用 REST API 的GET /repos/{owner}/{repo}/pulls/{pull_number}获取同一个stack对象。 延伸阅读均为本仓库内的官方文档Webhooks 参考stack对象与stacked事件完整字段docs/src/content/docs/reference/webhooks.mdREST API 参考按需读取stack对象与 Stacks APIdocs/src/content/docs/reference/rest-api.mdGitHub 界面操作指南创建堆叠、推荐横幅与解除堆叠的图解docs/src/content/docs/guides/ui.mdFAQStacked PRs 的分支保护规则与 CI 行为详解docs/src/content/docs/faq.md【免费下载链接】gh-stackGitHub Stacked PRs项目地址: https://gitcode.com/GitHub_Trending/ghst/gh-stack创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

如何优雅地处理评审意见:Google Engineering Practices 中 CL 作者的代码评审沟通指南

如何优雅地处理评审意见:Google Engineering Practices 中 CL 作者的代码评审沟通指南

如何优雅地处理评审意见:Google Engineering Practices 中 CL 作者的代码评审沟通指南 【免费下载链接】eng-practices Googles Engineering Practices documentation 项目地址: https://gitcode.com/gh_mirrors/eng/eng-practices 当你的 CL(cha…

2026/10/15 10:08:28 阅读更多 →
GetQzonehistory:三步完成QQ空间数据导出,把全部历史说说永久保存下来

GetQzonehistory:三步完成QQ空间数据导出,把全部历史说说永久保存下来

GetQzonehistory:三步完成QQ空间数据导出,把全部历史说说永久保存下来 【免费下载链接】GetQzonehistory 获取QQ空间发布的历史说说 项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory 打开QQ空间翻到2016年,旧说说那…

2026/11/20 20:23:33 阅读更多 →
把 JSON 拖进去就能跑:ComfyUI-Workflows-ZHO 出图上手笔记

把 JSON 拖进去就能跑:ComfyUI-Workflows-ZHO 出图上手笔记

把 JSON 拖进去就能跑:ComfyUI-Workflows-ZHO 出图上手笔记 【免费下载链接】ComfyUI-Workflows-ZHO 我的 ComfyUI 工作流合集 | My ComfyUI workflows collection 项目地址: https://gitcode.com/GitHub_Trending/co/ComfyUI-Workflows-ZHO prompt 改了十几…

2026/11/15 13:08:02 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻