AIGame/Doc/Design/Combat/Runtime/Production.md

权威技能协议与正式战场接入

2026-10-21完成。独立火喵／岩团团样例已推广到正式战斗：十伙伴的普攻／主动技能及五敌人普攻，共25个技能；覆盖20主线关卡和5个属性挑战。8080本地开发服已更新，health返回combatProtocol=1；未发布Player或生产服。

版本与配置

• Config/Combat/skill_runtime_v1.json 是正式逻辑表，protocol=1、logicVersion=1，新战斗快照标记rulesVersion=3。原proposal保持design_only／runtimeEnabled=false，两个校验器分别报告设计和正式运行时状态，避免把旧设计文件当成正式入口。
• greenfield.json 保持battleRules=2，兼容旧客户端及旧挑战。新版客户端只在battle.begin／challenge.begin发送combatProtocol=1；没有该字段的旧客户端仍得到原规则。新客户端连接旧服务端时，也能接收旧规则战斗。
• CMake将正式技能表编入程序。开战原子保存原玩法配置、技能定义、gameplayHash、skillsHash、权威结果及完整事件轨迹；旧进行中战斗不会因新配置或程序重启重新计算。

逻辑内核

combat_slice 已由独立样例内核推广为共享纯数据内核，combat_runtime 从冻结玩法参数与正式技能表构造战斗。单位id为伙伴id或100+敌人槽；时间50ms整数tick、血量／攻击千分之一单位、位置毫米、倍率万分比。数值量化及前摇会改变新规则的节奏，不宣称与旧规则结果等价。

三波刷怪、多路前排阻挡／移动／漏怪、主动技能优先的单动作通道、前摇／释放／后摇、绝对冷却、投射物到达伤害、伤害／治疗／护盾／减速类型化行为、首领控制折扣、护盾和减速的刷新／过期均已接入。行为数组按actionId顺序执行；同cast／action／target不能重复命中。释放前死亡取消，释放后的火球独立存续，目标丢失不换目标，死亡和战斗结束只发一次。

开局预计算仍由服务端授权。battle.finish继续使用已冻结结果，忽略客户端won和elapsed字段；最早结算时间由readyAt约束，放弃／重试／首通奖励沿用原幂等事务。没有战中手动输入。

分页与恢复

操作	行为
battle.begin／challenge.begin	新客户端声明combatProtocol=1；返回snapshot和不含events的trace manifest
GET /game/state	返回原场次的traceId／traceHash／初态／终态摘要，供重连恢复
POST /game/command：battle.events	按本玩家pendingBattle、activityId、traceId鉴权；cursor与limit读取事件，limit≤256
battle.finish／abandon	原事务结算；关闭后删除活动轨迹，后续分页返回activity_missing

分页读取不修改日历、revision、钱包或operation log。每页返回原始JSON payload字符串及SHA256；客户端逐页校验、按原顺序拼接并核对整条traceHash，再开始播放。错误页、缺页、重复／乱序事件或不支持的版本不会回退成本地算伤害。请求可重试，持久化命令队列与分页读取分开。恢复当前实现从头重播原轨迹，沿用同一battleId及readyAt，不重新开战或发奖。

事件上限50000，正式内核最多2400tick。当前120组矩阵最大3626事件／299734字节（事件JSON），按需分页预载后开始播放；不是把全事件塞进每次存档响应。

客户端与表现

• CombatTrace.cs：协议DTO、版本／实体／事件顺序校验；PrototypeApi.LoadCombat：授权分页、哈希校验与有界重试。
• PrototypeBattle.Trace.cs：只读战斗模型。Tick只应用事件，不运行旧伤害／技能计算；血量、护盾、减速、死亡、漏怪、技能次数和统计都取服务器轨迹。
• PrototypeFlow：新旧战斗分支共存。新分支由同一时钟驱动动作、弹道、VFX／SFX与数据；低帧率仍消费全部数据事件，跳过过期一次性声音。结束、放弃、换页与禁用清理池。
• BattleSkillPresentation.prefab：5类特效、36个池实例、8个技能音源，复用已有5条TangoFlux音效和敌人反馈池。火焰伙伴有蓄力／发射／命中，其他投射物按元素着色；治疗／减速沿用现有标识。各伙伴更丰富的专属美术及余下4条计划音效未在本批补制。
• 15种角色的attackImpact读取各自原制作配方，分段采样原Attack以对齐逻辑释放点；零前摇护盾保持Idle并播放护盾。AnimationEvent不授权伤害。
• 战场持久化19个SkillMuzzle（10伙伴＋9敌人槽），局部-Z为前，随角色朝向和T2体型缩放，可在Prefab调节；不在运行时创建挂点／材质／粒子对象。BuildPrototype重建、后续敌人替换均保留此约定。

验证

• 三组CTest全部通过：原样例、旧事务／规则5192项断言、正式技能协议与120组关卡／进化／阵容矩阵（覆盖25技能，超过30万项事件断言）。涵盖治疗相邻路线、首领减速、复合行为、未来波次、确定性、分页只读、账号隔离、快照变化不重算、旧客户端、属性挑战及幂等奖励。
• 23份C++导出轨迹→C#只读模型，覆盖全部20关及3套T2终章阵容；最终血量、护盾、减速、位置、死亡／漏怪、统计完全一致，错误序列被拒绝。
• 真正EventSystem UI＋HTTP，18083专用数据库的1-5全T2六人阵容，1876事件。服务端进程重启后恢复相同battleId与traceHash，2×实播后最终状态与服务器奖励／统计一致；暂停、静音、火球、护盾、敌人攻击和结束清理通过。
• 最终Prefab挂点实播通过，T2火喵发射点与持久化挂点世界坐标一致；截图 Assets/Screenshots/battle_skills_anchors.png。完整UI截图 battle_skills_network.png。
• 真实账号与偏好已恢复。开发服更新前一致性SQLite备份及旧程序保留；重启后全部账号game_states与备份比较一致，包括已有冻结战斗。期间Windows旧进程文件锁曾延迟替换，确认进程完全退出后更新成功。部署回执 deployment.json。

矩阵用于验证执行、确定性和代表阵容可通关；首日实际解锁阵容的细致平衡、微信真机帧耗／内存、全部伙伴专属特效音效仍需后续验收。

入口

cmake --build AIServer/build-g1 --config Release --target aiserver combat_runtime_tests game_tests combat_slice_tests
ctest --test-dir AIServer/build-g1 -C Release --output-on-failure
AIServer/build-g1/Release/combat_runtime_tests.exe Doc/Design/Combat/Runtime/server_validation.json Tools/output/combat_runtime/traces
python Tools/validate_skill_runtime.py

Unity Pipeline：BuildBattleSkills.Build（制作／挂点）、VerifyBattleRuntime.Assets／Domain（检查）；实战测试使用专用18083账号，Begin→重启专用服务→ResumeAndFinish→Cleanup，勿对真实账号运行测试入口。开发服实际程序在AIServer/build/Release，运行中Windows会锁定exe；不要直接构建覆盖运行中的文件。新版本应先在其他输出目录验证，等待旧进程完全退出后替换。

后续完成：伙伴专属技能表现（2026-10-21）

上文记录的“专属特效／余四条音效待补”已完成：新增十种伙伴专属Prefab、四条TangoFlux音效，正式池现为15类／76根实例／8音源／9音效／10角色配置。治疗与减速也消费权威事件播放，真实轨迹23例、复用／去重／清理与正式战场截图通过。详见 ../PartnerSkills/Production.md。微信真机性能、内存与主观混音仍待验收。