feat(equipment): persist mech loadouts and recover ejection safe case loot

Docs/Production/ImplementationPlan.md

@@ -4,7 +4,9 @@
 
 ## 工程起点
 
-tree1–tree3 的普通目录与资源副本已按 [资源初始化计划](TreeInitializationPlan.md) 完成，结果见 [初始化验收](../QA/Workspaces/Initialization.md)。三个目录暂为普通资源副本，未创建分支或注册 worktree。
+tree1–tree3 最初按 [资源初始化计划](TreeInitializationPlan.md) 建立普通资源副本，初始化阶段未创建分支或注册 worktree，结果见 [初始化验收](../QA/Workspaces/Initialization.md)。`tree1` 后续已在 `D:/vibeCoding/unityRouge/workTree/tree1` 注册独立工作区，分支为 `codex/models-weapons-equipment-animation`，用于玩家机甲模型、武器、动作与装备系统改善。
+
+2026-11-12 增补的[搜打撤装备系统扩展计划](EquipmentSystemPlan.md)梳理实物库存、携装出击、搜索换装、回收与损失、存档迁移及模型动作交接，按 E0–E7 分步实施。用户已确认实物可带出并再次携入，并增补[弹射式安全箱与多格库存计划](EjectionSafeCaseAndGridPlan.md)：机毁时安全箱自动返基地，任何放得下的未安装物品均可保全，箱外物品损失、机库库存保留；容器采用可旋转的二维网格。S1–S6 合入首个装备工作包，玩法设计已同步；当前原型已接入实物库存、安全箱与网格，按用户要求以 v2 新档开发。已测范围见[装备验证](../QA/Equipment/DataFoundation.md)。
 
 2026-11-12 增补的主页语言切换及全局双语工作按 [多语言实施计划](LocalizationPlan.md) 的 L1–L7 执行，完成后继续原有美术、实战与性能工作。
 
@@ -89,23 +91,23 @@ Unity 工具名已对照工程内插件源码核查。场景使用 manage_scene
 
 | 编号 | 依赖 | 工作与文件产出 | 完成条件 |
 | --- | --- | --- | --- |
-| 2.1 | 1.4 | Loot 下的物品定义、搜索交互、随身货仓和货物选择界面。固定样本为一张蓝图、合金和电芯。 | 搜索后可选取物资。随身 4 格、材料每组 10 个作为首测值。超出格数或堆叠上限时明确显示余量。 |
+| 2.1 | 1.4；二维扩展按 S1–S3 | Loot 下的物品定义、长宽与旋转、搜索交互、普通货仓/安全箱和货物选择界面。固定样本为蓝图、合金、电芯与多格装备。 | 搜索后可摆放物资。材料每堆最多 10 个；容量按边界、连续形状和重叠检查，超过堆叠上限或摆不下时明确说明。 |
 | 2.2 | 2.1 | Save 下的版本化存档，Runs 下的出击状态，一次性入库逻辑和基础机库库存页。 | 同一次货舱或整机结算重试两遍，机库只增加一次。写入失败时保留原状态，玩家可重试。 |
-| 2.3 | 2.2 | Extraction 下的货物回收舱，选择至多 2 格，原地按住 G 准备发射。 | 每次出击仅 1 舱。移动、松键或受击时可中断，舱与物资保留。成功升空时扣货、入库、标记舱已用一起保存。 |
+| 2.3 | 2.2；网格回收与安全箱按 S4 | Extraction 下的主动回收舱，按二维布局装舱，原地按住 G 准备发射；机毁另行触发安全箱自动弹射。 | 每次出击仅 1 次主动货舱发射。主动准备可中断并保留物资；成功后共同保存扣货、入库和已用。安全箱不占该次数，机毁按已保存的箱内归属保全。 |
 | 2.4 | 2.2 | 本区撤离点、接应倒计时、运输机占位体和主动登机交互。 | 任意任务进度均可到点呼叫，等待期间能移动作战。运输机到达后再次按 E 登机才结算。 |
 | 2.5 | 2.3、2.4 | WarzonePrototype.unity，含一项推进目标、搜索物、一个守卫和下一站出口。 | 完成目标开放出口。目标完成前可以搜物资、发射货舱或整机撤离。每次成功返航在基础机库库存页查看所得。 |
 | 2.6 | 2.5 | Windows 单战区构建，结算逻辑测试与实机操作记录。 | 跑完下方「关键结算验证」。重开游戏后，机库物资、舱使用状态、机毁损失符合记录。 |
 
-这一阶段的重点样例是「搜到蓝图 → 货舱送回 → 机甲被击毁 → 回机库看到蓝图，机上其余物资丢失」。
+这一阶段的重点样例是「主动货舱先送回蓝图 → 另一件装备放进安全箱 → 机甲被击毁 → 回机库看到蓝图与弹射保全装备，箱外其余物资丢失」。
 
 ## 3 · 配装与分支出击
 
 | 编号 | 依赖 | 工作与文件产出 | 完成条件 |
 | --- | --- | --- | --- |
 | 3.1 | 2.6 | Equipment 下的四槽装配、载重与额定功率检查，局内候选部件比较与替换。 | 替换推进器或防护模块，下一场立即体验到动作差异。装配超预算时能看见原因，三种底盘共用这套规则。 |
