Skip to content

Material系统清理+材料总览页面 - #403

Open
kuzuanpa wants to merge 17 commits into
masterfrom
material-sys-refactor
Open

kuzuanpa wants to merge 17 commits into
masterfrom
material-sys-refactor

Conversation

@kuzuanpa

Copy link
Copy Markdown
Contributor

概要

本 PR 在已合入的 #374(材料系统重构 01–06、08-A~C)之上,完成 07-A~E 的清理与 08-D/E 的接入:

  • 把分散在 recipe 包中的材料资格、流体单位、回收、洗矿、离心、挤压、透镜等事实收口为 content.material.catalog 的类型化 process 事实,由 MaterialFactKeys 单一读取;
  • 新增 API 1.9 的跨材料特殊工艺声明,以 typed target/reagent 规则替代酸洗专用数据类;
  • 从最终机器配方、有效成分、已发布形态和当前世界生成构建同代材料处理快照,并在 core 提供有界 SOURCES/USES/BOTH 查询与材料页直连查询;
  • 新增 JEI/EMI 共用的“矿物处理”页面:来源/内部转换/回收/去向分区、共享端口与局部副本、回流、缩放平移、全屏、资源左右键查询和原配方跳转。

本 PR 不宣告 #351 整体完结:07-F 仍需要双平台重载、独立远程客户端、正式 viewer 与发行包综合验收。分支共 12 个提交,全部由 kuzuanpa 提交;净变更 185 个文件,+10,482/−9,755。

主要改动

1. 材料事实收口与 07 清理

  • 新增 content.material.MaterialFactKeys,集中定义 SOURCE_FURNACE、SOURCE_ORE_INPUT、SOURCE_WASHING、SOURCE_EXTRUSION、MATERIAL_FLUID_UNIT、GENERIFICATION_TARGET 等类型化 process key。
  • ReviewedSourceMaterialFacts、ReviewedOreMaterialFacts、SourceWashingMaterialFacts、SourceExtrusionMaterialFacts、MaterialFluidUnitFacts 等进入 content.material.catalog,运行时消费者只经材料查询读取。
  • 删除 ReviewedMagneticMaterials、ReviewedOreGeneratedFluids、ReviewedSiftingGemForms、SourceOreCrushingFacts、OriginalMaterialFluidUnits、SourceWaxMaterials 等重复名单和旧事实入口。
  • 木材、覆盖板、传输材料的固定成分从 recipe 生产类迁至 WoodMaterialCompositions、PanelMaterialCompositions、TransportMaterialCompositions;配方类只负责发布配方。
  • 同步调整图标、注册入口和工具提示,使新事实与现有注册身份一致。

2. API 1.9:特殊工艺声明

  • 新增 SpecialProcessMethod、SpecialProcessValue.Target、SpecialProcessValue.Reagent、SpecialProcessesView。
  • MaterialCatalogView.specialProcesses() 与 MaterialInfoTool.Registrar.registerSpecialProcess(...) 提供只读声明入口。
  • target/reagent 通过同一个 MaterialProcessKey 绑定;SharedSpecialProcessRows 生成配方,MaterialTagPack 从同一规则派生 target/reagent 标签。
  • 删除 SourcePurifiedAcidRules/SourcePurifiedAcidData/SharedPurifiedAcidRows 的酸洗专用路径,改由 SpecialProcessData、SpecialProcessMaterialFacts、SpecialProcessMethods 驱动。
  • API 版本提升至 1.9.0;新增宿主方法提供 default 失败语义,避免未实现该能力的宿主静默接受。

3. 08-D:同代快照与有界处理图

  • 新增 MaterialProcessSnapshot:在 RecipePublication 成功提交后,把最终机器配方、已发布形态、活动 tag 和启用世界生成绑定到同一个发布戳/revision。
  • 新增 core MaterialProcessGraph:
    • 支持 SOURCES、USES、BOTH 递归遍历及材料页直连查询;
    • 保留共同输入、全部输出、催化剂、存在条件、批量单位、概率和原生状态;
    • 对深度、步骤、端口和关联数量执行独立预算,循环按步骤访问集终止,并显式报告截断;
    • 资源身份区分材料、形态、相态和原生状态,不按图标或物品 ID 合并。
  • 跨材料索引允许分解、合金和副产物继续沿路线展开;预算裁剪后的关联只引用保留下来的端口。
  • 快照资源引用带构建作用域,服务器停止、客户端断线和重载后拒绝旧 DataKey;未新增网络协议,客户端使用原版同步配方、材料定义和 datapack 世界生成配置重建。
  • MaterialWorldgenFacts 只投影当前活动的矿脉、小矿、岩层和基岩矿事实;世界生成 revision 按完整事实字段和稳定材料名计算。

4. 08-E:JEI/EMI 共用材料处理页

  • 新增 MaterialProcessDisplay、MaterialProcessProjection、MaterialProcessOverview、MaterialProcessPanel、MaterialProcessArrows、MaterialProcessScreen,供 JEI 与 EMI 共用同一页面模型、布局和交互。
  • JEI 分类为 gt6ce:material_process,显示名“矿物处理”;EMI 通过 MaterialProcessEmiRecipe、MaterialProcessEmiRecipes 和两个 mixin 接入相同的快照、索引和查询目标。
  • 页面支持:
    • 来源、内部转换、回收、去向四区;
    • 完整共同输入/输出的工艺组折叠与三列网格;
    • 共享节点、局部副本 ↗、回流 ↩ 和确认/未确认关系;
    • 概率、数量单位、未知角色和覆盖说明;
    • 鼠标位置缩放、平移、复位、全屏与窗口自适应;
    • 左键查来源、右键查用途、点击步骤跳转当前快照的原配方。
  • viewer 注册、图标和事件适配只在客户端;专用服务端不引用 JEI/EMI 类型,仍可构建和查询快照。

5. 测试、工具与文档

  • 新增 MaterialProcessGraphTest(468 行),覆盖循环、共同输入、前反向查询、各项预算、深度边界截断及裁剪后的关联合法性。
  • 新增 SpecialProcessValueTest,并扩展 API 契约测试覆盖特殊工艺声明。
  • 删除基于运行时快照的 MaterialBaseline* GameTest、探针和约 4k 行 TSV fixture;测试净减少约 6.0k 行。
  • tools/material/audit_roster.py 保留用于复核 work/ 中的历史快照;其 README 明确说明当前测试集不再生成新快照,不能当作当前实现验证。
  • 更新 docs/architecture/packages/runtime.md 与 docs/development/validation/checks/manual-ingame.md#矿物处理展示页,补充展示链、EMI 准入和人工验收步骤。

兼容性与审查重点

  • 预期不修改注册 ID、物品/流体身份、NBT、存档格式或网络协议;配方仍只在 RecipePublication 成功代发布。
  • API 1.8 → 1.9:新增接口方法为 default,但 API artifact 版本已提升,附属需要按 1.9 宿主编译和运行。
  • MaterialBaseline* 快照测试及其 fixture 被删除,是本 PR 最大的覆盖变化;MaterialProcessGraphTest 只证明 core 图查询,不证明投影布局、渲染或鼠标交互。请重点确认是否接受该测试取舍。
  • MaterialProcessOverview/MaterialProcessPanel 目前没有逐布局自动测试,按人工检查文档验收。
  • 同时删除 docs/roadmap/v1.0.md(原路线图草稿)。该删除与材料功能没有直接依赖;若仍需保留,请在合并前恢复。

验证

执行且通过

