Skip to main content

主角与队长技能卡养成

本页维护主角/队长入口中的元素技能展示、技能卡局外阶数、消耗和分支。战斗内发卡、拖拽与元素技能实际结算归战斗功能。来源使用“等级、品质、阶数”并不一致，当前数据以 CardId 和 Step 区分；不能把技能卡品质和局外阶数混为一个数值。

入口与技能分组​

底部主角/队长进入界面，再切技能页。早期 Demo 仅开放技能、其他页占位，但装备与符文已经有实现，因此“不开放所有其他页”已不适用于当前整体功能。

《队长界面》按火、冰、电三行，每行四个普通品质白、蓝、紫、金，并另有红色变异技能；按元素分行，行内按品质横向排列及滚动。卡片显示技能名称、阶数、元素、品质、技能书持有/所需及升级箭头，放大镜打开技能说明。《主角技能展示》另一版本仅要求火、电、冰三系各 4 等级展示，点击卡显示名称与描述，不提供养成。两份是阶段不同的方案，不能相加成“展示页与养成页都必须新建”。

队长技能列表：元素分行、阶数与元素角标、品质、碎片进度、升级箭头和说明入口

图中 6/8 阶、19/13 等值是原型示例，变异卡存在不代表当前全品类已经配置完成。

另一阶段的主角技能展示：主角左侧技能入口、三元素四卡列表与技能说明弹窗

此图只展示说明入口，不具有升级/分支流程；与上图的阶段差异已在正文保留，不据图新增第二套技能系统。

升阶、消耗与显示​

来源设计消耗本技能卡碎片/技能书及金币，按下一阶配置检查消耗、增长攻击系数和技能变化。卡片箭头及主角入口、技能页红点随着可升级状态实时变化。点击卡本身进入升级，点放大镜只看说明。碎片不足或碎片金币均不足时提示材料，只有金币不足时提示金币。

当前后端 CaptainSkillUpgrade 按 CardId 获取记录，不存在时创建 Step=1，再查下一阶配置；消耗 ItemCost 成功后更新 Step、保存并返回 Card 及物品变化。没有下一阶配置即报配置不存在，不应由客户端无限加阶。界面应使用服务端返回而不是先本地升级后假定成功。

升级弹窗：名称、品质、描述、碎片持有/需要、阶数与攻击前后对比、可选金币消耗

图示要求金币消耗配置为空时隐藏对应显示，不把所有升阶都固定收取金币；2000→2500、8→9 是示例。点击空白只关闭该弹窗。

配置逻辑字段为 CardId、品质/Level、Step、ATK 万分比、ItemCost、SkillId。旧示例 CardId=11、品质=1、Step=1/2/3、ATK=100/200/300、金币 50 加碎片 1/2/3、SkillId=100 只用于解释配置关系，非当前正式参数。材料的物品 ID、名称、图标、品质、展示、堆叠/使用限制及说明由物品配置维护，技能卡不另造一套库存。

分支​

早期设计每张技能卡可选 A/B 两个分支，按阶数解锁，当前使用分支有特效，已解锁未使用显示使用按钮，未解锁显示阶数要求。切换是否消耗来源未决定，不能自行指定免费或收费。

当前后端已有 CaptainSkillChooseBranch：只接受分支 1 或 2，技能卡必须存在、基础配置存在且 Step 不为 0，随后保存 SelectedBranch；所读路径没有扣切换费用，也没有按分支配置阶数阈值校验。故“分支协议存在”与“阶数解锁设计全部落地”不同。当前行为是无费用写入有效分支，是否符合最终产品规则待确认。

说明/升级/分支弹窗均可点空白关闭返回技能页。选择分支是否真正改变当前战斗 SkillId 或效果，需要沿前端分支消费点进一步核实，不能只凭 SelectedBranch 已存储声称战斗生效。

技能卡分支原型：两侧效果 A/B、卡片品质阶数及满级显示

该原型还展示攻击与生命，未证明当前技能卡同时赋予两项属性；正式贡献仍按当前配置和消费路径核对。

属性接入与当前证据​

前端 origin/develop@7f0636c9 中 CardSkillModel 消费 RoleInfo.CaptainSkill 与升级响应；养成快照通过 GetCardSkillAtkPercent 提供技能卡独立攻击系数，缺少配置时所读实现回到 10000（100%），CurrentStep 配置 SkillId 可替换对应技能。它不是全英雄攻击增益，不应把技能卡百分比混进装备或英雄等级贡献。

后端 origin/master@88b24abe 的 service/role/model/captain/captain.go 保存卡牌、阶数和所选分支；service/role/handler/captain/captain.go 提供升级和选择分支。旧稿“只有展示”“后端待接”不能代表这一提交。现行具体技能数量、红色变异规则、分支阶数门槛、分支战斗消费与当前战斗中 12 元素卡方案的对应仍需明确。

现有测试入口与来源​

后端已有 service/role/model/captain/captain_test.go、service/role/handler/captain/captain_test.go 与 gameconfig/captain/captain_test.go。本次未执行、未新增或扩写，也没有 GUI 通过证据。

正文整合旧 master-captain-card、飞书 UkcLsYaiDhrCVYtFam3cEUiKnXb《队长界面.xlsx》及 I5RqsC0orh97Pptfu6TcFujNn6F《主角技能展示》完整功能说明与图示含义（2026-10-13 获取，原审批未知），并结合前端当前养成梳理和上述服务端实现区分阶段差异。