英雄图鉴
英雄图鉴将英雄所有权和局外等级转换为图鉴经验、全英雄永久属性及道具奖励。它与怪物图鉴不同：英雄需要手动激活，怪物依赖首次遇到事件。本页完整保留《英雄图鉴系统设计》的规则，包括接口与配置约束；目前取得的是设计来源，不能将其视为已经上线或批准的产品事实。
入口与激活
入口位于英雄界面阵容区左下角。只有已拥有且纳入图鉴的英雄能手动激活，每英雄只激活一次。激活同时完成：记录激活、发放该品质对应钻石、按该英雄当前完整局外等级计入经验。激活状态与钻石发放必须作为一次不可重复的操作处理；请求重试、双击、多设备不得重复发奖。碎片重复获取不增加激活次数。
未激活英雄即使已经升级也不贡献图鉴经验；激活时一次计入当前完整等级，之后局外升级持续增加贡献。未拥有不能激活；已激活不能再次触发首次钻石奖励。品质决定激活钻石值，但每品质具体数额需配置，不能从界面样例抄作正式数值。
图中锁定关卡、英雄等级、战力与 0/8 为布局示例，不构成本功能默认配置。
经验、上限与重算
图鉴总经验 = 所有已激活、纳入图鉴英雄的局外等级之和 × 全局经验系数。经验上限 = 本配置版本已发布且纳入图鉴英雄的局外等级上限之和 × 同一系数。来源“12 名英雄 × 30 级 = 360”用于说明计算，不能将 12 或 30 固化为规则。
经验是从英雄与激活事实推导的值，不是只靠事件累加的独立余额。登录、激活、英雄升级和配置变更后重算；增量仅用于动画和响应差值。缓存不能成为权威源。配置发布后隐藏但已存在的英雄仍保留在计算内；测试、临时和未发布英雄不计入，通过 counts_for_gallery 与发布状态控制。新增正式英雄只有在玩家激活后才增加其实际经验贡献，但配置上限随发布更新。
角色重置或降级若后续引入，不能收回已获得图鉴等级、永久属性和已领物品，也不能出现负经验展示；本设计不要求为了图鉴新增英雄降级功能。改变全局经验系数会影响经验和门槛，必须同时迁移，不能单改系数造成全体玩家等级异常。
图鉴等级与永久属性
初始图鉴等级 1，阈值为 0，不提供属性和物品。2 级起每级至少配置一项永久属性和一项物品奖励。等级自动取“累计经验达到的最高阈值等级”，不需要升级按钮；一次激活或升级可跨越多级。
升级与跨过的全部属性发放是同一个结果：失败不能只提升等级而漏属性，应保留可重试状态。多级提升合并成一次展示。等级段已得经验 = 总经验 − 当前等级累计阈值，下一等级段需求 = 下一等级累计阈值 − 当前等级累计阈值。达到配置最高等级显示 MAX，详情仍可看总经验与本版本经验上限。
属性作用于所有当前及未来英雄，进入已有账号永久加成的加法区，不新增一个乘法层。属性不作用于主角，因此不会间接增强主角元素卡伤害。生效后立即刷新英雄属性与相关战力。逐级记录已发属性等级集合，防止重复升级、重连或配置重载重复发放；图鉴永久属性与等级物品的领取状态分别记录。
等级物品领取
达到等级即解锁对应物品，玩家手动领取；未领不阻塞升级或永久属性。允许单领任一已达到且未领取等级，也允许一键领取。一键按等级升序逐级处理，某级失败后停止后续级并返回此前成功结果。每级奖励发放和 claimed 标记必须一致；重复提交只能返回已有结果，不能再次发奖。
旧账号首次启用时从图鉴 1 级开始，所有已拥有英雄处于“可激活但未激活”，显示激活红点；不自动激活，不自动补发首次奖励。玩家激活高等级英雄后可正常跨多级。重新登录以服务端状态恢复激活、等级、属性发放与物品领取，不凭本地动画完成状态推定成功。
红点
| 条件 | 位置 | 清除与保留 |
|---|---|---|
| 已拥有但未激活英雄 | 图鉴主入口、英雄页签、对应英雄 | 激活只清除该英雄；仍有其他可激活英雄时入口保留 |
| 已解锁未领取等级道具 | 图鉴主入口、图鉴等级页签 | 领取全部已解锁道具后才清除奖励红点 |
| 自动生效永久属性 | 无独立领取红点 | 不要求玩家点击领取属性 |
| 只增加经验但未升级 | 不新增奖励红点 | 既有未领道具红点仍保留 |
| 未获得英雄、未达到等级 | 无操作红点 | 达到可操作条件后再显示 |
入口是激活和领奖红点的并集，完成其中一种操作不应错误清空另一种。
主界面、排序与奖励页
主界面标题“图鉴”，问号打开配置文本说明，支持换行。显示当前图鉴等级及当前等级段经验/下级需求；永久属性汇总数值用绿色，每行最多 3 项，单项居中。奖励宝箱打开等级奖励页，提示下一个可领取等级。
英雄列表不展示英雄升级经验条。未拥有卡置灰、右上锁；已拥有未激活显示半透明遮罩、激活钻石图标/数量、“激活”和红点；已激活显示完整立绘、品质、元素、职业和局外等级。排序固定为品质红→金→紫→蓝，同品质按数值 HeroId 降序；不把已拥有、可激活、未拥有分成三个大段。激活和领奖不能导致卡片跳位。元素筛选默认全部；品质、元素和职业筛选均保持相同排序。英文语义 ID 不改名来实现排序。
等级奖励页标题“图鉴等级奖励”，纵向等级从下向上递增，左侧进度贯穿；每级物品横向默认约展示 2.5 项，可横向滚动。全局进度为总经验/版本经验上限。存在待领时默认定位最低可领取等级，否则定位最新达到等级。未达到显示普通图标、品质、数量；可领取显示高亮边框与光效；已领取加灰色遮罩和对勾。
两张界面图中的 41 级、2389/2400 等数字均为原型示例，正式值来自配置和玩家状态。
配置与持久化契约
| 数据 | 规则 |
|---|---|
| 图鉴等级配置 | level_id 唯一且永不复用，等级连续，累计经验阈值递增 |
| 属性奖励 | 类型、值、flat/percent_add、目标 all_heroes；2 级起不可为空 |
| 道具奖励 | item_id、count；2 级起不可为空 |
| 配置版本 | 与经验系数、英雄纳入范围、上限共同发布 |
| 已激活英雄集合 | 记录稳定数值 HeroId，不能使用名称作唯一键 |
| 玩家图鉴状态 | 图鉴等级、已发属性等级集合、已领道具等级集合、配置版本、缓存经验、永久属性 |
已发布等级的门槛、属性和物品不可原地修改；新增英雄或提高英雄上限时，通过追加等级扩展，保持已领取记录有效。版本经验上限必须覆盖最高等级阈值。需要追溯调整既有规则时应明确一次性迁移，不能无声改表让既有奖励重复发放或消失。
客户端激活只提交 HeroId，领取只提交目标等级或领取模式，不提交经验、图鉴等级或奖励结果。服务端校验所有权、纳入范围、当前局外等级、配置版本和既有领取状态，返回权威结果。首次激活钻石、自动等级属性、等级道具三条发放链有各自幂等身份，不可用一个“已领取”布尔值混用。
当前证据与缺口
本轮完整读取的飞书设计并没有随附上线证明。前端 origin/develop@7f0636c9 养成聚合器已确认的四个 Provider 为装备、符文、领地、英雄；怪物 Manual 奖励不提供属性。这些事实不能证明英雄图鉴的永久属性、激活接口、配置表或完整界面已接入。
需要确定：该设计启用版本；实际入口和服务端图鉴状态；品质激活钻石、全局系数、逐级阈值和奖励；已有账号首次启用迁移。没有在本次整理中自行决定这些产品数值，也没有把它们转成待执行开发任务。
现有测试入口与来源
尚未取得针对本套英雄图鉴设计的现有专项测试或 GUI 成功证据；不能借用怪物 Manual 的测试声称已覆盖。未新增或扩写测试。
来源为飞书 TDlxdsLH6oukyOxPyBqc6jaHn5f《英雄图鉴系统设计》完整正文、规则表和 3 张标注图（2026-10-13 获取，原审批状态未知），以及旧 character-hero 对英雄图鉴的待定边界。新页面统一承载规则，不要求读者再打开旧来源文档拼装。