Repository navigation
Conversation
…o material-sys-refactor
Tanimodori
left a comment
There was a problem hiding this comment.
审阅结论
对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*。 - 影响:调整
MaterialDefinitionspass 顺序或同 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等死代码未清理。
【设计分歧】
-
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/图标缓存从服务端快照类拆出。
- 当前
-
整类删除
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 自动化回归,或补回最小核心端到端测试集。
- 本 PR 除清理一次性 TSV 对比脚手架(
【文档同步情况】
- 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路由。
补充审阅(未重复上一条审阅已覆盖项)已核对 Tanimodori 的审阅,以下只列其未覆盖或需要补充的点;已覆盖的 NeoForge Mixin、JEI/EMI 数据源分裂、有界图预算、世界生成配置开关、材料事实收口、删除 [P2]
|
修复复核(
|
对原审阅意见的复核(
|
对 masson 审阅意见的未修复项复核(
|
|
概要
本 PR 在已合入的 #374(材料系统重构 01–06、08-A~C)之上,完成 07-A~E 的清理与 08-D/E 的接入:
content.material.catalog的类型化 process 事实,由MaterialFactKeys单一读取;SOURCES/USES/BOTH查询与材料页直连查询;本 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等重复名单和旧事实入口。WoodMaterialCompositions、PanelMaterialCompositions、TransportMaterialCompositions;配方类只负责发布配方。2. API 1.9:特殊工艺声明
SpecialProcessMethod、SpecialProcessValue.Target、SpecialProcessValue.Reagent、SpecialProcessesView。MaterialCatalogView.specialProcesses()与MaterialInfoTool.Registrar.registerSpecialProcess(...)提供只读声明入口。MaterialProcessKey绑定;SharedSpecialProcessRows生成配方,MaterialTagPack从同一规则派生 target/reagent 标签。SourcePurifiedAcidRules/SourcePurifiedAcidData/SharedPurifiedAcidRows的酸洗专用路径,改由SpecialProcessData、SpecialProcessMaterialFacts、SpecialProcessMethods驱动。3. 08-D:同代快照与有界处理图
MaterialProcessSnapshot:在RecipePublication成功提交后,把最终机器配方、已发布形态、活动 tag 和启用世界生成绑定到同一个发布戳/revision。MaterialProcessGraph:SOURCES、USES、BOTH递归遍历及材料页直连查询;DataKey;未新增网络协议,客户端使用原版同步配方、材料定义和 datapack 世界生成配置重建。MaterialWorldgenFacts只投影当前活动的矿脉、小矿、岩层和基岩矿事实;世界生成 revision 按完整事实字段和稳定材料名计算。4. 08-E:JEI/EMI 共用材料处理页
MaterialProcessDisplay、MaterialProcessProjection、MaterialProcessOverview、MaterialProcessPanel、MaterialProcessArrows、MaterialProcessScreen,供 JEI 与 EMI 共用同一页面模型、布局和交互。gt6ce:material_process,显示名“矿物处理”;EMI 通过MaterialProcessEmiRecipe、MaterialProcessEmiRecipes和两个 mixin 接入相同的快照、索引和查询目标。↗、回流↩和确认/未确认关系;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 准入和人工验收步骤。兼容性与审查重点
RecipePublication成功代发布。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:成功。MATERIAL_LOADING_PROBE_PASS assertions=11;6000 条配方、每材料 9,000,000 条逻辑关联,405 ms。git diff --check origin/master...material-sys-refactor:无输出。尚未执行
master后未在最终 merge commit784508b7c上重跑上述检查;请以该 commit 为准在 CI/本地重跑。建议的审查顺序
api/common/.../SpecialProcess*与MaterialFactKeys:确认 API 1.9 是增量契约,没有恢复第二套事实权威。MaterialProcessSnapshot与MaterialProcessGraph:确认发布戳、revision、跨材料索引、预算和旧引用拒绝逻辑。MaterialProcessProjection/MaterialProcessOverview/MaterialProcessPanel:确认没有按图标猜关系,隐藏辅料和副产物仍保留在原生配方。关联
Refs #351。基于 #374。