开发期最后一轮在 8e09b0815(合并 master 与清理测试前)执行:

  • ./gradlew format:通过。
  • ./gradlew :core:test ... compileBothPlatforms ...:BUILD SUCCESSFUL,覆盖 MaterialProcessGraphTest、API 契约和现有 core 测试。
  • ./gradlew :minecraft:1.20.1-forge:runGameTestServer:All 126 required tests passed。
  • ./gradlew :minecraft:1.21.1-neoforge:runGameTestServer:All 131 required tests passed。
  • ./gradlew assembleBothPlatforms:成功。
  • EMI 客户端加载探针:MATERIAL_LOADING_PROBE_PASS assertions=11;6000 条配方、每材料 9,000,000 条逻辑关联,405 ms。
  • git diff --check origin/master...material-sys-refactor:无输出。

尚未执行

  • 合并 master 后未在最终 merge commit 784508b7c 上重跑上述检查;请以该 commit 为准在 CI/本地重跑。
  • JEI-only、EMI-only、JEI+EMI 双装、无 viewer 专用服务端和独立远程客户端的人工验收。
  • 两平台正式材料页的截图、缩放/平移命中、NBT/组件状态、模具/工具条件、旧快照拒绝跳转和发行包综合验收。
  • 07-F 规定的双平台重载、远程客户端、正式 viewer 与发行包总体验收。

建议的审查顺序

  1. api/common/.../SpecialProcess* 与 MaterialFactKeys:确认 API 1.9 是增量契约,没有恢复第二套事实权威。
  2. MaterialProcessSnapshot 与 MaterialProcessGraph:确认发布戳、revision、跨材料索引、预算和旧引用拒绝逻辑。
  3. MaterialProcessProjection/MaterialProcessOverview/MaterialProcessPanel:确认没有按图标猜关系,隐藏辅料和副产物仍保留在原生配方。
  4. JEI/EMI 适配与客户端注册:确认无 viewer 服务端不会加载客户端类。

关联

Refs #351。基于 #374。

@Tanimodori Tanimodori left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

审阅结论

对PR #403 (material-sys-refactor @ 784508b7c) 的审阅意见如下。

【主要问题】

NeoForge 1.21.1 漏注册两个新 EMI Mixin,双平台矿物处理页不对称

  • 位置与调用链:minecraft/versions/1.20.1-forge/src/main/resources/gregtech.mixins.json:59-60 在 client 数组注册了 EmiMaterialProcessFocusMixin 与 EmiMaterialProcessRecipesMixin;minecraft/versions/1.21.1-neoforge/src/main/resources/gregtech-neoforge.mixins.json:55-68 的 client 数组遗漏了这两项(同文件 :57 仍保留 EmiMaterialUsesMixin)。GregTechEMIPlugin.java:42,177 依赖 EmiMaterialProcessRecipesMixin 在 EmiRecipes.bake 后注入页面数据,而 GregTechJEIPlugin.java:235-239 在检测到 EMI 加载后直接提前返回。
  • 影响:1.21.1 NeoForge + EMI 环境下 JEI 侧跳过注册、EMI 侧仅有空分类,矿物处理页功能整体缺失,破坏双平台一致性。
  • 复现草案:在 1.21.1 NeoForge 客户端仅启用或同时启用 EMI 启动游戏,查询任意材料的“矿物处理”分类,页面列表为空。
  • 可能的修复方向:在 gregtech-neoforge.mixins.json 的 client 数组中补全 EmiMaterialProcessFocusMixin 与 EmiMaterialProcessRecipesMixin(或移除对 Mixin 的依赖,改为通过公开 API 注册同一份快照数据)。

JEI 与 EMI 数据源分裂,违背“同一快照导出一致语义图”原则

  • 位置与调用链:GregTechJEIPlugin.java:242-245 直接从 MaterialProcessSnapshot.Store.current() 读取全量 RecipeMap.mRecipeList 快照并投影;而 EmiMaterialProcessRecipesMixin → GregTechEMIPlugin.java:177 → MaterialProcessEmiRecipes.java:57-121 使用 source.viewerBuilder() 重新拼装第二套客户端快照。GregTechEMIPlugin.java:108-110 会跳过 !map.mViewerAllowed 配方表,且 MaterialProcessSnapshot.java:803-810 的 ViewerBuilder 构造器不继承 source 的 GT 机器步骤,只靠 builder.machine(...) 从已注册 MachineEmiRecipe 补入。
  • 影响:两个 viewer 展示的不是同一张语义图——EMI 缺失高炉、真空冷冻机、组装机、切割机、煅烧炉、坩埚合金化等 viewer(false) 核心配方表步骤,却多出原版工作台、第三方模组配方和 allRecipes() 动态枚举行;即使 Store.current() 为 EMPTY,ViewerBuilder 仍会由 EMI 配方造出非空“矿物处理图”。
  • 复现草案:分别在 JEI-only 与 EMI-only 下打开 Steel 或 Bronze 的“矿物处理”页,对比高炉/组装机步骤与工作台/动态步骤的差异。
  • 可能的修复方向:明确二选一并形成长期设计决定——要么让 EMI 与 JEI 一致消费 Store.current() 的同代事实快照(移除 ViewerBuilder 与 EmiMaterialProcessRecipesMixin),要么把工作台/第三方补充定义为基于同一权威快照的显式扩展层,同时把 viewer(false) 机器步与动态规则统一纳入基线快照并标注边来源。

生产展示路径绕过 core 有界图,预算与截断未实际接线

  • 位置与调用链:MaterialProcessProjection.java:93 → MaterialProcessSnapshot.java:235-236 → MaterialProcessGraph.java:260-285 调用无预算、无 truncated 标志的 queryMaterial(DataKey);而 MaterialProcessGraph.java:152-154 将 Budgets.MATERIAL_PAGE 设为 (0, Integer.MAX_VALUE, Integer.MAX_VALUE, Integer.MAX_VALUE)。core 已实现的带预算 queryMaterial(root, budgets)(MaterialProcessGraph.java:457-533)及 Edge.confirmed、node_limit/port_limit/edge_limit 提示在 minecraft/src/main 无任何调用方;且 queryMaterial(root, budgets) 本身未读取 budgets.maxDepth(),达到 maxEdges 后仍继续遍历剩余候选。
  • 影响:有界查询、截断原因通知与图规模防护仅在单元测试中生效,生产页面随材料关联规模无界增长;MaterialProcessProjection.java:395-402 的预算截断提示分支成为不可达代码。
  • 复现草案:在 core/src/main/java/gregtech/engine/material/MaterialProcessGraph.java 与 minecraft/src/ 检索 queryMaterial(DataKey, Budgets) 及 Budgets.MATERIAL_PAGE 的生产调用点(均为 0 命中)。
  • 可能的修复方向:让 MaterialProcessProjection 接入带有限预算(如与验收文档一致的步骤/端口/边/深度上限)的 queryMaterial(root, budgets) 并消费 Edge 与 truncated;修正 queryMaterial(root, budgets) 对 maxDepth 的尊重及达到 maxEdges 后的提前终止。

世界生成投影未接入配置开关、存在形态与语义失真,且与 WorldgenInfoData 平行双写

  • 位置与调用链:MaterialWorldgenFacts.java:105-112 无条件扫描静态 GTOreVeins、GTStoneLayersGen、GTBedrockOres,未检查 GTOreVeinFeature / GTSmallOreFeature / GTStoneLayerFeature 依赖的 GregTechConfig.Worldgen.GEOLOGY 与 GTBedrockOreFeature 依赖的 BEDROCK_ORES;:276-284 靠 "ore_" + lowercase 拼接物品 ID 并在缺失时静默 continue;:211-219 将 GTStoneLayerFeature.java:165-174,295-299 实际放置的 ore_small 投影为普通 ore;:258 将基岩矿稀有度分母 row.chance() 写入 Fact.weight(MaterialProcessSnapshot.java:560-563 展示为 selection weight)。同时 WorldgenInfoData.java:19 仅注释声称来源为 MaterialWorldgenFacts,:106-162,382-456 仍保留第二套独立枚举逻辑,且 WorldgenEmiRecipe.java:7 仍直接导入 compat.jei.WorldgenInfoData。
  • 影响:关闭世界生成配置后矿物来源不会撤下;岩层小矿形态、基岩矿稀有度语义与真实生成不一致;EMI 与 JEI 对世界生成的事实投影仍未收口到同一底层实现。
  • 复现草案:关闭 GEOLOGY 或 BEDROCK_ORES 配置后启动或检查 MaterialWorldgenFacts.capture(),矿脉/基岩矿仍作为来源出现在矿物处理页。
  • 可能的修复方向:向 MaterialWorldgenFacts.capture() 传入或读取真实世界生成启用配置与维度可用性;改用 MaterialFormsView 实际绑定替代名称拼接并记录缺失覆盖提示;修正岩层 ore_small 形态及基岩矿稀有度语义;让 WorldgenInfoData 转发同一 MaterialWorldgenFacts 投影并把共享类型迁出 compat.jei。

