HEROLL/design/gameplay-validation/specs/README.md

HEROLL 玩法验证配置索引

本目录与 ../Heroll_Gameplay_Validation_GDD.md 共同构成玩法验证版唯一规范。编码 UTF-8；数组在 CSV 中使用竖线 | 分隔；布尔值使用 true/false；空值表示字段不适用，不表示待定。potions.csv 中 HEAL_LEVEL.value 是固定 HP，商店每级增加 30 HP；最大生命百分比恢复属于独立丹药强化。

关卡楼层、刷新与 Boss 压力以 专项逆向报告 及其 tables/ 为覆盖规范；旧版“每层固定两个有益地块”“六类事件保证袋”和“stage 0 启用 DiceGauge”均已失效。

文件	主键	用途	目标数量
evidence-map.csv	evidence_id	Evidence → Finding → Design 追溯	≥16
floor-balance.csv	floor	10 层敌方基础值与 Boss 基准	10
formula-fit.csv	gate_id	战斗/DDA 拟合门禁与补录矩阵	≥12
gear-catalog.csv	catalog_id	40 件局内装备外观目录	40
gear-status.csv	status_id	13 个装备属性生成规则	13
blessings.csv	blessing_id	31 源码祝福 + 第三骰	32
potions.csv	record_id	容量、治疗曲线与强化	40
shop-offers.csv	offer_id	96 源码商品 + 第三骰商品	97
events.csv	event_id	商人、核心六类和 12 地块	13
reward-boosts.csv	placement_id	8 事件增强 + 复活	9
data-contracts.csv	contract	TypeScript/CSV 映射	≥12
ui-screens.csv	screen_id	页面、控件与状态	≥20
assets.csv	asset_id	HEROLL 原型资产映射	≥20
animation-vfx.csv	event	动作、特效、音频时序	≥20
qa-cases.csv	case_id	自动化、调试台与现场验收	≥45

专项外部表：analysis/stage-floor-rules/tables/stage-boss-rules.csv、stage0-loop-enemy-stats.csv、enabled-tile-eligibility.csv、default-good-tile-deck.csv。

../diagrams/ 保存与主文档三个 Mermaid 代码块一致的独立可编辑源码：run-state.mmd、reward-transaction.mmd、checkpoint-recovery.mmd。结构验收结果见 ../VALIDATION_REPORT.md。

来源标签：SOURCE_CONFIRMED、RUNTIME_OBSERVED、BLACKBOX_FITTED、VALIDATION_ADDED。formula-fit.csv 中的 BLOCKED_CLEAN_CAPTURE 是显式发布门禁，不得改写为 PASS，除非保存了对应的无局外加成样本和误差报告。