用途：执行端到端用户验收测试，通过向 GitHub 或 Azure DevOps 的真实 PR 发布功能专属产物和综合演示，验证 Markdown 渲染输出。
主要能力：提供至少一组 --report/--instructions 配对（功能专属报告与测试说明），综合演示自动附加，无需手动作为 --report 传入。脚本会校验产物是否由当前分支代码生成，自动配置 GitHub/AzDO 认证，创建唯一 UAT 分支和 PR，将报告以“## Test Instructions”和“## Report”格式发布为 PR 评论，自动附加 artifacts/comprehensive-demo-simple-diff.md（GitHub）或 artifacts/comprehensive-demo.md（AzDO）作为最终回归测试评论，轮询审批（除非使用 --create-only），并在批准后清理 PR 与分支。
用法：推荐使用单一包装命令 scripts/uat-run.sh，可指定多个 --report 和 --instructions，支持 --platform github 限定平台，--create-only 仅创建不轮询，之后用 scripts/uat-run.sh --cleanup-last 清理。前置条件包括初始化子模块 git submodule update --init --recursive；GitHub 本地开发需 gh auth login，Azure DevOps 本地开发需设置 AZURE_DEVOPS_EXT_PAT；编码智能体环境自动使用 GH_UAT_TOKEN 或 AZDO_UAT_TOKEN。产物过期时运行 scripts/generate-demo-artifacts.sh 或 dotnet run 生成功能专属产物。
限制：不得发布最简或模拟产物，不得将综合演示作为 --report 传入，测试后必须关闭或放弃 UAT PR，UAT 期间不得修改源代码。常见问题包括产物过期、缺少报告/说明配对、令牌未设置、子模块未初始化、分支已存在等，均有对应处理方式。