材料事实“单一权威”仍留隐式 pass 顺序、静默后写覆盖与 GTMaterial 可变字段读取

  • 位置与调用链:MaterialDefinitions.java:30-42 依次执行 12 道 replaceAll,其中 SpecialProcessMaterialFacts.java:96-100 隐式依赖前序 ORE_PROCESSING 写入的副产物;各 *Facts 内部以 rules.put(...) 写入(共 19 处),同 key 二次写入会静默后写覆盖;FluidCatalog.java:999-1004、MaterialForms.java:70-75 等处直接读取未合并附属的 MaterialDefinitions.info(),与 MaterialInfoRegistry 发布快照构成双读。配方侧 SourceOreCrushingAdapter.java:322-337、SourceThermalNativeAdapter.java:208-210 仍读取 GTMaterial 可变兼容字段(targetCrushingMaterial、oreMultiplier、byProducts、density、meltingPoint);Recipe.java:17,148-154 新增可写 specialProcess,由 SharedSpecialProcessRows.annotateExistingRows(:106-122)启发式匹配回填并在多方法命中时抛 IllegalArgumentException;此外 MaterialDefinitions.java:41(content.material)与 GTMaterialRegistry.java:231(engine.material)反向调用 content.recipe.SpecialProcess*。
  • 影响:调整 MaterialDefinitions pass 顺序或同 key 声明会静默丢失锰浸出等事实;附属补充的副产物或工艺无法穿透 MaterialDefinitions.info() 双读路径;第三方数据包或配方命中多个特殊工艺模式时会直接导致重载失败。
  • 复现草案:在 MaterialDefinitions.collect() 中将 SpecialProcessMaterialFacts::apply 移到 ReviewedOreMaterialFacts::apply 之前,锰浸出目标会无报错静默消失;或在配方表中加入一条同时匹配两种浸出规则的 Bath 配方触发 annotateExistingRows 抛异常。
  • 可能的修复方向:将 rules.put 收敛为带重复键冲突检查的写入助手,显式声明 pass 间依赖或在链接/发布后派生跨事实关系;把 SourceOreCrushingAdapter 等消费者仍读取的来源策略字段彻底迁入 MaterialFactKeys;把特殊工艺标识保留在生成侧元数据或降级多义冲突为告警而非中断重载;理顺 content.material / engine.material 对 content.recipe 的反向依赖。

特殊工艺生产路径静默丢弃输出并导致概率槽位错位;MaterialTooltips 仅做删行未完成 07-3

  • 位置与调用链:SharedSpecialProcessRows.java:192-197 遍历 plan.itemOutputs(),当 firstItem(output, resolver) 返回空栈时直接 continue,连带跳过 chances.add((long) output.chance());同时 :78,87,184,203 缺少试剂、形态解析失败均静默跳过,没有类似 SharedThermalRecyclingRows 的 DEFERRED/原因分类统计。客户端 MaterialTooltips.java:199-214 仅删除 composition_nonmaterial 与 composition_descriptive 两处调用,未按母计划重建损坏工具/容器/批量授权状态展示,且 en_us.json / zh_cn.json 中这两个键仍残留未删(zh_cn 中 composition_descriptive 仍为英文)。
  • 影响:若配方中间某个输出形态缺失(例如第 1 输出不可解析、第 2 输出存在),itemOutputs 与 chances 数组长度与索引不再对齐,第 2 输出会错误继承第 1 输出的概率(或发生槽位概率错位),且缺失输出无诊断可追踪。
  • 复现草案:构造一条包含两个 ItemOutput 的 SpecialProcessValue.Target,令第一个输出仅指定不存在的形态、第二个输出有效,观察生成 Recipe 的 mOutput 与 mChances 对应关系。
  • 可能的修复方向:解析失败时按固定分类策略明确报错、保留空输出概率占位或整体拒绝该配方行(禁止仅跳过 itemOutputs 而不补齐 chances);为 SharedSpecialProcessRows 增加与 SharedThermalRecyclingRows 一致的构建结果/跳过原因统计;按 07-3 口径统一清理或重建 tooltip 状态文案与语言键。

compat.common 承载 1094 行纯客户端布局引擎并反向依赖 compat.jei,多套边模型并存

  • 位置与调用链:MaterialProcessOverview.java(1094 行)后半部分路由折叠、层级排布、货架打包、连线几何与悬停判定仅被 client.MaterialProcessPanel 消费(MaterialProcessPanel.java:34),却位于 compat.common;RecipeViewerIcons.java:50 在 compat.common 中直接调用 gregtech.compat.jei.RecipeMachines.collect(),且 MaterialProcessProjection.pages(:40,52)每次开页都会触发一次全 BuiltInRegistries.ITEM 扫描;MaterialProcessPanel.java:8 同样导入 gregtech.compat.jei.PreviewViewport。同时 MaterialProcessGraph(Edge/Flow)、MaterialProcessOverview(自算 applyConfirmation)和 MaterialProcessDisplay(未构造的 Connection、Page.connections)三套边模型并存,Port.tooltip()、Step.details、Step.specialProcess 等字段写入后未在 UI 渲染。
  • 影响:包职责边界与 docs/architecture/packages/runtime.md:16,21 发生漂移(本 PR 直接新增 :73 段落追认,与包职责表自相矛盾);compat.common 与 compat.jei 形成反向依赖且开页带来不必要的全物品注册表遍历;两套 confirmed 推导可能对同一条路线给出不同结论。
  • 复现草案:检查 compat/common 对 compat/jei 的包导入,以及打开 EMI 材料页时 MaterialProcessProjection.pages → RecipeViewerIcons.categories() → RecipeMachines.collect() 的调用链。
  • 可能的修复方向:将纯客户端几何与视口排布从 MaterialProcessOverview 拆分下沉到 client 包,仅保留 viewer 中立的展示 DTO 在 compat.common;将 RecipeMachines / PreviewViewport 等共享投影移出 compat.jei 并缓存工作站图标映射;收敛 MaterialProcessGraph 与展示层之间的边与 confirmed 模型,清理死模型字段。

