Skip to content

docs: 补齐 PR 工作流与视觉测试协作指南 - #2155

Merged
xile611 merged 3 commits into
developfrom
codex/vrender-workflow-docs
Nov 11, 2026
Merged

xile611 merged 3 commits into
developfrom
codex/vrender-workflow-docs

Conversation

@Rui-Sun

@Rui-Sun Rui-Sun commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

对照 VChart/VTable 补齐开发者与 Agent 的完整协作入口:README、贡献指南、开发约定、PR 模板、Playwright 用例指南和 BugServer Photo 管理员协作说明。

  • 说明提交前检查、真实交互/业务断言、全量官方基线比较和负对照要求。
  • 补齐已启用范围与起点、各 PR 状态处理、当前提交有效批准、人工合入和异常恢复。
  • 明确 Photo report-only、流程完成不等于 Photo 全通过、不得自动更新基准或绕过去重。
  • 纯文档变更;未修改产品源码、测试、依赖、CI、服务配置或发布策略。

修正中文贡献指南文件名前导空格、常规 PR 目标 develop、错误项目链接及本机绝对路径;同步中英文指南和日文 README 入口。

验证:

  • 检查全部改动文件的相对链接/锚点:61 项,无缺失。
  • node packages/vrender/scripts/visual-test.mjs --list 成功,与指南的用例 ID 和覆盖范围一致。
  • 核对 package scripts、CI job/step、用例导出接口及当前部署快照;git diff --check 通过。
  • 提交 commitlint 通过;pre-push 产品单测因独立工作区未安装产品依赖而报 Link flag invalid,本次纯文档推送临时跳过 hook。

未运行产品构建、单测、覆盖率、浏览器/视觉比较或手动模型/Photo 批次,原因是此次仅修改文档。提交后既有 CI 和自动工作流照常执行,结果以其当前版本报告为准。正式启用快照不代表首条自然 PR 或 24 小时/3 次执行观察已完成。

VisActor 工作流(CN):completed

当前提交:ac8cd8859d83dabb023a22c009f8f43cdff16f31

三项检查建议与 BugServer 人工确认

2026-11-10 修复与实际复验

  • 两种 PR 模板均改用绝对 GitHub 文件链接,避免复制到 PR 描述后相对路径失效。
  • 同步最新 develop;当前 head ac8cd8859d83dabb023a22c009f8f43cdff16f31、base 5579b02ccaa542bed7a188ae138c99ed2ad72b31。合成 merge 7b899b047da15a8692f041b4b6d6309bdef4a1c8 的两个父提交严格匹配,未放宽门禁。
  • 原依赖失败为官方包下载 socket 超时;当前官方源复验 SHA512 一致,两侧实际隔离安装成功,下载审计无错误。未修改源、超时、资源或完整性规则。
  • 当前版本 CR 无待处理问题;单测 CI通过;Playwright 全量 6/6 匹配、零差异/执行错误。Photo 原始结果 2350/2350 通过。
  • 工作流已进入等待人工批准;Photo 仍为 report-only,不自动批准、合入或更新基准。此前未跑产品测试的说明仅指最初纯文档提交时的本地验证,本节记录后续真实工作流结果。

@visactor-review-bot

visactor-review-bot Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

VisActor 工作流

结论:流程已完成。
当前提交:ac8cd88;比较基线:5579b02。
环境:CN;更新时间:2026-11-11T02:06:27.939Z。

检查项 状态 关键结果
CR ✅ passed 待处理 0;接受风险 0 查看结果
单测 ✅ passed 必要单测 job 必须实际执行并成功 查看结果
Playwright ✅ passed 截图 6;匹配 6;差异 0(已解释 0);错误 0
Photo(原 BugServer / UNIC) ✅ passed 用例 2327;截图 2350;匹配 2350;差异 0(已解释 0);错误 0

Photo 独立报告:流程完成不代表 Photo 通过。 Photo 自动执行并展示原始结果;差异解释仅作非阻断建议,强制门禁和标准图更新保持关闭,需管理员人工核查。

已人工合入;Photo 自动标准图更新已暂停,未满足的合入前条件不会由事后批准追认。
Bot 仅提供 CR、单测、Playwright 三项检查建议,不强制阻止合入。

Photo 执行明细

Photo 原始执行:completed;结果:passed;缺少基准 0;等待 0;运行中 0;不完整 0;创建未知 0。

Photo 差异解释(非阻断建议)

差异共 0 项;已逐项分析 0 项;未分析 0 项。
分析状态:全部差异已分析。以标准图为认可效果;仅解释差异和可能原因,不判断可接受、不建议更新基准。结论仅适用于下列已分析任务,不代表其余差异已验证,不改变 Photo 原始结果。

图片差异解释(0 项)

暂无已解释差异。

合入后 Photo 基准更新清单

自动标准图更新已暂停。

版本与合入后状态

当前提交:ac8cd8859d83dabb023a22c009f8f43cdff16f31;比较基线:5579b02ccaa542bed7a188ae138c99ed2ad72b31。

合入后状态:skipped。

CN 结果仅证明上述实际范围;完整报告和原始差异继续保留。

@visactor-review-bot visactor-review-bot Bot left a comment •

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

最新复查提交: ac8cd88

未发现可确认的新问题。

@xile611
xile611 merged commit 8278cc3 into develop Nov 11, 2026
12 checks passed
@xile611
xile611 deleted the codex/vrender-workflow-docs branch November 11, 2026 02:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants