FTB 跨版本记录

2026-11-08 master：存档自管数据统一目录（1.21.1 待同步）

存档外部文件统一位于 system/，玩家业务为 players/<UUID>.dat，对话为 chat/<UUID>.dat，共享和私有数据库为 database/shared.dat 与 database/players/<UUID>.dat；全部改用 FileAccess.NBT_COMPRESSED GZIP 压缩存取。移植时一起同步 AssistantServer 的根目录、FileAgentStore 的读写 / 枚举 / 删除、AgentDatabases 的文件名、AgentDatabase 的 NbtOps / 严格加载、AtomicFiles 及日志 NBT 计量。data/system 下的用量和 AI 权限 SavedData 不改，客户端配置和语音文件不改；按用户要求不迁移或删除旧目录。master 编译通过，未启动游戏验证。

2026-11-06 卡片节点和字符串按钮重构（master，待向其他分支移植）

本节替代下文旧 CardGrid / 专用业务节点的结构。正式节点改为 18 种并按功能分包，任务、商店、抽奖使用通用 GridNode + GroupsNode / FlexNode；CardPagination 是唯一分页组件，CardUiState 替代 CardPageState。任务列表保留结果内章节分组、原始编号、三行固定区域和返回状态；pin 用普通 button + QuestCardBindings 构建事件，DisplayCardCache 维护实时状态。不要再移植已删除的 GroupedActionsNode / OfferGridNode / PrizeGridNode / QuestPinNode。

按钮统一 click/value，return-val 只传 CardReference 和字符串；服务端先发布 CardButtonEvent，未处理时经 CardEventValue 解析进入既有 ModuleRouting.button。URL 由原版打开流程处理，local 仍用代码绑定 callback。移植时一并同步公共 CardAction / 请求 StreamCodec、服务端事件与解析器、客户端控制器、全部能力接口及节点、27 份 JSON、图钉 SVG、CSS、离线编辑器和文档；仅复制模板会导致解析失败。网络协议号维持 1，双端须使用一致构建。详见 cards.md。

2026-11-06 master：共用三行分页网格（1.21.1 待同步）

本节替代下文旧版“每页 10 项”的任务布局约定。新增客户端 CardPagination 与 CardGrid，原 ActionsNode 分页移入前者，后者同时控制列数、三行固定区域及 列数 × max_row 容量；GroupedActionsNode / OfferGridNode / PrizeGridNode 共用，默认完整模式 18 项、通知 9 项。少量、空列表和最后一页保留区域及分页按钮，单页双按钮置灰；只有当前页创建 DOM、图标与 tooltip。保留原始业务下标、CardPageState、通知详情返回与完成通知语义。

移植时同步两个共享类、四个节点、quest_list.json、共享 CSS（移除旧网格 max-height 裁切与通知列数覆盖）、文档及测试任务说明。三个网格节点将 CardGrid.CODEC 合并为扁平 fields，任务模板使用 max_row: 3 取代 page_size: 10；商店、抽奖的既有 max_row 从限高滚动改为分页。不得只复制 JSON/CSS，否则布局列数与分页容量会不一致。不新增注册表、依赖或网络数据格式；编译通过，尚未游戏内验收。

2026-11-05 master：任务列表分组浏览（1.21.1 待同步）

QuestBriefOutput 在原章节名称外补充 chapterId、groupId、group 名称；FtbQuestAccess.brief 仅从每个命中任务的 getChapter().getGroup() 读取这些元数据，不单独枚举全部章节或章节组。已核对 26.1.2.8 源码：Chapter.getGroup 返回 ChapterGroup，默认组使用 isDefaultGroup，不额外显示书名；正常查询的 getAllChapters 顺序是章节组顺序再章节顺序。

