# Heroll 玩法与商业化开发包

本目录把样本实装、运行时观察与新项目建议拆开管理。开发时以 specs 下的规则表为配置与验收基线；原作商品目录只用于理解系统边界，不应直接照搬价格、商品 ID、文案或资源。

## 文件导航

- specs/economy-and-monetization-rules.csv：商业化总规则、配置键、埋点和验收条件。
- specs/feature-paywall-audit.csv：功能付费墙与玩家优势审计。
- specs/economy-resource-map.csv：资源来源、消耗、付费暴露与平衡目标。
- specs/analytics-events.csv：玩法、广告、购买与经济流水的最小埋点集合。
- ../../analysis/gameplay-monetization/tables/monetization-products.csv：样本声明的 397 条商品配置，供审计使用。
- ../../analysis/gameplay-monetization/tables/gacha-actions.csv：样本 23 种抽取动作与成本。
- ../../analysis/gameplay-monetization/tables/gameplay-commerce-callflow.csv：由 IL2CPP 元数据恢复的玩法/商业化类与方法入口。
- ../../docs/2026-08-13_gameplay-monetization-heroll-report.md：证据、结论、设计取舍及开发落地说明。

## 采用规则

1. 字段 actual_evidence 或 sample_implementation 描述 Heroll 样本，不等于推荐方案。
2. 字段 product_recommendation 或 launch_rule 才是新项目的默认实现。
3. 所有付费结算必须由服务端或平台回执确认，并使用幂等 transaction_id。
4. 付费、广告、随机抽取不得改变已生成但尚未向玩家揭示的骰子结果。
5. 若团队决定采用“高还原商业模型”，仍必须保留表格中的展示时机、频控、保底和可免费获取约束。