【次要问题】

  • 展示层共同输入压入详情与跨配方折叠冲突:MaterialProcessOverview.java:683-700(visible())与 :338-375(routes())将外材料共同输入压入 + 详情并按机器图标折叠相似路线(manual-ingame.md 步骤 2/5 已按此编写),但在合金及共用铁砧/坩埚图标工艺下会造成单原料幻觉或跨配方并集边。
  • 图模型与投影丢失催化剂索引、角色、事件组及 selector 身份:MaterialProcessSnapshot.java:346-350,436-458,467,494 将物品催化剂降级为详情文本、输出角色全置 UNKNOWN、缺失 ExclusiveOutputRules 事件组且将 tag/unit 归属代表材料并截断前 8 个候选;MaterialProcessProjection.java:153-164 又以首个图标状态覆盖 identity,使抽象 selector 与具体物品被合并为同一节点。
  • 同代快照提交边界与远程同步未闭环:MachineRecipeOverlay.java:171-174 先于 RecipePublication.java:61-63 的炉桥与最终 replaceRecipes 提交 MaterialPublication,MaterialProcessSnapshot.Store.publish(:986-993)失败不回退 Stamp;远程客户端(MachineRecipeClient.java:64-70)在同步线程本地重算且无服务端版本校验包;过期 DataKey 静默返回空结果。
  • 步骤跳转与形态切换停留在图标级交互:MaterialProcessPanel.java:215-217,328-335 仅取 steps.get(0) 的机器图标跳转,Navigation.openForm 为零调用死接口且两 viewer 忽略 uses 参数;MaterialProcessScreen.java:57-83 在重载/断线后仍用缓存绘制全图且无过期提示,MaterialProcessPanel.click() 缺少 valid() 入口守卫。
  • API 1.9 越界暴露、校验缺口与死常量:SpecialProcessMethod.recipeMap 暴露宿主内部表名且 freeze 期不校验存在性;SpecialProcessValue 为 sealed 与原计划扩展性设想不符;SpecialProcessesView.NONE 违背显式失败语义;跨命名空间 Target 缺少目标材料所有权校验(MaterialInfoRegistry.java:150-156);SpecialProcessValue.java:31 在 Map.copyOf 后存在不可达 == null 判空。
  • 本地化键缺失与拼接失配:SpecialProcessMethods.java:40,44 将 special_process/<name> 拼成 gt6ce.special_process.special_process.* 导致与 core/src/main/resources/assets/gt6ce/lang/zh_cn.json:72-75 失配;全部 62 个新 UI/工艺键只写入 zh_cn.json 而 en_us.json 为 0(英文环境全显裸键),且 zh_cn.json:68-90 残留 12+ 个无 Java 引用的死键。
  • 局部编码细节与死代码:EmiMaterialProcessRecipesMixin / EmiMaterialProcessFocusMixin 目标为 EMI 内部/private 成员且 require = 1、GTOptimizationMixinPlugin 无版本守卫;SharedOreWashingRows.Snapshot 被 6 个无关配方生产者直接复用;MaterialProcessProjection.java:401-402 将 depth_limit 误映射为 node_limit 文案;Store.previous、GregTechJEIPlugin.overlayGeneration、MaterialProcessDisplay.Connection、SpecialProcessesView.NONE 等死代码未清理。

【设计分歧】

  1. 08-D/E 图与快照机制未进入 api 公共契约,与既有设计文档及 ADR 规划定位不一致

    • 当前 MaterialProcessGraph 留在 core/engine/material,MaterialProcessSnapshot 留在 minecraft/content/recipe 且同时承担服务端事实捕获与客户端 viewerIcons/ViewerBuilder 职责,外部附属无法通过 api 查询来源/用途或处理图;同时 api/common/.../MaterialProcessesView 已被材料规则视图占用,原设计提议中拟定义的同名图查询接口无法直接按原名落地。
    • 请作者明确:本轮是否有意将 08-D/E 收缩为“仅供 JEI/EMI 使用的内部数据层”,不再向 api 提供跨世界/多快照只读图契约;若是,应在架构与决策文档中显式登记此设计变更,并将客户端 ViewerBuilder/图标缓存从服务端快照类拆出。
  2. 整类删除 MaterialBaselineTests 等端到端回归测试与测试覆盖取舍

    • 本 PR 除清理一次性 TSV 对比脚手架(MaterialBaselineSnapshot、MaterialReferenceAudit、material-import-references.tsv、material-reference-history.tsv)外,一并删除了 MaterialBaselineTests.java(覆盖两次真实资源重载不累积、失败 tag 代次不破坏 MaterialPublication.Stamp、附属回收/分解机器执行、ServiceLoader SPI)、MaterialRegistrationTest 中 45 个隔离场景及 META-INF/services/gregtech.api.addon.material.AddonMaterialContributor 测试提供者,且未完成 07 步骤 2 对 chain/minecartWheels 的消费端审计。
    • 同时新增的 API 1.9 registerSpecialProcess 端到端链路、MaterialProcessSnapshot(1002 行)、MaterialWorldgenFacts(294 行)与 MaterialProcessOverview(1094 行)均无对应自动化测试(manual-ingame.md:36 仅说明不再维护逐布局示例 GameTest,但数据层投影与生命周期重载本可自动化)。请作者明确是否接受完全移除材料域重载/回滚/SPI 自动化回归,或补回最小核心端到端测试集。

【文档同步情况】

  • API 1.9 文档未同步:docs/ADDON_API.zh-CN.md:42-44,58 仍写 1.8.0 / 1008 且未记录 SpecialProcessMethod、SpecialProcessValue、SpecialProcessesView、registerSpecialProcess;docs/decisions/material-system/data-api-and-publication.md:10 仍写 API 1.4–1.8;docs/architecture/packages/api.md:13 遗漏 SpecialProcessesView。
  • 决策文档与运行文档状态矛盾:docs/decisions/material-system/README.md:54 与 data-api-and-publication.md:30-40 仍将来源图与处理图标为“提议/尚未实施”,而 docs/architecture/packages/runtime.md:73-77 已按已交付实现描述;同时 runtime.md:16,21 的包职责表未与 :73 对 compat.common 布局职责的扩张保持一致。
  • 路线图删除留下断链、测试文档仍引用已删类:删除 docs/roadmap/v1.0.md 后,README.md:88、README.zh-CN.md:88、docs/README.md:14 仍指向该文件;docs/architecture/packages/content.md:102 与 docs/development/validation/checks/gametest.md:39,41 仍以现在时描述已删除的 MaterialBaselineTest(s) 与 material_baseline_reload;docs/architecture/packages/engine.md 未补充 MaterialProcessGraph;content.md:13 与事实写入跨越 content.recipe/content.block.stone 的现状未对齐。
  • 验收阈值、工具索引与验证路由未同步:docs/development/validation/checks/manual-ingame.md:25 提到的 128/512/4096 预算上限在代码中不存在;tools/material/README.md 与 tools/material/audit_roster.py(仅读取已删测试的遗留快照)未列入 tools/README.md 索引且归属偏离 docs/development/repository-layout.md;docs/development/validation/routes.yaml 未将 MaterialProcessSnapshot 所在路径路由到对应的展示验收。

【本地测试结论】

按本次审阅范围要求,跳过 CI、Spotless 格式化检查、JUnit、GameTest、打包校验与游戏内人工验收,未在本地执行构建或测试命令;上述问题均基于 GregTech6CE-ReadOnly(784508b7c vs d73b33d5f)只读源码与 diff 静态核对得出,所有阻断项的运行时表现尚待补跑对应双平台检查确认。

【结论】

  • (阻断)修复主要问题,特别是补全 1.21.1 NeoForge 的 EMI Mixin 注册恢复双平台对称性、消除 JEI/EMI 双数据源分裂与 viewer(false) 配方缺失、为生产展示路径接入真实有界图预算与截断、修复 MaterialWorldgenFacts 的配置门禁/形态语义并与 WorldgenInfoData 收口、消除 MaterialDefinitions 隐式顺序/静默覆盖及 GTMaterial 可变字段双读、修复 SharedSpecialProcessRows 输出丢弃导致的概率槽位错位,并梳理 compat.common 对 compat.jei 的反向依赖与布局下沉。
  • 关注次要问题,特别是补全 en_us.json 全部新 UI/工艺本地化键与修复 SpecialProcessMethods 键名双写前缀、排查 visible()/routes() 隐藏共同输入与抽象 selector 合并风险、补齐同代快照包含炉桥与过期提示、清理 openForm 等死接口及无效代码。
  • (阻断)表明设计预期,特别是明确 08-D/E 是否收缩为内部 viewer 数据层而非 api 公共契约,以及整类删除 MaterialBaselineTests 等端到端重载/回滚/SPI 回归测试并跳过新子系统自动测试的验收边界取舍。
  • 同步相关文档情况:更新 docs/ADDON_API.zh-CN.md 至 API 1.9、对齐 docs/decisions/material-system/ 与 runtime.md 状态描述、清理 docs/roadmap/v1.0.md 删除后的 3 处断链及 content.md/gametest.md 对已删测试的引用,并同步 manual-ingame.md 阈值、tools/README.md 索引与 routes.yaml 路由。

@lombinaxmasson

Copy link
Copy Markdown
Collaborator

补充审阅(未重复上一条审阅已覆盖项)

已核对 Tanimodori 的审阅,以下只列其未覆盖或需要补充的点;已覆盖的 NeoForge Mixin、JEI/EMI 数据源分裂、有界图预算、世界生成配置开关、材料事实收口、删除 MaterialBaselineTests、en_us 键缺失与文档同步不再重复。

[P2] resolveFluid 把流体用量绑死到 1000 mB/U,合法流体被丢弃

  • SharedSpecialProcessRows.java:324-338 要求 referenceSourceUnits == GTValues.U 且 referenceMillibuckets == 1000。MaterialFluidUnitFacts.java:83 的 Mercury 是 144 mB/U,Lava 是 9 U。
  • 作试剂时 addReagent(:216-241)返回 false,整条配方被跳过;作产物时 firstFluid(:251-258)返回空栈,而 build(:199-203)只在所有物品/流体产物都为空时才拒绝,于是配方照常发布但缺少该流体输出。
  • API 的 Target.reagentAmount 与 FluidOutput.millibuckets 已经是 mB,不需要再以 1000 为绑定前提;产物解析失败应整行拒绝或至少记录明确诊断。

[P1/合并门禁] 最终提交的 CI 在 spotless 失败,未进入编译

  • Actions run 43736876159 在 :core:spotlessJavaCheck 失败,涉及 OreHostFacts.java、ReviewedSourceMaterialFacts.java、SourceRecyclingMaterialFacts.java 的 import 顺序;构建在 :core 编译、测试和 GameTest 之前终止。最终 merge commit 实际没有跑过 compile/test/GameTest。

[P2] overlay 失败后 Store.current 保留上一代快照,两个 viewer 继续可用

  • MachineRecipeOverlay.apply 失败进入 recover()(:110-118),把所有 RecipeMap 恢复到基线;RecipePublication.java:64 因 lastResult().failed() 跳过 Store.publish,而 Store 既不推进也不清理(MaterialProcessSnapshot.java:950-960)。
  • 结果:JEI 重载时 GregTechJEIPlugin.java:242 仍读到旧快照,EMI 的 valid() 身份检查也仍为真,页面继续展示已从 RecipeMap 删除的转换,且没有失败提示。建议失败时 clear,或发布带 failure notice 的空快照。

[P3] 打开“全部配方/分类”会重置已缓存材料页的缩放与平移

  • EmiMaterialProcessFocusMixin.java:31-32 对 setPages 中的每个材质页无条件 focus(ingredient);EMI 的 displayAllRecipes / displayRecipeCategory / displayRecipe 传入 EmiStack.EMPTY。空 focus 匹配不到任何端口,MaterialProcessPanel.focus(:38-41)仍执行 resetView()。加一个 ingredient.isEmpty() 短路即可。

[P3] Target.inputCounts() 未随 rule.forms() 一起规范化,别名形式会在 freeze 抛错

  • MaterialInfoRegistry.java:202-206 比较 target.inputCounts().keySet() 与规范化后的 rule.forms();:374-385 会把别名 casingSmall 改写成 itemCasing,但 target 的键仍是 casingSmall,于是触发 “target forms do not match rule forms”。建议对 inputCounts 做同构规范化,或在 Target 构造期拒绝别名。

[P2 补充] 未知 recipeMap 的抛点在 overlay 生成期

  • 上一条审阅已指出 freeze 期缺少地图存在性校验;补充:实际抛点在 SharedSpecialProcessRows.java:71-77,位于 MachineRecipeOverlay 的生产者重建阶段。任意附件拼错一次地图名,就会让整代 overlay 恢复基线。建议重建时跳过并记录日志,而不是抛出。

[P2 补充] 世界生成:数据包移除 biome modifier / placed feature 时同样不撤下来源

  • MaterialWorldgenFacts.capture()(:105-112)只读静态表;即使数据包把 gt_overworld_ores 的 biome modifier 或 placed feature 移除,capture 仍返回小矿/岩层事实,Store.publish 的 revision 比较(MaterialProcessSnapshot.java:968-973)也不会变化。除配置开关外,数据包覆盖也需要纳入判定与 revision。

[P2 风险] 快照构建在配方发布事件线程同步执行

  • RecipePublication.java:64-66 直接在事件线程调用 Store.publish → MaterialProcessSnapshot.build,遍历所有 RecipeMap 并对带 NBT/组件的栈做 SHA-256(:742-769)。PR 自测 6000 配方约 405 ms;大型包的重载/启动 tick 可能接近 watchdog。可参照 prebuildLookupIndexes 的延后方式处理。

另核对:itemOutputs 与 chances 不会发生槽位错位

  • SharedSpecialProcessRows.java:190-197 中 itemOutputs.add(...) 与 chances.add(...) 在同一个非空分支内成对执行,跳过某个输出时两者都不添加,索引保持对齐。实际风险是“缺失输出被静默丢弃”,不是概率槽位错位;修复仍建议整行拒绝、保留占位或增加 DEFERRED 统计。

@lombinaxmasson

Copy link
Copy Markdown
Collaborator

修复复核(94a47639a)

已复核 94a47639a(b577d8a14 恢复 roadmap,94a47639a bugfix)。

确认已修复:NeoForge 两个 EMI Mixin;en_us 与 gt6ce.special_process.* 键及语言测试;API/决策/测试/路由/工具文档同步;MATERIAL_PAGE 预算与 MaterialProcessProjection 接入;JEI/EMI 通过 ViewerBuilder 统一数据源并补入 viewer(false) GT 步骤;MaterialProcessOverview/RecipeMachines/PreviewViewport/WorldgenInfoData 的包移动与依赖方向;Store.previous、SpecialProcessesView.NONE、不可达判空清理;MaterialFactKeys.put 重复键检查;depth_limit 文案与 tooltip 补充。

以下问题仍未解决或为本轮新发现。

[P1] 最终提交 CI 仍失败,且没有进入编译

  • Actions run 43820818168 在 :core:spotlessJavaCheck 失败:OreHostFacts.java、ReviewedSourceMaterialFacts.java、SourceRecyclingMaterialFacts.java,以及本轮新增的 MaterialFactKeys.java(wildcard import/import 顺序)。构建在 core 编译、测试和 GameTest 之前终止,最终 head 实际没有跑过 compile/test。
  • 本轮把 rules.put 全部改为重复键即抛异常,更需要一次真正的 :core:test 来确认 pass 顺序没有触发新异常。

[P1] 特殊工艺冲突仍会让整代 overlay 回退

  • SharedSpecialProcessRows.java:124 在一条配方匹配多个方法时仍抛异常;matches()(:132)仍忽略试剂用量,也不读取已有 specialProcess ID。MachineRecipeOverlay.apply 的 catch → recover()(:110-118、:184)会恢复所有 RecipeMap 的基线。
  • 本轮只增加了“构建失败时统计 omitted”,没有改变冲突策略。建议已有 ID 的行跳过、用量纳入匹配,冲突降级为日志/跳过或在注册/冻结期拒绝。