QuestList 为按钮写入分组参数；客户端新增正式节点 system:grouped_actions，左侧列出结果中的非空章节及所属上级分组，右侧复用商店货架结构显示任务，复用 ActionsNode 每页 10 项的本地分页。CardPageState 增加选中章节，页码按章节键保存，PUSH / 返回保留原位置；全局任务编号和服务端列表快照不变。多项解锁共用该模板，完成通知和单项解锁逻辑不变。

2026-11-06 布局修正也需一起移植：左栏用自然高度的内容容器，超出上限才滚动且不保留 gutter；右侧采用真正的 offer_grid > offer_cell > offer_cell_label，完整模式 6 列、104px 格子，HUD 3 列。移除右侧重复的章节名与条目数，货架直接顶到内容区顶部，章节信息只留在左栏。GroupedActionsNode 新增 columns / cell / children，通过通用节点把标题、编号和进度分块渲染；ActionsNode 将行渲染与分页分离并共用动作绑定。quest_list 顶层 title 把“任务列表”单独显示，提示改为短行，长摘要只留在数据与播报路径中。

同日补充居中与任务图标：QuestList 为动作写入 action_quest_id；新增 system:quest_icon / QuestIconNode 与公开注册字段，通过反射调用 FtbQuestIconElement.createQuest，复用现有原生绘制和 tooltip。客户端先检查 ClientQuestFile.exists，再按 ID 取 Quest.getIcon；26.1.2.8 的该方法优先配置的 rawIcon，然后主题，最后目标默认图标。未安装 FTB 或任务不可用时省略图标。模板加入 32px 图标，把编号 / 进度合为一行；共享 CSS 对标题及格式化内部行块显式居中。移植时同步新节点、注册、适配器、动作参数、JSON 和 CSS，不需要扩展 QuestBriefOutput 或改网络协议。

移植需同步公共 DTO / Codec、FTB brief 构建、QuestList、GroupedActionsNode 和注册、ActionsNode 的共享分页入口、CardPageState、quest_list.json、共享 CSS 与双语键；不能只复制资源文件。没有新增依赖、网络请求或任务进度操作。已执行 compileJava / processResources；未启动 Minecraft 或做功能验收。

2026-11-06 另补左栏零范围滚动防护：AUI 1.2.9 的 MouseEvent 在路径没有真实滚动范围时，仍会选中 overflow:auto 元素，ScrollModel 随后产生弹性位移。GroupedActionsNode 在初始化后的左栏注册内部 wheel 监听，仅当路径中没有实际滚动范围时 preventDefault；保留长章节列表和外层聊天滚动，Shift 滚轮也考虑横向范围。移植时核对目标 AUI 的事件与范围 API；不只复制 overflow:auto 样式，也不要在布局回调中查询 scrollLimit。

同日补任务格子的图钉与底边进度条：新增客户端节点 QuestPinNode / ProgressNode 及 SystemCardNodeTypes 公开注册项；quest_list.json 把百分比文字改为进度条、编号保留，右上角增加图钉。此处旧版曾使用连接内 QuestPinCache；当前版本已改为服务端 DisplayCardsDataStorage，见本文末的常驻卡片记录。移植时仍需核对 AUI Document.getAll、SVG 与事件 API，并同步两个新节点、网络注册、JSON、共享 CSS 与双语键。不改变 FTB 进度、DTO 或提交协议。

图钉后续修正需一并同步：共享 CSS 默认将 SVG 倾斜 35°，aria-pressed=true 后旋转归零；22px 按钮 / 16px 图标，透明且无外框，高于 AUI 主题的按钮状态选择器优先级，避免主题最小高度及选中背景撑出色块。QuestOutput.buildCard 增加已有 id 的上下文参数，quest.json 加 quest_detail_card 样式和 quest_pin 节点，详情与列表共用固定列表，不新增序列化字段。

记录日期：2026-10-30。1.21.1 的功能修改已同步至 Minecraft 26.1.2 / master。来源为 b601fd7..03ca46a；先切换 master，再执行 git pull --ff-only，目标从 2c459f9 更新至 b6afc9d 后才合入修改。此次不提交、不推送。

来源与范围

1.21.1 开发依赖为 Quests 2101.1.37、Library 2101.1.39、Teams 2101.1.11。最初问题来自用户整合包 D:\PrismLauncher\instances\『化龍』导入包-1.4\minecraft：其 Quests / Library / Teams 为 2101.1.34 / 2101.1.35 / 2101.1.10，现有日志加载 24 个章节、837 个任务和两种语言。只读取了定义、依赖与日志，没有修改整合包或存档。

例如 359B897165997027（“鸣谢名单”）为勾选目标、物品与 100 经验组合，暴露了旧礼包分类只接受物品奖励的问题。标题问题则来自服务端共享回退语言，不能用直接 getTitle 替代玩家语言解析。

只迁移功能，不带入 1.21.1 的版本降级、嵌入式 Saturn、兼容 ItemStackTemplate 或导入整理。目标保留 Java 25、NeoForge 26.1.2.114、AUI 1.2.6、外部 Saturn，以及 Quests / Library / Teams 26.1.2.8 / 26.1.2.9 / 26.1.2.4。保留拉取后已有的通知立即替换、手动切换和任务完成勾叉展示。

已同步功能

功能	实现入口与行为
玩家语言与格式文本	FtbQuestText 按玩家语言调用 TranslationManager，保留缺译回退；覆盖列表、搜索、章节、详情、提交、通知和播报。无标题任务递归取首个目标标题，Component / § / & 统一处理，不修改共享 locale 或 title cache。
勾选任务与礼包分类	FtbQuestReader 精确匹配原生类型：不可重复、全部为勾选且至少一个目标、至少一项非空物品，可附带经验 / 等级；隐藏、命令、自选、随机和第三方奖励保留普通处理。无目标或纯勾选且无奖励作为介绍任务，不进入进度列表。
原生类型图标与 tooltip	QuestIconOutput 在服务端准备任务 / 奖励类型 ID、本地化文字和数量；客户端 system:icons 反射加载 FTB 图标元素。物品仍走原版 item tooltip，非物品复用 FTB 类型图标与文本 tooltip；缺少依赖或类型时回退文字。
紧凑奖励布局	任务详情、完成通知和礼包只显示一次奖励标题，物品和类型图标横排、超宽换行，自选项保留编号和操作。
解锁汇总	先发送当批逐项完成通知，再分别发送礼包汇总与普通解锁通知；单项普通解锁直接详情，多项合并列表，每个接收者每批至多一条。列表通知每页 10 项，本地翻页；按 ID 查看详情后可返回原页，不覆盖主动查询编号。重登、重置基线和静默操作不补发旧解锁。
说明书检索	仅收录勾选 / 无目标、有正文、非礼包任务；guideCandidates / guideReadable 包含介绍任务，仍核对章节与任务可见性、详情解锁及正文隐藏条件。返回前回到服务端复核队伍、语言、任务对象和内容。
聊天历史领取礼包	保留“领取礼包”与本地“确定”；礼包凭证在同一连接内不再按两分钟失效，仍校验玩家、队伍、任务 / 奖励对象、完成时间及原生状态。登出、撤销或停用模块清理，普通奖励短期凭证不变；磁盘历史不重新授权。
奖励合计	FtbQuestPreviews 合并同物品与组件、数量 / 随机区间，以及经验和等级；六份 100 经验显示 +600。物品模板 count 为 1，only_one 条件物品独立，不提前随机或发奖。
分层本地数据库	agent.database 为世界共享和 UUID 独立库提供同一套 Codec 数据表与稀疏 TF-IDF API；存于 <world>/system/database/shared.dat 和 players/<UUID>.dat，使用 GZIP 压缩 NBT。revoke / reset 删除私有库，累计用量不变；无新增模型、native、外部服务或依赖。
FTB 重新收录	/system ftb reload 要求管理员权限，可由控制台执行；重新收录 FTB 已加载定义并重建索引，不读写原生任务文件或进度。缓存失效事件取消旧代次结果。
数据库优先问答	核心 system:question 先用 database.query 查询当前玩家 / 共享知识与已启用 FTB 的授权说明。有资料时至多一次模型整理，失败可展示原文；存储错误不当作空结果。只有查库为空、搜索模块启用、当前明确允许联网且外部服务开启才运行 WebResearch。
搜索工具与授权	SearchSystemModule 为 ToolModule，导出 search / fetch；Descriptor.optionalTools 保留工具所属模块的权限，缺少搜索不影响本地问答。/question 只查本地，/search 允许空结果联网，测试默认 tag 不再自动赋予搜索。预算键为 system:question。

26.1.2 API 适配

此次直接核对目标依赖 source JAR，提取在 build/ftbsrc/26.1.2.8、build/ftblibsrc/26.1.2.9 与 build/auisrc/26.1-1.2.6；Minecraft 签名由实际 26.1.2 JAR 确认。

• 服务端实例：目标 ServerQuestFile.getInstance() 返回不可空的实例，并非 Optional；新增入口先检查 exists()，不保留来源代码中不适用的 Optional 调用。
• 原生事件：保留 master 的 NeoForge FTBQuestsEvent 与 ProgressEventData / ProgressType，没有带入 Architectury 事件。ClearFileCache 按 ServerQuestFile 定位桥接，并同时使说明书代次失效。
• 领取顺序：普通奖励继续交给 TeamData.claimReward。目标 Reward.claim 返回 void，无 tryClaim；自选严格跟随目标 ClaimChoiceRewardMessage，成功 markRewardAsClaimed 后调用所选奖励 claim，最后只检查原生已领取标记，不宣称第三方实际交付成功或提供回滚保证。
• 奖励数据：目标 writeData 接受 Json5Object，以 Json5Util 读取 xp / xp_levels / random_bonus / only_one，不使用 1.21 的 CompoundTag。物品预览采用原版 immutable ItemStackTemplate，按物品与组件相等合并。
• 文字解码：JSON Component 通过 ComponentSerialization.CODEC 与注册表 JsonOps 读取，无法解析则保留字面量，不加载 FTB 客户端文本辅助类。
• 客户端绘制：目标类型使用 getIcon，Icon 的 renderer 向 GuiGraphicsExtractor 记录渲染状态。新增 FtbQuestIconRenderer 在 AUI BODY 阶段，将几何、文字及物品重放到当前 AUI 输出目标、变换和投影，复用活动 scissor；不调用会重置目标的完整 GuiRenderer。tooltip 使用 setTooltipForNextFrame。不存在旧 GuiGraphics / flush 或全局 GL 深度恢复代码。
• 方块图标深度：重放物品模型时使用 Base.getGuiItemModelZ()，不能沿用二维图标的 Z=0；模型向后的部分会与卡片背景相交，看起来像面被剔除。保持原版模型剔除规则，并在恢复 GUI 光照前完成物品缓冲提交；数量等文字在模型之后绘制，使用 Base.getGuiItemDecorationZ() 保持前景层级。
• 命令与命名：原生 Commands.hasPermission；公共资源 ID 使用 Identifier。可选 FTB 类仍隔离于 compat.ftb，专服不引用客户端图标实现；未安装时不加载可选类。

数据格式

1.21.1 原生任务使用 .snbt，语言为 quests/lang/<locale>.snbt。26.1.2 继续使用目标原生 .json5 示例与布局；此次未把旧版示例、run 目录或整合包文件复制过来，也未增加旧存档迁移代码。说明书与背景从新库按需重建，旧的独立缓存文件不再读写。

验证与待验收

