0.1.0-beta.2 · 融合架构重构

0.1.0-beta.2

TLMNotHard 第二个公开 Beta，面向 GTNH 2.9.0、Minecraft 1.7.10、Forge 10.13.4.1614（Java 25 运行时）。
本版聚焦工程源码分层、第三方适配解耦、公开扩展契约自包含与开发工具拆包，保留 0.1.0-beta.1 的既有存档 Schema、网络通道与消息编号、注册名及配置键。

本次内容

• 开发诊断工具独立拆包：原混入生产包的 /tlmnhdev 命令、客户端自动化控制、GPU 渲染探针、测试夹具与基准回放全部迁入 src/devtools、
  src/devtoolsTest 与 src/replay，单独构建为 tlmnhdevtools 附属模组，发布主包不再携带任何开发期类。
• 客户端与纯内核模块物理隔离：纯 Java 数学表达式解析器拆为独立 Gradle 子工程 :kernel:molang；266 个客户端源码文件与 19 个测试文件迁入
  src/client/java 与 src/clientTest/java，在编译期根除公共服务端代码误引客户端类型的风险。
• 第三方可选模组适配治理：16 个外部模组的公共与客户端适配代码迁入独立的 src/compat 与 src/compatClient 源集，经 CompatServices
  与 ClientCompatServices 在启动期通过 ServiceLoader 一次性绑定并冻结领域 SPI；核心业务不再直接依赖可选模组编译期 API 或散落反射。
• 公开扩展 API 自包含与构建门禁：com.tianluoqaq.tlmnh.api.behavior 移除全部 common.* 内部实现耦合，补齐纯值类型 MaidBehaviorGroup
  与手部租约/观测契约；构建约定与归档审查收敛至 build-logic 预编译插件，并新增 verifyArchitectureBoundaries 静态门禁守护源集依赖方向与开发开关单点读取。
• 既有玩法与内置资产完整保留：女仆核心交互、双手与六格背包、254 个内置模型选择、435 个配音与 10 个基础音效、神龛与魂符、女仆床、最小零食柜、
  GTNH 阶段配方以及 Enhanced 统一战斗与行为会话能力均与 0.1.0-beta.1 保持一致。

行为扩展 API 本版改用自持值类型。使用首个 Beta 行为接口的附属模组需要按本版接口重新编译。

安装与升级

1. 从本页 Assets 下载 tlmnh-0.1.0-beta.2.jar（普通游玩无需下载或安装开发专用 tlmnhdevtools），对照 SHA256SUMS.txt 校验 SHA-256。
2. 正常停止客户端和服务端，完整备份世界存档、两端 config/ 与旧版 tlmnh-0.1.0-beta.1.jar（或更早 TLM JAR）。
3. 将同一份 tlmnh-0.1.0-beta.2.jar 放入客户端与服务端的 mods/，将旧版 JAR 移出 mods/，再启动两端。

本版可直接读取 0.1.0-beta.1 存档与配置文件；新配置默认启用 enhanced 策略，已有显式 legacy_prototype 配置继续生效。
操作按键、服务端配置项与双端成对回滚步骤详见仓库 docs/USER_GUIDE.md 与 docs/USER_GUIDE.en.md。

已知问题与后续范围

• LEGACY-GROUND-001 待处理：Legacy 原型地面跟随用例在第 14 tick 触发位移平方小于 1 的既有守卫，本轮重构未改动 Legacy 决策算法，留待稳定版前专项修复。
• COMBAT-STATS-001 待处理：共有战斗统计工具协议与正式 seed/顺序采集绑定待补，统计比较结论尚未签署。
• 新增生存与装备适配（落水/坠落自救、太空供氧、纳米/量子护甲支持、背包内部容器免热锭灼烧）、真实饥饿机制与治愈之斧副手恢复/攻击适配将在后续版本实现。
• 带复杂 NBT 物品的真实客户端 Shift 转移，以及 0.1.0 正式稳定版发布前的跨模块组合、双端联机与玩家实机终验仍待完成。

验证记录

• 重构黄金契约基线（ReleaseCompatibilityContractTest）锁定 0.1.0-beta.1 的实体注册、方块/物品注册名、网络信道消息序号、TLMNH.Schema
  存档键、配置默认项与双 Mixin 清单，全程零漂移通过。
