局外新手引导与成长路径
本页保留稳定功能 key guide-setting，范围收窄为局外引导；设置拆到系统设置，局内教学、演示关卡及特殊战斗机制归主线战斗流程。引导服务于真实功能操作，不独立替代领奖、抽卡、升级、装备或上阵的业务结果。
通用规则
主线进度、章节完成状态与界面条件共同决定引导。功能解锁动画先完成，再出现指引；连续的招募→上阵→挑战流程不应被其他弹窗随意打断。步骤可以等待指定界面出现/消失、上一步完成或业务事件，显示遮罩、指向目标的手指和对话；只有目标条件成立才推进，不能用固定延迟代替业务结果。
后端需记录已完成章节/步骤 ID，防止重复播放并为引导埋点去重；是否允许跳过、失败攻略是否只弹一次及最终触发关卡没有一致结论。
需要资源的步骤应在之前保证资源来源；奖励、升级和抽卡仍按所属功能请求处理，不因引导完成再发一次。完成/存档点用于重新进入后的续接；已完成章节不能重复触发一次性奖励。主线任务与新手强引导应指向一致目标。中断后的局内演示重播归战斗规则。
图中包括第N关开始/胜利/失败、第N张卡生成/准备、指定能量条件、打开大招选择界面、满能量未施放等触发设想。局外重点消费主界面/关卡完成及前章完成事件；这张配置菜单示意不证明每个候选事件都已接入当前引擎。
当前配置可确认的局外路线
frontend 7f0636c9 的 Assets/Configs/Runtime/GuideDataConfig.asset 登记 15 个启用章节。以下来自 Assets/ProjectMain/GameAssets/Configs/Guide/GuideChapter_*.asset 的真实步骤、主线限制字段与存档点。主线值是内部关卡 ID，不能直接当关卡序号；表中 起始/忽略 为 mainlineLevelLimit/mainlineLevelIgnoreLimit 原值。
| 章节 | 起始/忽略 | 完整局外操作顺序 | 存档步骤 |
|---|---|---|---|
| 1002 宝箱 | 1001/1002 | 100201 宝箱介绍→100202 领取宝箱→100203 关闭奖励界面 | 100202 |
| 1003 卡牌 | 1001/1002 | 100301 主角卡牌介绍→100302 卡牌入口→100303 火卡技能→100304 升级一次→100305 返回主界面战斗页 | 100304 |
| 1005 千抽 | 1002/1003 | 100501 千抽入口→100502 领取→100503 关闭奖励→100504 返回主界面 | 100502 |
| 1006 十连 | 1002/1003 | 100601 招募入口→100602 十连→100603 关闭抽卡结果→100604 返回 | 100602 |
| 1007 新英雄 | 1002/1003 | 100701 英雄入口→100702 升级/上阵介绍→100703 升级→100704 关闭升级展示→100705 返回列表→100706 上阵入口→100707 新英雄上阵→100708 保存 | 100703 |
| 1008 装备抽取 | 1003/1004 | 100801 商城入口→100802 抽一次装备→100803 关闭抽奖展示 | 100802 |
| 1009 装备养成 | 1003/1004 | 100901 主角→100902 选装备→100903 穿戴→100904 强化入口→100905 强化 | 100903 |
| 1010 宝石抽取 | 1004/1005 | 101001 商城介绍→101002 抽一次宝石→101003 关闭抽奖展示 | 101002 |
| 1011 宝石镶嵌 | 1004/1005 | 101101 主角→101102 宝石页签→101103 第一颗宝石→101104 镶嵌 | 101104 |
| 1012 挂机 | 1005/1006 | 101201 挂机入口→101202 领取挂机收益 | 101202 |
| 1013 领地 | 1006/1007 | 101301 领地入口→101302 点击物资→101303 搬运物资 | 101303 |
| 1014 排行 | 1007/1008 | 101401 排行入口→101402 进度奖励→101403 对话说明可领奖 | 空 |
| 1015 高级招募 | 1007/1008 | 101501 招募入口→101502 高级招募页签→101503 对话说明刷新/招募 | 空 |
这些局外章节的首步以 guide.custom.main.view.open 事件启动，再等待指定界面；例如宝箱结果等待 PanelGetRewards，新英雄等待 ViewHeroUp/PanelHeroUpShow/ViewHeroEquip，领地等待 ViewFiefMain/PanelFiefHaulerDispatch。多处步骤以 ViewGuideHandler 消失结束。存档点常在真正操作之后、展示关闭之前，不能把存档点当整章所有界面动作都已完成。1014/1015 无显式存档点的恢复表现仍待确认。
来源路线的合并与冲突
飞书“第一版”文件实际包含第一、第二、第三版工作表，三套顺序不一致。保留以下具体差异用于产品裁定，不把它们变成三条同时运行的路线。
| 主题 | 第一版 | 第二版 | 第三版 |
|---|---|---|---|
| 首次招募 | 第 1 关后 1002：入口→单抽→关动画→展示保底冰1→奖励→返回；100202 为完成点 | 第 1 关后 1002：入口→单抽→奖励→返回 | 1002 改宝箱，表写“1012 完成后”触发 |
| 首次上阵/卡牌 | 1002 后 1003：英雄→上阵→冰1→保存→确认→返回；100305 完成 | 1002 后 1003 同一路线，目标改火2，共六步 | 1003 改主角→卡牌→火1→升级→返回，也写“1012 后” |
| 第 2 关衔接 | 1004 点挑战→局内合成暴击/冰解锁 | 1004 局内火技能等 | 1003 后 1004 点挑战第 2 关，局内合成暴击 |
| 千抽 | 第 6 关后 1012：入口→首次领取，完成点在领取 | 第 3 关后 1005：入口→领取→奖励→返回 | 第 3 关后 1005 相同 |
| 十连 | 1007 后 1008：招募入口→十连，100802 完成 | 1007 后 1006：招募→十连→奖励→返回→英雄→冰1→升级 | 1007 后 1006：招募→十连→奖励→返回，升级拆入1007 |
| 英雄升级上阵 | 首次上阵路线已覆盖 | 1007 为第 3 关自动战斗教学 | 1007：英雄→冰1→升级→关展示→返列表→上阵→新英雄→保存；首步触发栏缺明确条件，中间704/705也缺完整条件 |
| 图鉴 | 第 3 关后 1007：入口→首个已解锁未领奖→关奖励→宝箱→奖励→返回；100704 完成，宝箱给 10 普通券 | 未列同一图鉴路线 | 以关卡宝箱1002取代，但无正式“取代”批注 |
| 抽装备 | 第一版第 5 关后1011写商城抽一次，但原文同时写符文区域，物品类型有歧义 | 第 3 关后1008：商城→抽装备→关闭 | 同第二版 |
| 穿戴/强化 | 第 2 关后1005：主角→首件装备→使用→强化→升级，100503 完成 | 1008 后1009同五步 | 同第二版 |
| 抽宝石/符文 | 首版未列独立明确路线 | 第 4 关后1010三步，但误用101101–101103，与1011重复 | 1010三步，编号修正101001–101003 |
| 镶嵌 | 第 4 关后1010：主角→符文页→首颗→镶嵌，101004完成 | 1010 后1011同四步 | 同第二版 |
| 挂机 | 历程表第 4 关开启，但强引导表未给独立路线 | 第 5 关后1012：挂机入口→领取 | 同第二版 |
| 卡牌升级 | 没有同编号局外路线 | 1012 后1013：主角→卡牌→火1→升级 | 前移1003，旧1013改领地 |
| 领地 | 第 7 关后1013：入口→首份物资→搬运，101303完成 | 第 6 关后1014同三步 | 第 6 关后1013同三步 |
| 排行 | 无 | 第 7 关后1015：入口→进度奖→说明可领奖，点击任意关闭 | 第 7 关后1014相同 |
| 高级招募 | 无 | 第 7 关后1016：招募→高级页→说明刷新/招募，任意点击关闭 | 第 7 关后1015相同 |
第一版对话 key 依路线为：单抽 guide010、英雄 guide011、上阵 guide012、装备 guide013、强化 guide014、图鉴 guide015、图鉴宝箱 guide016、十连 guide017、镶嵌 guide018、商城 guide019、千抽 guide020、领地/物资/搬运 guide021/022/023。这些旧 key 不能反推当前显示配置已经使用相同文案。
当前资产总体与第三版主题接近，但并非原样照搬：1002/1003 以主线1001及主界面事件触发，而非“1012 完成后”；1005/1006/1007 的主线字段同为1002；1010 已使用独立正确编号；1007 的缺失界面条件在资产中已具备。引导触发优先级、存档恢复和服务端进度同步还需实际观察。
新手特殊供给与失败回流
飞书特殊机制表将“首次普通单抽必得冰1、首次十连必得火1、首次图鉴宝箱给10张普通招募券”列为特殊安排。第二版上阵又写火2，第三版改为关卡宝箱，因此不能将旧英雄名和宝箱来源直接写死为当前正式配置；需与招募、英雄及关卡奖励实际表核对。教学战斗中的指定掉落、合成、技能和演示规则已归战斗功能页。
失败回流方案展示四个成长入口，顺序为英雄升级、招募、装备、符文；首个推荐项带手指，点击后跳转并关闭失败引导。来源有“首次有意失败从第3关推迟至第6关”的讨论，不足以证明当前有强制失败规则。历程表的累计 3/10/16/25/38/50 分钟（第1–6关）为节奏估计，不作为玩家必须达到的时间限制；第7关领地、第8关推进9、第9关回领2–3次三星奖励后推进10、第10关推进11也属于该版节奏方案。
来源与现有测试入口
| 来源 | 接收范围 |
|---|---|
旧 guide-setting.md | 一次性进度、界面/业务触发、解锁先于引导、中断与资源边界 |
飞书 FJeGbEw1FolSPfxCWQ4cNoQXn3e | 三版全部局外步骤/ID/完成节点、历程节奏、失败回流示意 |
飞书 Hu0bbdFcKoTuLNx5WHPc7VjRnee | 局外保底招募及宝箱供给；局内部分归战斗页 |
frontend Infrastructure/Guide/README.md | 条件、步骤、显示、完成与存档的产品语义；技术接入保留 frontend |
| frontend 上述 GuideDataConfig/GuideChapter 资产 | 现有章节及精确步骤/门槛/存档点 |
飞书阅读件采集于2026-10-13，真实在线版本与产品批准未知。没有把旧表冲突默认为已决策，也没有本次运行通过结论。现有 GUI 入口为新角色主线返回主界面后的相应引导，测试脚本须以已有项目目录为准；本次未新增或扩写测试。本地验证：根据项目策略禁止执行。