已执行 gradlew compileJava testModClasses，主代码与测试源集编译通过；最终执行 gradlew compileJava testModClasses jar --console=plain 成功，JAR 为 1,542,493 字节；双语各 513 键、23 份卡片与 13 个节点类型核对通过。完整静态检查与最终结果见 编译与验收。没有启动 Minecraft、运行测试、创建存档或调用收费 API，因此不能据此认为游戏内验收已经通过。

后续在目标版本人工验收：

1. 中英文玩家的任务标题 / 描述 / 搜索 / 通知 / 播报，以及缺译、无标题、JSON、§ 和 & 文本。
2. 勾选与物品加经验礼包、介绍任务排除、普通任务提交、原生依赖 / 暂停 / 顺序 / 自动领奖及队伍共享。
3. 图标、数量、物品与文字 tooltip、第三方类型、滚动裁剪、淡入合成和按 T 交互；缺少 FTB 的历史文字回退。
4. 单项解锁直接详情、多项合并列表且每页 10 项；本地上 / 下页不发包或切换通知，查看详情后返回原页。完成通知逐项发送且优先，底部确定关闭整个窗口，播报结束不自动翻页。
5. 礼包稍后从聊天历史领取、重复点击与部分失败、经验 / 等级和组件物品合计。
6. 共享 / 私有库隔离和持久化、重载权限与并发失效、数据库错误处理；本地有结果不搜索，查库为空且明确授权才联网，禁用搜索模块不影响本地问答。

未经明确要求，不为上述验收启动游戏、插入探针或创建临时数据。

master 后续变更：交互式任务通知窗口

2026-10-30 在 master 增加以上分页与返回行为。后续同步其他版本时，需一并同步 ActionsNode 的 notification_page_size、通知持有的 CardPageState / 返回栈、CardButton.Behavior.PUSH 与请求来源关联、quest_list.json、共享 CSS 和四个双语键；服务端 unlockNotification 的单项分支复用 FtbQuestAccess.detail(..., "unlocked")，完成事件循环不合并。该变更不新增依赖、网络包或数据库格式。

2026-10-30 本轮补充移植

以下先保留移植前的核对记录；实际实施结果见后续小节。

2026-10-30 待移植清单复核（1.21.1 7aca25a → master b97aa1c）

本次仅阅读并比较源码、依赖源码和资源，执行 git fetch origin 更新远端引用；未切换分支、修改 master、编译或启动游戏。远端 master 当前为 b6afc9d，本地 master 多出的 b97aa1c 尚未推送，下表以本地 master 为基线。

状态	范围	核对结果与后续处理
待同步	screen/card/node/ActionsNode	回调捕获前调用 Element.init。已直接检查 26.1 / AUI 1.2.6 的 Node.prepareForInsertion 与 Element.init，目标版本同样会替换普通 Element，分页按钮也有同一问题。
待同步	speech/asr/RecognitionRecording、AssistantRecognition	同步停止与入队互斥、缓冲耗尽后直接 EOF、终态回调保护、90 秒会话 / 15 秒收尾超时、取消清理和执行器拒绝处理；平台无关，不涉及 Windows 输入法。
先修正再同步	RecognitionRecording.record 的自然 EOF	当前 ended = true 写在 try-with-resources 外层 finally，实际发生在设备 close() 之后，尚未实现“自然 EOF 在设备关闭前发布”。手动停止已可通过 stopped 返回 EOF；自然结束则应将发布动作调整至资源关闭前，再同步两版本。这里只记录问题，未改实现。
按目标依赖确认	ImBlockerConfigMixin、system.mixins.json	当前白名单注入只核对过 IMBlocker 5.6.1 / 1.21.1，不代表适用于 26.1.2；有目标版本集成需求时先检查实际 JAR，缺少可用版本则不迁移。
保留目标实现	AssistantInputScreen、TokenUsageData	26.1.2 已有原生文本输入 / preedit 生命周期，不能随 1.21.1 的简化一起删除；SavedDataType 使用合法 Identifier，也不应套用 1.21.1 的字符串文件名修正。Windows 专用输入法检测已删除，不加入目标版本。
已同步	任务通知窗口与 FTB 业务	PUSH / 返回栈、每页 10 项、单个新任务直接详情、完成任务分别通知均已在本地 master；本轮对比两分支的 assets/system 卡片 / 语言和共享 CSS 无差异。FTB 事件、奖励调用、ItemStackTemplate 和图标渲染仍保留各版本 API。

