# 白皮书演示套件

七组场景分别在新的隔离世界中执行；同服多 Agent 场景的两个 Package 位于同一
世界。不会将七次独立演练拼成“同一服务器完整连续运行”的声明。

| 场景 | 可复现入口 | 展示与验收 |
| --- | --- | --- |
| 程序化育树技能 | `record-tree-skill.mjs` | 绿色生长粒子；程序化树网格连续长高、展开枝叶，双端验证同一树实体的生长进度 |
| 地形生长技能与更新 | `record-terrain-skill.mjs` | 同一技能从单个土丘更新为连续土墙；双端验证 0→1→4 笔刷及两个版本的施放特效 |
| Package 生成与在线更新 | `record-package-update.mjs` | V1 的 108 个构件保持原实体文档，V2 追加 24 个构件，两端持续在线 |
| 玩家脚下爆炸与同步 | `record-rehearsal.mjs --builtin-duel` | 普通玩家走位施放，命中脚边，地形挖洞、目标下落，两端特效及地形回执一致 |
| 程序化建筑 | `record-building.mjs` | 399 个构件逐批生成，两端呈现中间阶段及完整建筑 |
| 多 Agent 同服构建 | `record-multi-agent.mjs` | 两名作者的独立 Package 在同一世界里重叠施工，完成 108+106 个构件 |
| 版本生命周期 | `native_catalog_v2_two_client_e2e.mjs` | A1→B2→A3 回滚、关闭 CDN 后重连、服务器重启恢复、版本及持久状态一致 |

前六组为连续原生画面录制与时间对齐，第七组为严格测试的阶段截图回放，
不是连续实时录屏。Package 回滚恢复版本定义，不撤销已经提交的世界修改。
所有公开媒体应附倍率、证据和范围说明。

## 从头重录

```powershell
node scripts/authoring/record-demo-suite.mjs --bins target/whitepaper-recording-binaries --character-cache target/structural-collapse-evidence/host/authoring/characters/meshy-hero --fixture-test-bin <已编译且包含原生演练导出测试的shard_agent_e2e.exe> --ffmpeg C:/Python312/Lib/site-packages/imageio_ffmpeg/binaries/ffmpeg-win-x86_64-v7.1.exe --out target/new-complete-suite --dry-run
```

先检查输出的命令，然后去掉 `--dry-run`。路径按本机情况替换；必须使用新的
输出目录。入口依次执行六组录制，再创建本地叶证书、执行完整生命周期测试。
生命周期通过后，自动调用 `make-lifecycle-reel.mjs` 生成有阶段标签的回放。
需要已受信任的 mkcert CA（脚本不会安装 CA）、已有 Edge 依赖、兼容的客户端/
服务器/Package 工具和具备指定导出测试的测试可执行文件。没有付费生成调用。
录制和离线逐帧分析会占用较多磁盘空间与时间。

`suite.json` 保存每组完成/失败状态；失败会停止后续组。各组独立保留日志与
证据，不以外层进程成功代替内部核验。单组说明见
[育树技能](TREE_SKILL_RECORDING.md)、[地形技能](TERRAIN_SKILL_RECORDING.md)、[热更新](PACKAGE_UPDATE_RECORDING.md)、[爆炸录制](RECORDING_REHEARSAL.md)、
[建筑](CONSTRUCTION_RECORDING.md)、[多 Agent](MULTI_AGENT_RECORDING.md)。
生命周期的测试前提与阶段回放说明见 [PACKAGE_LIFECYCLE_RECORDING.md](PACKAGE_LIFECYCLE_RECORDING.md)。

本次发布复用前五组已核验演示，并新增绿色地形生长技能与程序化育树实跑；
各场景分别执行。批量总入口进行语法和参数预检，不为发布再次重复全部昂贵录制。
白皮书更新也不代表未覆盖的生产规模、长期运行、任意缓存损坏或原生 Codex
MCP 写入审批等其他验收条件已经通过。

## 实时 Jev 决策（独立选择运行）

第八组演示使用 `record-jev-agent.mjs`，详见 [JEV_AGENT_RECORDING.md](JEV_AGENT_RECORDING.md)。
它执行三次真实付费模型调用，展示等待、前进和种树；不会自动加入上面的七组总入口。
公开剪辑保持 1.0 倍速，并分别标出模型往返耗时和服务器终态回执耗时。