Repository navigation
docs: document saved Photo selections and optional approval #599
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -58,23 +58,27 @@ pnpm run typecheck | |
|
|
||
| ### PR 状态与下一步 | ||
|
|
||
| | 摘要状态 | 应采取的行动 | | ||
| | ------------------------ | ---------------------------------------------------- | | ||
| | 等待执行/执行中 | 等待当前阶段,不把暂无结果当通过 | | ||
| | 存在待修复或待调查项 | 阅读问题,修复代码、补用例或提供可验证证据 | | ||
| | 流程受阻 | 查看具体待办;权限、服务或任务恢复问题交由维护者处理 | | ||
| | 等待人工批准 | 维护者核对当前版本的三项结果,并人工核查 Photo | | ||
| | 等待人工合入 | 当前提交的有效批准已识别,由维护者人工 Merge | | ||
| | 已合入/核对基准阶段 | 等待收尾;report-only 下跳过自动基准更新是预期行为 | | ||
| | 流程已完成 | 表示流程收尾,不改写原 Photo 差异或错误 | | ||
| | 被新版本替代/未合入关闭 | 前者查看新版本结果,后者不表示已合入或基准已更新 | | ||
|
|
||
| 推送新提交或 base 变化后重新核对版本并执行必要检查;旧结果不能证明新版本通过,新提交需要对应的有效批准。缺少摘要时先检查同仓、目标、创建时间、Draft和路径范围,再联系维护者。 | ||
| | 摘要状态 | 应采取的行动 | | ||
| | ------------------------ | --------------------------------------------------------------------- | | ||
| | 等待执行/执行中 | 等待当前阶段,不把暂无结果当通过 | | ||
| | 存在待修复或待调查项 | 阅读问题,修复代码、补用例或提供可验证证据 | | ||
| | 流程受阻 | 查看具体待办;权限、服务或任务恢复问题交由维护者处理 | | ||
| | 等待人工批准 | 维护者核对当前版本的三项结果,并人工核查 Photo | | ||
| | 等待人工合入 | 三项建议已完成,维护者核查 Photo 与可用保存修订后按仓库规则手动 Merge | | ||
| | 已合入/核对基准阶段 | 已启用图文选择时核对所选基准处理结果;未启用时仍跳过自动更新 | | ||
| | 流程已完成 | 表示流程收尾,不改写原 Photo 差异或错误 | | ||
| | 被新版本替代/未合入关闭 | 前者查看新版本结果,后者不表示已合入或基准已更新 | | ||
|
|
||
| 推送新提交或 base 变化后重新核对版本并执行必要检查;旧结果不能证明新版本通过,新提交须重新核对结果及可用的 Photo 保存修订。缺少摘要时先检查同仓、目标、创建时间、Draft和路径范围,再联系维护者。 | ||
|
|
||
| ### 批准、合入和异常恢复 | ||
|
|
||
| 工作流识别具有仓库 Maintain/Admin 权限的维护者对**当前提交**作出的有效 GitHub Approve,该批准同时表示已人工核查 Photo。Bot 不自动 Approve/Merge;GitHub 分支保护和其他检查仍适用,工作流不新增强制 Checks 或修改仓库规则。 | ||
| 工作流中的 GitHub Approve 仅作审计;维护者核对当前提交的 CR、单测、Playwright 和 Photo 后,可以直接手动 Merge。GitHub 分支保护或仓库评审要求仍然适用,Bot 不会修改这些规则,也不会代为 Approve 或 Merge。 | ||
|
|
||
| Photo 自动差异评估及标准图自动更新暂停。Approve/Merge 不授权自动采用测试图;提前合入不会使未完成或失败的检查变为通过。新增/修改共享基准需管理员另行获得明确授权、人工核查并安排复验,原报告保留。 | ||
| 对已明确启用图文选择的 PR,BugServer 展示当前版本的图片和短说明,新候选默认全选。维护者应逐项核查;需要保留旧基准的项目取消选择,并在合入前保存成功。以服务端显示的保存修订为准,未保存草稿不生效;已保存的人工选择不会被默认全选覆盖。 | ||
|
|
||
| 合入后只更新该修订已选的基准,未选项不变。写入前仍核对冻结提交、三项检查、实际合入内容、保存时间及原基准;旧版本、合入后补选或冲突不能自动补认。请求超时或部分成功时联系维护者按原任务恢复,不重新派发或更换请求 ID。 | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [P2] 为图文选择模式更新仍要求手工写入基准的指南 已启用图文选择的 PR 在合入前保存修订后,这里明确说工作流只更新所选基准;但同仓 已确认修复 (4019e28): 已复查原触发条件及从视觉指南和 PR 模板进入的调用路径:用例协作指南现把启用图文选择时的已保存修订更新,与未启用或无可用清单时的人工流程明确分开,并说明结果未知时不得另行手工重复写入;中英文模板和视觉指南也写明图文选择适用边界。原先会引导维护者对已自动处理的共享基准再走人工更新的无条件要求已消失。 |
||
|
|
||
| Photo 始终 report-only。没有可用选择清单(例如差异超过20项、解释未完成或执行错误)不新增合入门禁,也不自动更新基准。未启用图文选择的 PR 保持原模式。基准更新不会改写原 Photo 报告,流程 completed 不等于 Photo 全部通过。 | ||
|
|
||
| 请求帮助时提供 PR、当前 SHA、Review/CI 链接和可公开的错误说明。不要编辑 Bot 受管摘要或隐藏标记,不通过反复开关 PR、删除状态、换请求 ID 或另派批次绕过去重;由维护者回读和恢复原任务。结束时停止本次启动的测试服务、浏览器和子进程。 | ||
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
[P2] 同步可选批准后的状态与版本操作指引
对已启用图文选择、且仓库规则允许直接合入的 PR,这里允许维护者核查后不作 Approve 就 Merge;但同页状态表仍写“等待人工合入”须识别当前提交的有效批准,第 72 行仍写新提交需要有效批准,英文版也保留相同要求。维护者按状态表处理时会继续等待或请求一次不再必要的批准,也无法据此判断当前版本何时可合入。请为可选批准的 PR 明确状态与新提交处理方式,并同步两种语言的操作指引。
已确认修复 (4019e28): 已复查原触发条件:允许不作 GitHub Approve 而手动合入的流程下,中英文状态表的“等待人工合入”现均要求核对三项建议、Photo 和保存修订,不再要求识别当前提交的有效批准;两版新提交指引也改为重新核对当前结果与保存修订。原先会让维护者继续等待批准的文档冲突已消失,仓库评审规则的适用边界仍被保留。