同步时更新 ASR 和分页相关说明，保留 26.1.2 自己的版本信息、渲染与输入法文档；不能整份覆盖 1.21.1 的文档或直接 cherry-pick 7aca25a。

实施结果

已切换 master 并执行 git pull --ff-only origin master，远端无新提交，基线仍为 b97aa1c。同步 7aca25a 的 ActionsNode 提前初始化、RecognitionRecording 停止 / 帧队列处理和 AssistantRecognition 的终态、超时、取消及错误处理；额外将自然结束时的 ended = true 移至 try-with-resources 关闭设备之前，外层 finally 仍保证异常路径最终发布终止。该额外顺序修正目前只在 master，1.21.1 后续需回同步。

26.1.2 的 AssistantInputScreen 原生文本输入 / preedit、TokenUsageData 的 Identifier / SavedDataType，以及版本、依赖和 Mixin 配置保持原实现。2026-10-30 查询 IMBlocker 的 Modrinth 26.1.2 版本列表 为空，未将仅核对过 1.21.1 的白名单 Mixin 加入目标；没有增加平台专用输入法代码。

实际执行 gradlew compileJava testModClasses jar --console=plain 成功。静态 / 产物检查：中英文各 517 键且集合相同，23 份卡片 JSON 可解析，三个修改类均为 Java 25 字节码；system-1.0-beta.1.jar 为 1,548,823 字节，无内嵌 Saturn、旧 screen/input 类或 IMBlocker Mixin。没有运行测试、启动游戏、创建存档或调用收费 API；分页点击、设备结束与取消、识别自动发送仍待游戏内验收。改动未提交或推送。

2026-10-31 完整模式分页、定位与语音计费同步

1.21.1 的全部工作区内容已提交为 c6fc689；随后切换 master 并执行 git pull --ff-only，远端无更新，目标基线为 1ef5d80。本次逐项比较两版本，仅同步 master 尚缺少的公共修复：

范围	同步内容
完整模式任务列表	ActionsNode.page_size=10 同时用于完整模式与通知；AssistantScreen 按卡片 UUID 保存页码，经 AssistantView 传入，聊天刷新和窗口缩放保留状态。按钮仅重绘本地节点，不发包或推进通知。
界面定位	共享 CSS 直接用视口固定完整模式位置，简约模式与通知显式覆盖 top: auto，保留底部锚点。
页面缺失	AssistantScreen.updatePage 检查目标页面节点，允许自定义模板省略模块页面，避免空指针。目标 CoreSystemClientModule 已无旧聊天入口，无需重复改动。
语音价格表	SpeechPricingConfig 先初始化 PRICE / LOGGER，再构建外层 Codec / INSTANCE；金额接受 JSON 数字或十进制字符串，并直接用 BigDecimal 保存数字。
统计隔离与日志	LocalSpeechUsage.Ledger 在同步 update 中集中隔离 RuntimeException / LinkageError，保留上一次快照，不阻断成功的识别或播报；AssistantRecognition 保留完整异常堆栈。

26.1.2 的玩家模型已经通过独立 LivingEntityRenderState 与 FeatureRenderDispatcher 在 AUI 内提交，无需移入 1.21.1 的旧实体渲染调用。保留 master 的自然 EOF 在设备关闭前发布、原生输入法、SavedDataType、外置 Saturn、版本和依赖；不复制 1.21.1 的注解、ResourceLocation 或渲染实现。未改两份 README，未推送远端。

