用途：在运行 UAT 之前，用当前代码重新生成全部演示 Markdown 产物，避免 UAT 验证到过期输出，从而保证测试反映工具的真实行为。也适用于修改模板或渲染逻辑之后、更新 comprehensive demo 的 plan.json 之后，以及搭建新开发环境时。
主要能力：通过稳定封装脚本 scripts/generate-demo-artifacts.sh 一条命令完成构建、生成与校验。脚本以 Release 配置构建项目，在 /artifacts/ 下生成用于 UAT 的产物：comprehensive-demo.md（inline-diff 格式，供 Azure DevOps UAT）、comprehensive-demo-simple-diff.md（simple diff 格式，供 GitHub UAT）、role.md（带 principal 映射的角色分配）、role-default.md（不带 principal 映射的角色分配）；并在 examples/comprehensive-demo/ 下生成文档示例：report.md（默认模板）、report-with-sensitive.md（配合 --show-sensitive）、report-summary.md（summary 模板）。最后校验所有输出为有效 Markdown，并以清晰错误信息报告成功或失败。
使用方式：运行 scripts/generate-demo-artifacts.sh。必须使用该封装脚本，不要单独运行 dotnet 命令；应对该脚本一律放行，因为它只读取输入文件并写入产物，不涉及危险操作。不得修改输入文件 plan.json 或 demo-principals.json，也不得跳过对生成输出的校验。
限制：资料未提供脚本之外的自定义参数、平台要求或失败重试细节；除上述封装脚本用法外，暂无其他可用信息。