Cooper OakandCooper-X-Oak
7797d1479a
Co-authored-by: Cooper-X-Oak <Cooper-X-Oak@users.noreply.github.com>
66 lines
2.4 KiB
Markdown
66 lines
2.4 KiB
Markdown
# Windows upstream PR workflow
|
|
|
|
## 目标
|
|
|
|
Windows 主线先在 `fork/dev` 完成发现、修复、CI、自审和复审，再收敛成明确 upstream 维护项。不要把未收敛的真机 findings 直接写到 upstream issues 或 upstream PR。
|
|
|
|
## 标准流程
|
|
|
|
1. 在 `fork/dev` 修复问题。
|
|
- 每个提交只解决一个明确问题。
|
|
- findings 先写到本地记录或 fork issue。
|
|
- 不向 upstream 新增噪声 issue。
|
|
|
|
2. 在 `fork/dev` 触发 CI。
|
|
- Windows build 必须过。
|
|
- 新增/修改的 Windows smoke 必须能在本机复跑。
|
|
- 真实凭据、物理热键、ASR、插入 fallback 等不能完全 CI 化的项目，要留下本机证据路径和日志摘要。
|
|
|
|
3. 在 fork 上开自有 PR。
|
|
- base: `fork/dev`
|
|
- head: 功能分支
|
|
- PR 描述使用中文，按模板填写。
|
|
- PR 必须包含 fork CI 链接、真机回归摘要、自审结论。
|
|
|
|
4. 复审 fork PR。
|
|
- 先按 code review 方式找阻断项。
|
|
- 修完 review findings 后再次跑 fork CI。
|
|
- 只有 fork PR 复审通过，才能进入 upstream 收敛。
|
|
|
|
5. 收敛 upstream 维护项。
|
|
- 从 fork PR 中拆出最小 upstream 维护切片。
|
|
- upstream PR 只包含已验证的最小改动。
|
|
- upstream PR 描述必须带 fork PR / fork CI 链接，说明该切片来自已验证的 `fork/dev` 工作流。
|
|
- upstream issue 只用于已经确认、可维护、可复现、需要 upstream 跟踪的问题；不要把探索期 findings 扔到 upstream。
|
|
|
|
## upstream PR 进入条件
|
|
|
|
- `fork/dev` 已包含修复。
|
|
- fork PR 已通过 CI。
|
|
- fork PR 已完成自审和复审。
|
|
- upstream 分支从最新 upstream base 切出。
|
|
- upstream diff 能独立解释，不依赖 fork/dev 的其他未提交上下文。
|
|
- PR 描述包含：
|
|
- 单一目标
|
|
- 不包含范围
|
|
- fork PR 链接
|
|
- fork CI 链接
|
|
- 本机 Windows 回归证据
|
|
|
|
## 禁止项
|
|
|
|
- 禁止从未验证的本地 finding 直接创建 upstream issue。
|
|
- 禁止绕过 fork/dev CI 直接推 upstream PR。
|
|
- 禁止把多个 Windows 真机问题混成一个 upstream PR。
|
|
- 禁止在 upstream PR 中提交真实服务凭据、用户本地配置、构建产物或临时目录。
|
|
|
|
## 当前执行规则
|
|
|
|
后续 Windows 主线默认顺序为：
|
|
|
|
```text
|
|
fork/dev 修复 -> fork/dev CI -> fork PR -> 自审/复审 -> upstream 最小 PR
|
|
```
|
|
|
|
如果 upstream PR 需要更新，先确认对应 fork PR 和 fork CI 证据，再同步 upstream PR。
|