-| 3.2 | 3.1 | Hangar.unity、蓝图解锁、材料消耗与初始配装方案。 | 蓝图和材料来自实际回收。解锁后可在下次出击初装，开始新出击时重置当局装备、强化与货舱次数。 |
+| 3.2 | 3.1；实物库存按 E1–E4 扩展 | Hangar.unity、机库实物库存、蓝图研究、材料消耗与初始配装方案。 | 蓝图和材料来自实际回收，初始配装引用可用装备实例。成功带出的装备可再次携入，机毁保全安全箱、损失箱外物品；新出击保留机库库存与解锁，重置临时强化与货舱次数。 |
 | 3.3 | 3.2 | Runs 下的路线生成、节点情报、普通目标与中段终局分流。 | 地图公开任务与物资类别，具体战利品入场才发现。中段选首领或护送方向，任务完成后可继续搜再进下一站。 |
-| 3.4 | 3.3 | 战区切换与当前出击存档，三个普通战区布局及轮换任务。 | 进入下一站保留机体状态、当局装备、随身物资和已用货舱标记。每站都能呼叫整机撤离。 |
+| 3.4 | 3.3 | 战区切换与当前出击存档，三个普通战区布局及轮换任务。 | 进入下一站保留机体状态、当局装备、普通货仓与安全箱布局、已用主动货舱标记。每站都能呼叫整机撤离。 |
 
 ## 4 · 完整试玩版
 
@@ -123,24 +125,27 @@ Unity 工具名已对照工程内插件源码核查。场景使用 manage_scene
 | 数据 | 谁持有 | 何时保存或变化 |
 | --- | --- | --- |
 | 底盘、部件、战区定义 | Data 下的配置资产 | 制作阶段调整，以内容编号关联。 |
-| 永久解锁、机库材料和配装方案 | 玩家存档 | 解锁或成功回收时提交。 |
-| 出击编号、随机种子、当前节点、机体状态、当局装备和货仓 | 当前出击 | 出击开始、进入战区、成功回收、返航或机毁时提交对应状态。 |
+| 永久解锁、机库材料、装备实物和配装方案 | 玩家存档 | 解锁、制造、携装出击或成功回收时提交，保存唯一归属。 |
+| 出击编号、随机种子、当前节点、机体状态、当局装备、普通货仓和安全箱布局 | 当前出击 | 出击开始、合法流转/摆放、进入战区、成功回收、返航或机毁时提交对应状态。 |
 | 舱可用／准备中／已用 | 当前出击中的货舱记录 | 准备中锁住所选货物，成功发射后提交已用。加载一个发射前的完整快照时，从可重试状态恢复。 |
+| 安全箱携带中／已弹射／随整机返回，机毁待结算记录 | 当前出击 | 致命状态锁存后冻结库存输入；安全箱返库、箱外损失、弹射收据与出击结束共同提交。正常登机只回收一次，跨区不重置箱内容。 |
 | 接应未呼叫／等待中／可登机 | 当前战区 | E 呼叫后进入等待。可登机时玩家主动交互返航。进入下一战区后，由该区自己的撤离点接应。 |
 | 终局达成与物资返航 | 两类独立事件记录 | 首领或护送目标达成时记战果，登机时结算机上可回收物资。 |
 
-货舱和整机结算都先校验物资、机体状态与事件编号，在新快照中计算扣货与入库。写入成功后采用新状态并显示完成。损坏的临时文件从上一份完整备份恢复，相关流程用针对性的存档测试覆盖。
+主动货舱、整机回收和安全箱结算都先校验物资、布局、机体状态与事件编号，在新快照中计算归属转移。写入成功后采用新状态并显示完成，动画不发放库存。机毁写入失败时保持锁定并重试待结算记录；损坏文件从上一份完整备份恢复，相关流程用针对性的存档测试覆盖。
 
 ## 关键结算验证
 
 | 操作 | 预期结果 | 首次验收 |
 | --- | --- | --- |
-| 选择 3 张蓝图装入 2 格舱 | 可选择至多 2 张，第三张留在机甲上。 | 2.3 |
+| 将 1×3 物品装入 2×2 舱，或多件物品争用同一格 | 两个朝向均不适配或发生重叠时拒绝；不按物品件数替代几何校验。 | 2.3、S2/S4 |
 | 发射准备期间松键、移动或受击 | 原有物资仍在随身清单，货舱可再次使用。 | 2.3 |
-| 发射成功后机甲被击毁 | 已回收货物在机库，机上货物丢失。 | 2.6 |
+| 发射成功后机甲被击毁 | 已主动回收货物在机库，安全箱内容弹射保全，箱外机上货物损失。 | 2.6、S4 |
+| 安全箱放入未安装完整武器或模块，随后机毁 | 尺寸合法即可装入，箱内装备按原 UID 弹射入库，箱外装备损失，机库原库存保留。 | E4、S4 |
+| 已保存安全箱布局后跨区、正常撤离或待机毁结算重载 | 跨区保留摆放，正常撤离不再发放弹射收益，待机毁结算使用同一事件键完成一次。 | E4、S4/S6 |
 | 已用货舱后进入下一站，再打开货仓 | 舱保持已用，格位与机库物资正确。 | 3.4 |
 | 运输机到达但玩家尚未登机 | 玩家仍可操作，随身货物仍由机甲携带。 | 2.4 |
-| 已完成终局但尚未登机，随后机毁 | 终局战果保留，未送回的随身物资丢失。 | 4.1 |
+| 已完成终局但尚未登机，随后机毁 | 终局战果保留，安全箱物资保全，箱外未送回的随身物资丢失。 | 4.1、S4 |
 | 同一事件回调重复、保存后重开游戏 | 同一份货物只结算一次。货舱回收后还可正常结算整机返航。 | 2.6 |
 | 结算写入失败或临时快照损坏 | 可从有效状态恢复，背包、机库与结算标记相互一致。 | 2.6 |