英雄试炼
1. 功能范围
英雄试炼围绕一名活动指定、不可更换的英雄，按英雄等级分档提供免费奖励和单独购买的付费奖励。每档有独立商品与价格，购买一档不解锁其他档，也不等于购买整条通行证。
本文整合活动设计和前端已明确的产品决定，保留配置快照与实现差异；整理不将未定设计自动批准，也不代表全部领取和支付链路已经通过。
2. 入口、开放与前置条件
当前通过入口 52 打开英雄试炼，活动类型为 5。打开前检查活动模型与可见性；通用开放条件见活动开放与入口，不能用英雄等级条件代替活动本身的开放条件。
指定英雄达到对应档位的目标等级后，免费奖励才可手动领取；付费奖励也受该档等级条件限制。免费领取资格按服务端任务可领取状态判断，本地英雄等级与任务状态可能短暂不同，不能仅凭客户端等级推定服务端已经可领。
3. 玩家流程
- 从已开放入口进入，查看指定英雄、目标等级、各档免费与付费奖励，以及当前进度。
- 对可领免费档，点击奖励格或对应行的领取按钮。服务端成功后更新该档状态和奖励展示。
- 对可购买档，点击价格按钮发起该档商品购买。付费请求、收据与退款按充值与礼包处理，不使用免费任务领奖接口。
- 需要了解活动时打开说明层，点击区域外关闭；说明层不能遮挡必要购买操作。
源码虽存在领取全部的方法，现有资料未确认当前页面有对应节点，不能把“一键领取”写为已存在的玩家入口。
4. 业务规则与资源变化
免费档和付费档分别记录领取、购买状态。免费领取成功展示该档奖励；购买只影响对应商品档位，不跨档解锁。免费已领不等于付费已购，付费已购也不能据此推导免费奖励已领取。
每档当前界面区分未购买与已购买，但资料未明确活动换期后是否恢复购买资格、重复购买请求如何处理，以及具体限购计数口径；不能自行添加“每日一次”或“永久一次”等限制。
下列数值是前端资料快照，不是固定运营数值：
| 项目 | 快照值与解释 |
|---|---|
| 活动 ID / 活动类型 | 活动 ID 5，活动类型 5 |
| 指定英雄 | 英雄 2，不可由玩家更换 |
| 等级与档位 | 英雄等级 2–10，共 九档 |
| 免费奖励 | 每档 100 钻石 |
| 付费商品 | ActivityHero1 至 ActivityHero9 |
| 示例价格与折扣 | 1 USD，折扣 100 |
| 商品类型 | 9 表示英雄试炼商品，不是活动 ID；也不能因快照有九档而将两者混为一谈 |
列表按当前配置长度渲染，不固定预制六档或九档。实际商品价格、支付方式与奖励应按对应配置和支付结果理解；示例 USD 价格与界面价格按钮的钻石图标记录并存，实际对应关系见第 9 节待确认事项。
5. 状态、界面反馈与红点
档位与按钮
同一档按钮按以下顺序判定，越靠前优先级越高：未达等级 → 已购买 → 可领免费 → 可购买 → 免费已领且不可购买。
| 状态 | 表现 | 点击行为 |
|---|---|---|
| Locked | 无按钮底图、灰色描边、显示未解锁文案 | 提示等级未达 |
| Purchased | 灰色不透明按钮、已购买文案；不借整体 alpha 淡化遮蔽内容 | 仍响应并提示已购买 |
| Claim | 黄色领取按钮 | 领取免费档 |
| Price | 黄色价格按钮，按当前配置显示钻石图标及价格 | 发起该档商品购买 |
| Checked | 仅黄色勾选，无按钮底图 | 表示免费奖励已领且当前无可购买动作 |
免费奖励已领的格子灰态并打勾；付费已购买的格子灰态但不打勾。折扣值 100 表示原价，80 表示八折；仅不存在或不大于 0 时隐藏，不套用每日礼包“100 不显示”的规则。
档位文字展示目标英雄等级，不是档位序号。进度连接线上半段按当前档等级判断，下半段按下一档等级判断；第一档不画上半段，最后一档不画下半段，不能将全部线段套用同一个完成值。
立绘或 Spine 取首档所指英雄，缺资源时隐藏，不使用另一英雄占位。活动详情不可用时，每次打开只提示一次。
红点
| 环节 | 已知规则与边界 |
|---|---|
| 出现 | 按当前活动可领取状态产生；仅付费商品可购买不自动亮红点 |
| 清除 | 对应可领取状态不再成立后重算；资料未定义“打开页面即清除”，不能以打开替代领奖状态变化 |
| 刷新 | 依据活动详情、英雄或道具变化、领取结果、购买回执和跨期状态刷新；这些是共同刷新依据，不代表本页全部触发路径已经逐项运行确认 |
| 层级 | 入口及当前活动可领状态按现有 UI 层级聚合。旧设计的“试炼/草船借箭”底部页签和三层红点不对应当前页面；当前没有这些页签，不保留其入口红点规则 |
当前具体节点及全部刷新触发是否一致仍需核实，父子聚合语义见主界面、功能入口与红点。
6. 时间、重置与中断恢复
永久活动或结束时间占位值 9999 不展示虚构倒计时。活动开始、结束与循环按活动开放规则处理；本页现有资料没有明确英雄试炼的每日重置、换期进度继承、未领奖励补领或结束后购买资格，不能套用其他活动周期。
当前页面订阅 GiftPackDataChanged，购买回执后刷新按钮和商品状态，避免必须重新进入才变化。这一刷新事实不证明断线支付、后台补发、退款后的权益变化已经完整闭环；这些处理归充值与礼包，英雄试炼的最终显示一致性仍需对应证据。免费领取失败、重开页面和断线恢复的具体提示与请求顺序，资料也未完整定义。
7. 埋点与统计
埋点与数据分析未给英雄试炼曝光、进入、免费领奖或逐档购买的正式专属事件名与字段。通用活动曝光、奖励、过期等分析需求尚未形成明确 schema，不能自行补事件 ID，也不能据此断言当前没有采集。
共同定义中，hero_level 表示英雄升级，task 表示任务完成，item_change 表示物品数量变化；任务完成不同于领取奖励。这些语义可帮助区分等级进度与实际到账，但英雄试炼是否接入、任务与商品如何归因、双端上报如何去重尚待核实。角色身份、公共属性及权威资源变化口径沿用共同规范。
8. 配置、文案与关联规则
本功能配置决定活动身份、指定英雄、每档目标等级、免费奖励、付费商品、价格和折扣。渲染使用配置档位数量及首档英雄，不将上述快照数值固化为永久规则。
界面需要区分未解锁、已购买、领取、价格及勾选状态，并显示目标等级和活动说明；现有资料没有列出全部确切语言 key。开放和时间条件归活动开放与入口，支付、收据及退款归充值与礼包。
9. 当前实现、待确认差异与依据
已读到的前端实现与决定包括：入口及可见性检查、五态按钮、按配置长度渲染、奖励格与行按钮领取、首档英雄展示、详情缺失单次提示，以及 GiftPackDataChanged 后刷新。它们是静态来源事实，不表示本轮重新执行了 GUI 或后台链路测试。
仍需明确：全部红点节点和刷新路径；免费领奖失败与恢复；活动周期、限购及换期状态；快照中 USD 商品与钻石价格按钮的实际支付对应关系；付费、跨档、补发与退款后的完整结果。当前没有底部“试炼/草船借箭”页签；领取全部方法也不能作为“一键领取”按钮已接入的证据。
来源：飞书《活动》NFWHbfTsaocnXQxbDRvc1koDn6g 的英雄试炼规则与界面；frontend 7f0636c9 的 Docs/WorkPackages/HeroTrial/frontend-brief.md 全部有效产品决定与后续修正，以及活动、礼包源码。早期固定档数、旧按钮样式和明确被推翻的渲染方案不作为现行规则重复维护。
既有 GUI 用例和执行记录保留在前端 Docs/Testing/HeroTrialGuiTestCases.md、Docs/Testing/HeroTrialGuiTest-2026-10-15.md。它们是既有证据入口，不能推导全部付费、跨档和后台补发链路已通过。本次未运行、未新增或扩写测试。本地验证：根据项目策略禁止执行。