用途：为老虎机/赌场游戏模式创建确定性的 book 包，供后端与回放系统消费，避免 schema 漂移。
主要能力：按模式定义契约（模式名、模式成本、事件文件路径、权重表路径）；确定性生成 books_<mode>.jsonl 或 .jsonl.zst，记录含 id、events、payoutMultiplier 等必需字段；生成 lookUpTable_<mode>_0.csv（列为 id、weight、payoutMultiplier）；组装 index.json，包含 modes[] 的 name、cost、events、weights；交付前做完整性校验，检查 ID 唯一性、权重覆盖、引用文件与 schema 必需字段。
使用方式：先锁定事件 schema 与 ID 策略，再批量生成；运行日志保留生成器种子与配置版本。校验命令：python3 scripts/check_books_package.py --index <path/to/index.json>；可选快速校验加 --max-rows 50000。输出契约包含 Mode Map、Integrity Findings、Patch Plan、Verification、Residual Risks。
适用场景：需要确定性、可复现的赌场游戏模式结果包与权重表的开发与发布流程。
限制：缺失文件、重复 ID 或 ID 不匹配视为发布阻断项；ID 需跨重跑保持稳定，除非有意升版本；index 引用应保持相对路径与产物本地化；schema/覆盖不匹配应快速失败，不得静默修补。具体收费、价格与平台支持暂未提供。