[P2] 流体用量仍被绑死到 1000 mB/U

  • SharedSpecialProcessRows.java:342-343 仍要求 referenceSourceUnits == U 且 referenceMillibuckets == 1000;MaterialFluidUnitFacts.java:83 的 Mercury 是 144 mB/U,Lava 是 9 U。
  • 作试剂时 addReagent 返回 false,整条配方跳过;作产物时 firstFluid(:262)返回空,而 build(:214)只在所有物品/流体产物都为空时才拒绝,配方照常发布但缺少该流体输出。
  • API 的 Target.reagentAmount / FluidOutput.millibuckets 已经是 mB,直接按 FluidCatalog 与 GTFluids.stack 解析即可;产物失败应整行拒绝或至少记录明确诊断。

[P2] 未知 recipeMap 仍在 overlay 生成期抛出

  • SharedSpecialProcessRows.java:76-78 找不到地图直接抛 IllegalArgumentException;SpecialProcessMethod 与 MaterialInfoRegistry.validateSpecialProcesses 仍不校验存在性。附件拼错一次地图名,每次重载都会走恢复基线。建议重建时跳过并记录日志,或在平台发布阶段拒绝该方法。

[P2] overlay 失败后 Store 仍保留上一代快照

  • MachineRecipeOverlay.recover()(:184-218)只恢复 RecipeMap;RecipePublication.java:64 因 failed() 跳过 Store.publish,而 MaterialProcessSnapshot.Store(:1013-1045)既不推进也不清理。JEI/EMI 的 valid() 仍为真,页面继续展示已从 RecipeMap 删除的转换,且没有失败提示。建议失败时 clear,或发布带 failure notice 的空快照。

[P2] 世界生成:数据包覆盖仍不生效

  • config 门禁已修复,但 MaterialWorldgenFacts.capture()(:112-117)仍只检查 GEOLOGY/BEDROCK_ORES 并读取静态表。数据包移除 gt_overworld_ores 的 biome modifier 或 placed feature 后,小矿/岩层来源仍会列出,Store.publish 的 worldgen revision 比较(MaterialProcessSnapshot.java:1023)也不会变化。建议读取当前 level 的实际挂载状态并纳入 revision。

[P3] 岩层小矿投影仍不完整

  • MaterialWorldgenFacts.java:221-235 只在 explicitItem 为 AIR 时才同时加入 ore_ 与 ore_small_;材料有普通 ore_ 物品时仍只投影普通矿。若目标确如注释所说“keep both real resources”,需要在有普通矿时也加入 ore_small_。

[P3] Target.inputCounts() 未随 rule.forms() 规范化

  • MaterialInfoRegistry.java:202-206 比较 target.inputCounts().keySet() 与规范化后的 rule.forms();:374-385 会把别名 casingSmall 改写成 itemCasing,但 target 键不变,freeze 会误报 target forms do not match rule forms。建议对 inputCounts 做同构规范化,或在 Target 构造期拒绝别名。

[P3] focus 空栈仍会重置已缓存页面

  • EmiMaterialProcessFocusMixin.java:32 仍对所有材质页无条件 focus(ingredient);EMI 的 displayAllRecipes/displayRecipeCategory/displayRecipe 传入 EmiStack.EMPTY,MaterialProcessPanel.focus(:37-40)仍会 resetView()。加一个 ingredient.isEmpty() 短路即可。

[P3] 全屏页与面板仍无过期守卫

  • MaterialProcessScreen.render(:58-74)与 mouseClicked(:76-83)仍直接使用缓存 panel,MaterialProcessPanel.click(:330)也不检查 navigation().valid();重载/断线后需要依赖上层关闭或提示。

[P3] JEI 捕获成本与新 API 用法

  • GregTechJEIPlugin.onRuntimeAvailable 每次 JEI 重启(登录、每次 /reload)调用 MaterialProcessJeiRecipes.capture,遍历所有分类并对每条非 GT 配方执行 createRecipeLayoutDrawable(MaterialProcessJeiRecipes.java:127),没有预算或分批。大整合包下请实测登录与重载耗时。
  • MaterialProcessJeiRecipes.java:153 对 inputs 或 outputs 为空的配方直接跳过,纯来源/纯用途行不会进入材料图。
  • MaterialProcessJeiRecipes.java:37 自行实现 IFocusGroup;JEI 19 标注该接口 @ApiStatus.NonExtendable,应改用 getEmptyFocusGroup()。
  • RecipeViewerIcons.java:18 的 cachedCategories 没有重载失效路径。

[P3] 文档与死代码

  • MaterialPublication.platformGenerationPublished(MaterialPublication.java:42)已无调用方,但 docs/decisions/material-system/data-api-and-publication.md:27 与 README.md:43 仍按旧流程描述;应改为 candidate/commit 两阶段。
  • MaterialProcessDisplay.Flow 生产端始终为空;GregTechJEIPlugin.overlayGeneration 只写不读。
  • MaterialProcessLanguageTest 未列入 docs/development/validation/checks/junit.md:57 的常驻入口。

仍未恢复的测试覆盖

  • MaterialBaselineTests 未恢复;gametest.md:39 已改为“按游戏内人工验收执行”。如果这确实是本轮取舍,请明确记录;否则建议至少补回“两次真实重载不累积”和“失败 tag 代次不破坏 Stamp”两个定向场景,外加一个“overlay 失败后基线恢复且 Store 失效”的新测试。

@kuzuanpa
kuzuanpa requested a review from Tanimodori November 16, 2026 08:03
@Tanimodori

Copy link
Copy Markdown
Member

对原审阅意见的复核(832769666)

已在 PR #403 最新提交 832769666(覆盖 b577d8a14、94a47639a、832769666)下基于只读源码复核此前审阅意见。按既定原则继续跳过 CI、Spotless 格式化、JUnit、GameTest 与双平台人工测试,小问题不列为阻断。