• 本次重构候选通过固定版本标准构建与 verifyArchitectureBoundaries 架构边界门禁，累计通过 514 项分源集单测（348 主逻辑、
  123 客户端、3 适配描述、32 开发附属、8 Molang 内核）及 97 项客户端 Gson 2.10.1 复检。
  本轮验证中 Molang 复用有效通过，其余五组检查均有实际执行记录；最终构建的执行与复用状态随发布记录提供。发布主包无任何开发探针或测试类泄露，
  全部字节码满足 major <= 52（Java 8）。
• 在专用 GTNH 2.9.0 测试根的独立 QA 副本中完成纯发布包独立服务端冷启动、客户端适配冻结后的双模型顶点/纹理/GL 与副手盾牌持握桥接实测，以及盾牌捕箭、
  Malisis 动画门通行、月球维度箭重力、缺失可选 API 无损封存保护（故障注入与健康盾牌分进程）、挂起与存档往返、低氧抢占物品返还、32 女仆战斗预算公平性共
  7 项核心机制原生回归；各批次提交与产物摘要详见 PROGRESS.md。

首次七项合并批次为 5 项通过、2 项失败，原报告保留。故障注入会保留熔断诊断，健康盾牌场景在新进程中验证通过。
旧门用例只读原版 metadata，在重构前后均触发相同守卫；本轮采用既有真实动画态门用例，102 tick 通过，旧失败未改签。

许可与来源

原创适配代码采用 GPL-3.0-only 许可，移植的上游代码、内置模型资产与音频继续遵循各自原有许可条款。
完整署名、来源摘要与许可证全文见仓库 THIRD_PARTY_NOTICES.md、SOURCE_PROVENANCE.md、licenses/ 及 JAR 内 META-INF/。

0.1.0-beta.1 · 首个公开测试版

0.1.0-beta.1

TLMNotHard 首个公开 Beta，目标环境为 GTNH 2.9.0、Minecraft 1.7.10、Forge 10.13.4.1614，游戏使用 Java 25。

本次内容

• 基于当前已集成的女仆交互、背包与双手、模型、配音、获取与复活、睡觉、零食柜和 GTNH 配方功能发布测试版本。
• Enhanced 统一战斗、已知箭威胁避险及第一部分工程收口成果。
• 第二部分行为会话组件化，包括扩展注册、生命周期、动作入口、故障隔离和受限命名空间存档。
• 完整保留已纳入的模型、贴图、动画、435 个配音及 10 个基础音效。原作者署名、来源清单和许可证随 JAR 提供。

安装

1. 从本页 Assets 下载 tlmnh-0.1.0-beta.1.jar，按 SHA256SUMS.txt 核对 SHA-256。
2. 正常停止客户端和服务端，备份完整世界、两端配置及旧 TLM JAR。
3. 将相同 JAR 放入两端的 mods/，将旧 TLM JAR 移出该目录，再启动两端。

新配置默认 Enhanced，已有显式 Legacy 设置继续生效。控制与配置见仓库 docs/USER_GUIDE.md 和英文版。
降级时应成对恢复旧 JAR、完整世界及配置，具体步骤见使用说明。

已知问题与后续范围

• LEGACY-GROUND-001 待处理。Legacy 地面跟随用例在两个相邻候选上均于第 14 tick 触发位移平方小于 1 的守卫，完整四项原生批次记录为 3 项通过、1 项失败。
• COMBAT-STATS-001 待处理。共有战斗统计预览 v3 尚待审查，正式协议和实际 seed/顺序采集绑定待补，统计结论尚未签署。
• 四项生存与装备适配、真实饥饿和治愈之斧仍待实现，包括落水/坠落自救、太空供氧、纳米/量子装备及热锭防护。
• 源码重构与硬编码、外部 NBT、复杂度治理将合并迭代。带 NBT 物品的真实 Shift 操作、最终候选的跨模块组合、双端兼容及玩家验收仍待完成。

验证记录

源码基线 d3f3efe 的第二部分候选已实际执行并通过 490 项主单测及 97 项客户端检查。
原生关联验证通过低氧抢占与物品返还、挂起/存档往返、短 32 实体配额三项，Legacy 守卫失败记录保留。
第一部分的已知箭、共有回放、双客户端和三轮持续负载证据绑定各自历史候选，详细记录见 PROGRESS.md。
本次 Beta 的构建与包内版本、字节码、资产和许可检查以随发布提供的构建记录为准。

许可与来源

原创适配代码使用 GPL-3.0-only，上游代码和资产继续遵循各自许可。
完整说明见仓库 THIRD_PARTY_NOTICES.md、SOURCE_PROVENANCE.md、licenses/ 及 JAR 内 META-INF/。
资源包保留原作者说明和声音条款，衍生分发应遵守各自署名、使用范围及报告要求。