2026-10-31 语音账本后台处理（1.21.1 待同步）

用户反馈点击抽奖后短暂卡住再恢复，日志无语音异常。阅读源码确认 TTS HTTP / SSE / 解码在后台，但 AssistantSpeech.start 构建记账器时会通过 LocalSpeechUsage.current() 同步读取本地文件，且用量快照与价格计算 / 写盘共用账本锁。master 将账本首次加载、计算、归并和写盘统一移到 system-speech-usage 单线程队列；首次加载排在更新之前，界面通过 volatile 读取不可变快照，回调去重和账号隔离保持不变。JVM 关闭时独立 hook 最多三秒排空队列，不在渲染线程等待。两版本原 LocalSpeechUsage 内容相同，后续 1.21.1 可同步此类及语音文档。

此结论是源码审计发现的阻塞风险，不代表已确认本次卡顿唯一根因。对用户已有的 Prism 1.21.1 进程只读抓取线程堆栈时，渲染线程已经在正常帧限速等待，没有抓到卡顿现场。未启动或操作游戏，未执行运行时探针，未调用收费 API。

常驻固定任务后续变更

早期 QuestPinCache / QUEST_PINS 的连接内列表现已替换为核心模块 DisplayCardsDataStorage 和 ClientModuleCaches.DISPLAY_CARDS。固定操作走独立 C2S/S2C，服务端按玩家事务保存 source + id，markDirty 后沿用玩家文件持久化；登录重建当前队伍的可见任务快照，每秒刷新，只发送变化。完成后保留，失去权限时隐藏，登出仅清客户端缓存，revoke / reset 删除记录。

后续移植请连同 AssistantCardDisplays、FtbQuestDisplay、QuestPinOutput、存储与网络注册、AssistantCardDisplay、AuiHudEntry / DisplayCardsHudEntry / SystemHudEntries、被动鼠标 mixin 排除、quest_pin.json、assistant-cards.html、共享 CSS 和双语键一起核对。当前只在 26.1.2 工作区修改，尚未移植到 1.21.1；不要再按上文早期记录恢复客户端临时列表。

2026-11-07 运行时生命周期整理（1.21.1 待同步）

AssistantServer 改为单个 volatile INSTANCE，服务端启动完成后发布，停止时先清空再关闭；保留 get(server) 的对象身份检查，不向 MinecraftServer 挂字段或添加 Mixin。FTB 不再使用 SERVERS / ACCESS 静态 Map，由 FtbQuestRuntime 持有统一的查询、知识索引和通知状态；ModuleContext.sharedRuntime 在一次安装内共享实例，ModuleManager 对 validate / tick / close 按对象身份去重，并处理安装失败时的资源关闭。玩家 Session 按配置计数，最后一个关闭时才清理玩家引用。

后续同步需一起修改 FtbQuestAdapter.runtime 的 ModuleContext 参数、QuestSystemModule 反射签名、显式提交的实例通知调用，以及 /system ftb reload 的运行时查找。FTB 通知改为实例 @SubscribeEvent 监听，安装时注册、关闭时注销；旧版按实际事件 API 调整，保持可选依赖隔离，不移回服务器键 Map。当前仅修改 master，未同步到 1.21.1；编译结果不代表运行时事件与跨存档切换已验收。

同轮 ModuleContext 保留 AgentEngine / 模块注册表为固定字段，以 engine() / modules() 读取，其他服务注入改为 ContextType<T> 键与 Map。AssistantServer 使用双参构造加链式 put，FTB 和其他模块按依赖使用固定 getter 或 context.get(ContextTypes.XXX)。ModuleManager 在实际装配前发布 ModuleContextEvent，供其他模组同步注入扩展服务。移植时一并同步 ContextType / ContextTypes、事件和调用点，保留原有 sharedRuntime 的安装范围与生命周期，不恢复按服务增加字段的旧构造器。