【原主要问题解决情况】(2 项已解决,5 项部分解决)

  1. NeoForge 1.21.1 漏注册两个 EMI Mixin —— 已解决

    • minecraft/versions/1.21.1-neoforge/src/main/resources/gregtech-neoforge.mixins.json:57-58 已补入 EmiMaterialProcessFocusMixin 与 EmiMaterialProcessRecipesMixin,恢复与 Forge 侧对称。
  2. 生产展示路径绕过 core 有界图 —— 已解决(主展示路径)

    • MaterialProcessGraph.java:153 已将 Budgets.MATERIAL_PAGE 设为 (0, 512, 128, 4096);MaterialProcessProjection.java:93,103-110,404-405 已接入 queryMaterial(root, Budgets.MATERIAL_PAGE) 并消费 Edge 与截断通知(同步修正 depth_limit 文案映射与 manual-ingame.md:25 阈值描述)。
    • 仅剩索引路径 MaterialProcessProjection.indexedPorts(:62)仍走无预算的 snapshot.materialSteps(root)。
  3. JEI 与 EMI 数据源分裂 —— 部分解决(核心对称性已补齐,仍保留双端各自枚举)

    • 已解决:MaterialProcessSnapshot.ViewerBuilder(:836-848)现会继承权威快照中的世界生成步骤与 !map.mViewerAllowed 原生步骤;JEI 侧也切换为经 MaterialProcessJeiRecipes 消费 source.viewerBuilder()(GregTechJEIPlugin.java:37-45),两个 viewer 现已统一保留高炉/组装机等 viewer(false) 核心配方表步骤,并在 docs/decisions/material-system/data-api-and-publication.md:35 与 docs/architecture/packages/runtime.md:73,77 显式登记为本轮设计策略。
    • 仍残留:JEI(createRecipeCategoryLookup + 逐条 createRecipeLayoutDrawable)与 EMI(EmiRecipes.bake 后列表)仍各自在客户端枚举最终可见配方;且当 MaterialProcessSnapshot.Store.current() 为 EMPTY 时,ViewerBuilder 仍会仅凭 viewer 行造出非空矿物处理页。
  4. 世界生成投影配置门禁 / 形态语义 / WorldgenInfoData 双写 —— 部分解决

    • 已解决:MaterialWorldgenFacts.capture()(:110-118)与 WorldgenInfoData(:72,384,410,448)均已接入 GEOLOGY/BEDROCK_ORES 开关;基岩矿改用 MineralWorldgenRules.bedrockWeight(row.chance())(:280)与 "bedrock rarity: 1 in ..." 语义(:297);形态查询改为优先查 GregTechMaterials.formBindings()(:320-335);WorldgenInfoData 已迁入 compat.common 消除反向依赖。
    • 仍未闭环:
      • WorldgenInfoData.java(:71-140,383-460)仍是独立枚举重算实现,未转发 MaterialWorldgenFacts,双写未收口;
      • GTStoneLayerFeature.java:167,174 中只有岩层内部非核区放置 ore_small、接触层(contact)固定为 small = false,但 MaterialWorldgenFacts.java:235-247 对 explicit == AIR 的接触层也一并生成 ore_small_ 事实,引入接触层假小矿来源;
      • 解析/形态缺失仍静默 continue 且无覆盖提示。
  5. 材料事实“单一权威”隐式 pass 顺序 / 静默覆盖 / GTMaterial 可变字段读取 —— 部分解决

    • 已解决:MaterialFactKeys.put(:18-24)改为 putIfAbsent 冲突即抛 IllegalArgumentException,消除同键静默覆盖;annotateExistingRows 多方法冲突改为告警跳过(SharedSpecialProcessRows.java:126-130);MaterialInfoRegistry.normalizeProcessRule(:388-409)补齐 Target.inputCounts 别名规范化。
    • 仍未解决:
      • MaterialDefinitions.java:30-42 仍保留 12 道隐式顺次 replaceAll(SpecialProcessMaterialFacts.java:96 仍隐式依赖前序 ORE_PROCESSING);
      • FluidCatalog.java:1001、MaterialForms.java:73、MaterialProcessingTargets.java:41 等仍双读未合并附属的 MaterialDefinitions.info();
      • SourceOreCrushingAdapter.java:323-336 与 SourceThermalNativeAdapter.java:209,276 仍读取 GTMaterial 可变兼容字段;
      • Recipe.specialProcess 启发式回填与 MaterialDefinitions.java:41/GTMaterialRegistry.java:231 对 content.recipe 的反向依赖仍在。
  6. 特殊工艺输出丢失;MaterialTooltips 未完成 07-3 —— 部分解决(且新改动引入内置配方回归)

    • 已解决:SharedSpecialProcessRows.build(:181-221)改在任一物品或流体输出解析失败时整行返回 null 并计入 omitted(此前不会出现概率槽位错位,:201-202 严格成对追加);SharedSpecialProcessRows.java:75-80 未知配方表已改为告警跳过;en_us.json 与 zh_cn.json 中残留的 composition_nonmaterial / composition_descriptive 键已删除。
    • 仍未解决与新回归:
      • MaterialTooltips.java 仍未按 07-3 重建有效成分与状态展示;
      • 新增回归:SharedSpecialProcessRows.build(:205-209)将流体产物解析失败由跳过改为整行拒绝后,因 MaterialFluidUnitFacts.BINDINGS(:31-122)缺少 ChloroauricAcid(8400)与 StannicChloride(8402),导致 SpecialProcessMaterialFacts.java:136-187 内置的 Gold / Copper / Tin / Cassiterite 4 组王水浸出目标(共 8 条配方)在生成期被静默略过(仅汇总提示 "material forms or reagent did not resolve",未区分产物缺少单位绑定)。此外 omitted 仍缺少失败原因分类统计。
  7. compat.common 承载纯客户端布局引擎并反向依赖 compat.jei —— 部分解决

    • 已解决:MaterialProcessOverview 已下沉至 gregtech.client;RecipeMachines、PreviewViewport、WorldgenInfoData 已迁出 compat.jei 进入 compat.common(compat.common -> compat.jei 反向依赖已清零);RecipeViewerIcons.categories()(:18,51-63)已加静态缓存;MaterialProcessDisplay.Connection 已接线且 MaterialProcessPanel.java:325-326 已渲染 specialProcess 与 details。
    • 仍未解决:core Edge/Flow、Display.Connection/Flow、layout Edge 三套边模型与两套 confirmed 推导仍在;Port.tooltip() / Port.quantity() 仍无 UI 消费;且 RecipeViewerIcons.cachedCategories 暂无重载失效入口。

【原设计分歧解决情况】

  1. 08-D/E 未进入 api 公共契约 —— 设计定位已显式登记,代码边界未完全拆出

    • docs/decisions/material-system/README.md:54 与 data-api-and-publication.md:30-37 已明确将该能力登记为内部运行时与 viewer 数据层;但客户端组装用的 ViewerBuilder 与 viewerIcons 仍内嵌在服务端快照类 MaterialProcessSnapshot 中。
  2. 整类删除 MaterialBaselineTests 与测试取舍 —— 部分解决(文档已更新,验收边界待确认)

    • gametest.md:39、content.md:102、routes.yaml:121-125 与 junit.md:57 已同步现状与验证路由(并按约定跳过测试本身);但 07 步骤 2 中 chain / minecartWheels 消费端审计结论仍未补齐确认。

【原次要问题与文档同步解决情况】(非阻断)

  • 已解决:API 1.9 文档(ADDON_API.zh-CN.md / api.md / data-api-and-publication.md)、决策与 runtime.md 状态对齐、docs/roadmap/v1.0.md 恢复及 3 处断链修复、engine.md/tools/README.md/manual-ingame.md 同步;SpecialProcessMethods.java:38 双写前缀修复与 en_us.json 63 个新键补全;Store.previous、SpecialProcessesView.NONE、Target 不可达判空、depth_limit 文案错配清理;MachineRecipeOverlay 与 MaterialPublication 提交边界收口为 candidatePlatformGeneration → commit 两阶段;MaterialProcessPanel.valid() 与 MaterialProcessScreen 主入口失效关窗守卫;itemPort 催化剂端口化。
  • 未完全解决(非阻断):MaterialProcessOverview 共同输入压入 + 与按机器图标单侧折叠逻辑未变;输出 Role 全置 UNKNOWN、ExclusiveOutputMaps 仅作详情、Port.identity 仍被首个图标覆盖,且 MaterialProcessDisplay.Port.semanticIdentity()(:147)仅识别 resource/native/selector/ 前缀,漏掉了快照侧 itemSelector 生成的 resource/unit/.../selector/... selector;远程客户端 MachineRecipeClient.java:64-70 仍在同步线程本地重算且缺服务端 revision 校验包、过期 DataKey 返回空结果;steps.get(0) 图标跳转、Navigation.openForm 零调用、无失效提示文案仍在;SpecialProcessMethod.recipeMap 存在性与跨命名空间 Target 所有权校验缺口、SpecialProcessValue sealed 未改;14 个零 Java 引用的 gt6ce.jei.material_process.* 死语言键仍在并已复制到 en_us.json;SharedOreWashingRows.Snapshot 跨类复用、GregTechJEIPlugin.overlayGeneration 只写不读、MaterialProcessDisplay.Flow 恒为空、content.md:13 跨包事实写入来源未完整说明等细节仍保留。

@Tanimodori

Copy link
Copy Markdown
Member

对 masson 审阅意见的未修复项复核(832769666)

已在 832769666 下对照 lombinaxmasson 此前提出的全部问题复核(按约定跳过 CI、Spotless 格式化与测试覆盖相关条目,已在本轮修复的问题不再重复,仅列仍未修复或部分未修复项及直接关联回归):

