- 使用 Node.js 22，在仓库根目录运行视觉测试。开发完成后按改动范围执行相关单例或目录，例如
node packages/vtable/scripts/visual-test.mjs --case list-basic或node packages/vtable/scripts/visual-test.mjs --dir pivot；影响多个模块时扩大测试范围。 - 提交 PR 前运行全量：
node packages/vtable/scripts/visual-test.mjs。检查报告中的基线、当前和差异图；执行错误或无法运行时如实说明，不把--self-compare当作官方基线通过，也不通过跳过断言或放宽阈值掩盖差异。 - 新增功能、修复 bug 或发现覆盖空缺时，可以新增有明确目的的确定性用例，或补强现有用例。新用例登记在
packages/vtable/__tests__/visual/cases/index.mjs；交互用例须执行真实动作并断言结果。新增或修改用例先运行单例--self-compare，再运行相关目录。 - 开发者或编码 Agent 独立新增的用例完全省略
BugServer case IDs行，不填写空值、占位或虚构 ID。由现有 BugServer case 迁移的用例保留真实来源 ID，合并来源时列出全部真实 ID。管理员手动创建 BugServer 用例成功后，再补写服务返回的真实 ID；本期没有同步脚本。 - 新增平台 case 遵循BugServer case 流程。只有对应项目管理员有新增权限；外部贡献者提供材料，由管理员代建。登录成功不代表可创建；禁止自行创建占位 ID。
- 环境准备、报告和清理见 视觉测试说明；目录与用例格式见 用例指南。本次任务启动的浏览器、服务和其他测试进程在结束时应停止。
- 提交 PR 前阅读贡献指南中的PR 检查与合入流程，按现有本地测试要求完成验证，并如实说明结果和未运行项。以贡献指南中的维护者启用说明为准，不将文档合入当作已开放。
- 处理 Bot 反馈时核对当前提交、比较基线和报告版本，不使用旧提交结果证明当前改动通过。
- 沿用上文的视觉差异验证要求，检查实际图像与相关源码，不通过替换基线掩盖问题。
- Photo 自动执行并展示原始结果，由维护者人工核查；report-only 不等于测试通过，也不授权自动更新标准图。
- 不自行批准或合入 PR，不修改 Bot 受管摘要或不可见追踪标记。需要维护者处理时，提供具体问题和证据入口。