﻿星坞船插集 0.26.1 本地读档修补包
制作日期：2026-11-13

一、目录说明
修复后：可供你手动替换的 Mod，以及最新存档和较早对照存档的完整修复副本。
原件备份：从游戏目录原样复制的 Mod 和存档，已逐文件核对 SHA-256。
技术资料：修补源代码、构建检查、185 项自动检查日志与存档校验结果。
这是非官方本地补丁；mod_info.json 的版本与 Mod ID 保持原样。

二、如何替换（由你手动操作）
请先完全退出游戏。只需把下面两个修复文件，复制覆盖到对应目标：

1. Mod JAR
来源：F:\yuanhangxinghao\233\星坞读档修复_20261113\修复后\mods\StarDockHullmods-0.26.1\jars\star_dock_hullmods.jar
目标：F:\yuanhangxinghao\Starsector\mods\StarDockHullmods-0.26.1\jars\star_dock_hullmods.jar

2. 最新存档（推荐使用，保存时间 2026-11-13 05:03:29）
来源：F:\yuanhangxinghao\233\星坞读档修复_20261113\修复后\saves\save_TAK_3779408497154523909\campaign.xml
目标：F:\yuanhangxinghao\Starsector\saves\save_TAK_3779408497154523909\campaign.xml

包中同时提供了完整文件夹副本，也可以合并覆盖对应同名文件夹。
不要删除或整体替换游戏的全部 mods / saves；只覆盖上述对应文件。
不要额外启用第二份相同 Mod ID 的星坞目录。
补充核对：游戏目录的星坞 JAR 当前已与本补丁一致；最新存档仍需对应替换。本轮未写入游戏原目录。
推荐继续游玩的最新进度是 save_TAK_3779408497154523909，不是旧的 save_TAK_2570566166554385669。
旧的 save_TAK_2570566166554385669 保存于 2026-11-13 04:27:00，仅作为可选对照副本保留。
此前先修旧档，是因为它是日志最后尝试载入的对象；这不代表它是最新档，也不代表错误最早从它开始。
两份修复副本必须各自对应同名原存档，不能将旧档内容覆盖到最新档文件夹。
如果你后来已有更新进度，先另外备份，不要把本副本覆盖到其他槽位。

三、本次改动
存档：两份副本分别仅移除 knownFighters 中两条 star_dock_vk_wasp_2_wing 记录，各 66 字节；其他字节与 descriptor.xml 均未改动。
Mod：保存前清理势力已知/优先战机名单中的合法星坞临时联队 ID；回收定义前同步清除名单引用。
通过原有 FactionAPI 删除引用，同时处理时间戳。清理失败时，回收流程保留定义及追踪信息。
不新增每帧全势力扫描，不改变战机数值、标签、舰船配置、其他插件逻辑。
JAR 只修改两个原有方法并新增一个清理类；其他方法和其他 JAR 条目均已核对未改变。
没有新增运行依赖，不需要安装额外补丁 Mod。

四、已完成的检查
原件备份已按制作时的原始 SHA-256 核对；后续安装状态单独记录在“交付校验.json”。
原/修复 campaign.xml 全量流式 XML 解析成功，除两条记录外逐字节一致。
185 项自动检查通过，包含实际补丁 JAR 的保存钩子、回收钩子、共享引用及异常保护。
Java -Xverify:all 通过；字节码仍为 Java 17，与原 Mod 一致。
自动检查的势力/舰船环境为测试替身，不等于实际游戏读档成功。

五、你替换后的验收
启动游戏，读取上述对应存档，确认能进入大地图。
测试临时机库相关功能、一次战斗及战后回收。
另存一个新槽位后完全退出，再启动读取该新存档；最好再保存、重启读取一次。
如仍报错，保留原件备份并提供最新 starsector.log，以便区分同一错误和后续其他错误。

六、回退
从“原件备份”将同名 JAR 和 campaign.xml 复制回游戏对应位置。
原件备份保留了修复前状态，因此回退也会恢复原先的失效引用。

限制
本次没有覆盖游戏原文件、没有启动游戏；由你自行替换后进行真实读档和战斗验证。
其他 Mod 更晚执行的保存钩子仍可能重新写入动态 ID，尚未通过真实冷启动验收确认。
本补丁处理此次读档错误，不代表解决此前大地图低帧率问题。