【仍未修复 / 部分未修复】

  1. 展示快照构建失败路径仍保留上一代快照(部分未修复)

    • MachineRecipeOverlay.java:115 已在 overlay 失败路径调用 Store.clear(...),使该分支下双 viewer 的 valid() 失效;
    • 未修复点:MaterialProcessSnapshot.java:1039-1046 在 Store.publish 自身构建异常的 catch (RuntimeException) 分支仍仅记录日志并返回旧 current,未调用 clear 或发布带失败提示的空快照。此时 RecipeMap 与 overlay 已切换到新代,而两个 viewer 的 valid() 仍为 true,继续展示已从配方表删除的旧转换且无失败提示。
  2. 世界生成:数据包移除 biome modifier / placed feature 时仍不生效(未修复)

    • MaterialWorldgenFacts.java:110-119 仍仅读取 GEOLOGY/BEDROCK_ORES 配置开关与静态表(GTOreVeins、GTStoneLayersGen、GTBedrockOres),未接入当前服务端层实际生效的数据包/placed feature 状态;Snapshot.revision(:60-91)也未纳入数据包覆盖变化,Store.publish(:1023)仍直接复用意图过期的旧快照。
  3. 快照构建仍在配方发布事件线程同步执行(未修复)

    • RecipePublication.java:48-49,64-66 仍在服务端配方发布事件线程内同步调用 MaterialProcessSnapshot.Store.publish,执行全量 RecipeMap 扫描与组件/NBT SHA-256 计算(仅 :77 的 RecipeMap::prebuildLookupIndexes 延后至 server.execute);客户端 MachineRecipeClient.java:69-70 同样在 TagsUpdatedEvent 同步线程同步构建快照,长配方表下重载阻塞风险未消除。
  4. 全屏页与面板仍有未覆盖 valid() 守卫的交互入口(部分未修复)

    • MaterialProcessPanel.valid() / click() 与 MaterialProcessScreen.render / mouseClicked 已补守卫;
    • 未修复点:MaterialProcessScreen.java:47-55(stackAt / stackArea)、:103-116(mouseDragged / mouseScrolled)与面板顶部/信息卡片控制入口 MaterialProcessPanel.clickControls(:344-370,EMI 内嵌配方 MaterialProcessEmiRecipe.java:182 直接调用)仍未做 valid() 检查;在失效面板上点击全屏按钮仍会先打开 MaterialProcessScreen 再于首帧 render 关闭(此外 render 内直接同步 onClose() → setScreen 未延后到客户端队列)。
  5. JEI 捕获成本、空输入输出跳过与图标缓存失效(仅 getEmptyFocusGroup() 已修,其余 3 项未修复)

    • GregTechJEIPlugin.java:37-45 与 MaterialProcessJeiRecipes.java:36-100 仍在每次 onRuntimeAvailable(入服及 /reload)时遍历全部非信息类分类,并对每条非 GT 配方同步调用 createRecipeLayoutDrawable,无预算控制或分批;
    • MaterialProcessJeiRecipes.java:126-130 仍将 inputs.isEmpty() || outputs.isEmpty() 的配方直接记作 omitted 跳过,纯来源/纯用途配方无法进入材料图;
    • RecipeViewerIcons.java:18,51-62 的 cachedCategories 静态缓存缺少重载失效入口。
  6. 遗留死代码(文档已同步,以下死代码仍未清理)

    • MaterialPublication.java:42-44:platformGenerationPublished(...) 仍保留且全仓零调用;
    • MaterialProcessDisplay.Flow:生产侧(MaterialProcessProjection.java:102,115)仍恒传 List.of(),无任何真实构造方;
    • GregTechJEIPlugin.java:128-132:overlayGeneration 仍只写不读。

【由本轮修复直接引发的新回归(需重点关注)】

  • 流体产物解析失败改为整行拒绝后,4 组内置王水浸出目标(8 条配方)被静默丢弃
    • 832769666 按“产物失败整行拒绝”建议在 SharedSpecialProcessRows.java:205-209 将 firstFluid(...) 为空改为 return new BuildResult(null);
    • 但 MaterialFluidUnitFacts.BINDINGS(:31-122)未包含 ChloroauricAcid(8400)与 StannicChloride(8402),导致 resolveFluid(:336-337)对这两个流体恒返回 FluidStack.EMPTY,进而使 SpecialProcessMaterialFacts.java:136-187 中 Gold、Copper、Tin、Cassiterite 共 4 组王水浸出目标(每组 2 种输入形态,合计 8 条配方)在生成期被整行丢弃,仅输出笼统的 Omitted ... whose material forms or reagent did not resolve 汇总日志。建议为 8400/8402 补齐流体单位绑定(或改由 FluidCatalog 直查并区分产出失败诊断)。
  • 精确匹配试剂用量后的既有标注变化提示
    • SharedSpecialProcessRows.java:135-153 收紧 matches() 严格校验 reagentAmount 后,历史静态/数据包配方中试剂总量与 target.plan().reagentAmount() 不一致的行将不再自动获得 specialProcess 标注(属收紧匹配规则的预期代价,需确认是否符合预期)。

@lombinaxmasson

Copy link
Copy Markdown
Collaborator

832769666 审阅复核

建议修复以下问题后再合并。

  1. [P1] NeoForge 1.21.1 的 JEI-only 矿物页会漏掉原版和第三方配方。 GregTechJEIPlugin.java:35–44 在 onRuntimeAvailable 内同步创建配方布局。锁定的 JEI 19.57.0.450 在回调结束后才设置全局 runtime,布局构造却会立即访问它。JEI 捕获异常并返回空布局,采集器因此跳过这些配方。建议将采集安排到回调结束后的客户端任务,并在执行时确认 runtime 仍有效。

  2. [P2] 竹锯末等现有输入失去浸泡槽造纸配方。 BathMaterialRecipes.java:75 改为从 AnyWood 取固定成员。竹、橡胶木、处理木等原先符合 WOOD 筛选的材料被排除,其中竹的三种粉末仍会注册,但都进不了 pulp_dusts。建议保留原有输入范围,或明确记录这项玩法变更。

  3. [P2] 特殊工艺生成器会跳过合法的附属声明。 SharedSpecialProcessRows.java:331–340 要求已注册流体还具备内部 MATERIAL_FLUID_UNIT 条目,缺少该条目就会省略整条配方。同文件 :223–247 也无法处理合法的 anyForm(new Reagent()),因为生成器直接遍历空形态集合。建议按已发布形态解析试剂和产物,并补上附属流体及不限形态试剂的回归用例。

  4. [P2] JEI 把矿物副产物说明表当成真实加工步骤。 MaterialProcessJeiRecipes.java:81–87 在原生构建器拒绝 mFakeRecipe 后回退到通用布局采集。内置 ByProductList 因此会被画成同时消耗多个加工阶段的矿物形态,再一次产出所有副产物。建议让原生分支处理这类信息行,避免将其加入转换图。

  5. [P2] 远程客户端会显示服务端已经关闭的矿源。 MaterialWorldgenFacts.java:110–119 在远程客户端读取本地 COMMON 配置。服务端关闭地质或基岩矿、客户端保留默认值时,矿物页仍会列出对应来源。该路径也没有读取数据包实际启用的 placed feature。

  6. [P2] 快照构建失败后,查看器继续展示上一代配方。 MaterialProcessSnapshot.java:1039–1045 在捕获异常后保留旧 current。此时机器配方已切换,JEI 和 EMI 仍把旧页面判为有效。建议在失败时使旧快照失效,并覆盖一次“配方已提交、展示快照构建失败”的回归场景。

王水配方复核 通用生成器确实跳过八条内置声明,但 GTOreRecipes.java:88–95 仍走独立的静态注册路径,并使用支持流体目录回退的解析器。游戏中这八条配方的实际发布情况仍待运行验证。

本地验证 API 111 项、core 203 项测试通过,Forge 1.20.1 编译与 git diff --check 通过。:core:spotlessJavaCheck 仍失败,报告 24 个文件存在格式问题。JEI 和远程联机问题已核对调用链及锁定依赖源码,游戏内复现尚待补充。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants