MuPRO SDK开发例会 · 本次合并月度回顾全部期次

第 01 期 · 合并月报 / 2026.08.12 — 2026.09.12

MuPRO SDK 月度工作总结
与未来两周计划

数据处理、组件贡献和验证基础进一步完善;下一阶段集中打通 muFerro 从输入、运行到结果读取的完整程序化链路。

会议日期:2026-09-12回顾:08.12 — 09.12计划:09.13 — 09.26资料截止:2026-09-12 18:17 UTC
本次会议说明:上一个双周因赴沈阳参会,MuPRO 例会间隔延长至一个月。本期按截至今日的一个日历月窗口合并总结;后续恢复双周节奏。

01 / 月度概览

  • 材料计算的数据链路更完整。新增可选 HDF5 并行输出,并补强结构与材料导入、原生场文件读写、批处理、绘图和 VTK 互操作。
  • 贡献和验证有了统一入口。模块、runtime、C API 与 app 共登记 36 个组件,其中 11 个 app;构建和测试从真实依赖关系核对,贡献者可按组件运行相关检查。
  • 动态相场程序已接入并保留原版对照。新增 muAFM 和反铁磁模块;独立基础科学测试又找到了原版对照不能发现的磁场计算缺陷。
  • 发布方向已经明确。先交付 muFerro 的完整 alpha.1 链路,alpha/beta 不等待所有科学标准获批;正式版按冻结范围完成全部必选科学批准与实际构建验收。
  • 沈阳参会推进了 Computherm 交流。与曹伟生深入交流,已找回此前的密钥;计划先将 muPREDICT 更新到新模式,再与对方重新对接新版 PanPhaseField SDK。

当前判断:工程基础已有可复核成果,完整程序化交付仍在开发中。首个 alpha 的主要缺口集中在运行合同、显式路径、进度、结果和外部调用验收。

02 / 过去一个月的工作总结

以下按成果归类。标为「已提交」的实现已在当前 Git 历史中;「本地已验证」仍包含未提交改动,不等于已交付远端或已发布。

1. HDF5 并行输出落地 已提交 · 8 月中旬

新增 L1_HDF5,支持标量及多分量场、多个时间步、元数据和可选压缩;通过 MPI 分块写入及读回检查。可视化工具可直接读取 HDF5 中的场和时间序列,为后续大规模计算提供无损容器入口。

HDF5 默认关闭,既有 DAT/VTI 路径继续保留;模块能力已验证,各 app 的 HDF5 输出接线仍需逐项完成。依据:14a283fHDF5 集成记录

2. 客户文档与内部工程记录分离 已提交 · 8 月中旬

客户站迁至 web/,采用 Astro/Starlight;docs/ 专门保存内部合同、计划和验收记录。发布审计保留在站点构建流程中;完成相关仓库的归属盘点,历史报告和休眠源码统一归档。

文档体系迁移已完成,内容补齐仍有缺口:PR-105 的 13 页模块参考曾被忽略规则漏掉,当前仓库仍缺这些页面。依据:8618d52da9c3912101864参考页恢复记录

3. SDK 架构、依赖与科学证据体系整理 已提交 · 9 月上旬

runtime 提升至根目录,继续与数值模块编入同一库;第三方依赖固定来源和哈希,标量表达式引擎替换为 muparser。模块登记、实际源码依赖、能力索引与科学用例合同连通,验证工具可保留输入、源码、运行结果和候选证据。

源码分层不代表模块已支持独立运行或多个 runtime;候选证据也不产生科学批准。依据:8c0dbebf21f1e8cc3876adb117897228a51验证工具说明

4. 前处理、结果读取与运行生命周期补强 已提交 · 9 月上旬

补齐结构/材料文件导入、独立结构生成入口、MPI 数据读写和原生应用场格式读取;完善 DAT/HDF5/VTI/PVTI 的批处理与绘图,以及可视化 CLI/MCP。修复多处轴序、字段分量、CSV、日志、分配统计和 runtime 生命周期问题,并用真实 SDK 消费者和独立读取器验收。

当期覆盖原有 10 个 app 的工程盘点;记录中的数值行为变化和历史结果影响分别保留。依据:3a47aacf742fd1e9a7f032d9b41b9 月 8 日完成记录

5. 预发布闸门与 CI 证据归档落地 已提交 · 9 月 9–10 日

确认 alpha/beta/正式版的不同验收范围,首个 alpha 聚焦 muFerro。实现实际构建、安装、验收和原包字节绑定;修复 CI 因特殊文件名无法上传证据的问题,归档后上传并验证下载内容完整。

现有发布工具的本地验收不等于 alpha.1 完成。实际 muFerro 验收范围、汇总配置矩阵和可信科学批准回执仍待接通;未执行 SDK 发布。依据:23a6168f5b1b46发布与归档验收

6. 杨天南动态相场程序接入 本地已验证 · 9 月 11–12 日

将提供的双子晶格磁性程序接入为 apps/muAFM,新增 L3_Antiferromagnetic 承载耦合、薄膜边界及相关计算。保留 17 个原始源文件和来源哈希;18 个算例在 1/2/3 ranks、Debug/Release 下完成共 108 次原版与 SDK 对照,安装后独立消费也通过。

当前为 exploratory,保留原始程序的特定行为。它是新增应用能力,不扩大 muFerro-first alpha.1 的首发范围。依据:muAFM 接入记录应用合同

7. 基础科学检查产生了独立结论 本地已验证 · 9 月 12 日

三个磁学模块新增 18 项检查,覆盖 Maxwell 解析模态、各向异性能量梯度、LLG 步长收敛与模长、双子晶格不变量等。独立解析答案检出横向磁荷导数被覆盖的缺陷;普通 L2 路径已修复,原版一致性无法发现这一问题。

AFM 兼容路径仍显式保留原版行为,空间非均匀磁静力的正确性不能据原版对照推出。基础数学检查可继续实施,材料参数、温度律、一般噪声/多物理模型的有效性仍需科学判断。依据:基础科学检查与数值变化

8. 贡献接口、日常 Skill 与工具目录整理 本地已验证 · 9 月 12 日

11 个 app 统一登记并拥有自己的根构建入口;contribute.py 提供无需编译器的静态检查,以及依据真实构建图选择组件和下游测试的入口。新增项目/module/app 自查 Skill;23 处工具、数据和测试路径归位,旧命令保留兼容转发。内部例会报告有了固定位置。

继续打磨配置与状态、字段所有权、生命周期、失败语义;统一调用链尚未交付。依据:贡献指南接口审阅工具归属根目录职责

9. 沈阳参会与 Computherm 交流 交流已完成 · 后续待推进

赴沈阳参会期间,与 Computherm 的曹伟生进行了深入交流。此前的密钥已经找回,准备与对方重新对接新版 PanPhaseField SDK。

推进顺序:先把 muPREDICT 更新到新模式,再重新对接 PanPhaseField SDK。muPREDICT 更新是此次对接的前置工作。

依据:owner 于 2026-09-12 补充的参会情况;新模式的具体改动范围、SDK 版本与对接时间尚未展开。当前记录的是交流进展和后续意向,未形成已完成集成的结论。

03 / 当前开发与验证进度

按实际执行日期与配置记录;不同配置的测试数量不能相加作为项目完成度。
范围截至今日的证据解释与边界
Intel Debug803 / 803 通过 · 09.12全应用配置,HDF5 OFF;本机记录
Intel Release802 / 802 启用项通过 · 09.12另有 2 项既有 Debug 专用检查禁用;本机记录
Intel core Debug652 / 652 通过 · 09.12基础配置,HDF5 OFF;本机记录
HDF5 core Debug735 / 735 通过 · 09.08本月已有验收,本轮未重跑;历史配置与消费证据
Python 工具258 项 + 113 subtests 已验证 · 09.12首次 257 项通过,1 项 MCP stdio 超时;允许本机通信后针对当前源码重跑通过,属于两次记录。
安装与搬迁消费Debug/core SDK 与 Python 工具通过Debug 消费 22 模块、核对 11 app;core 消费 13 模块;本机摘要
原版一致性 / 基础科学108 次原版对照;每个全应用配置 18 项新检查通过两类证据分别保留;不授予模型或标准批准。

9 月 8 日同批工程验收为 Debug 720、Release 719、core 650;后续增加 app 登记、AFM 和独立检查后形成上表。测试数量变化说明验收范围发生变化,不用于推算软件完成百分比。

三个状态分别看:工程回归已有通过证据;科学登记为 1 个 candidate、0 个 approved、35 份 not_standardized 声明;alpha.1 的完整安装调用链仍待验收。后者当前不能写成「已可发布」。

本月 CI 归档修复已在 9 月 10 日的记录中验证上传和下载,本报告未重新查询线上任务或推定 runner 当前健康。Linux/Intel 之外的平台不扩大支持声明。原始失败和重试保留,报告编写未重新运行数值求解器。

04 / 后续两周计划:09.13 — 09.26

建议本周期主验收目标:从安装包、在任意工作目录,以显式输入/输出路径完成一次 muFerro 运行,读取运行中进度及有来源的最终结果;失败能说明原因,重复运行互不污染。

以下依据 TASK 的 P3/P4/P11 → P1/P10 → P5/P6 → P7/P8 依赖顺序安排。优先级与完成条件明确,具名执行人和容量由例会落实;本报告不新增 alpha 发布日期承诺。

第一周 · 9 月 13–19 日:先让算例准备与失败可判定

  1. 运行合同与三个 manifest(P3/P4/P11)。明确输入文件闭包、case 身份、每次运行的独立身份、结果/完成记录,以及 retryable/terminal 失败分类。交付:最小合同、schema 与校验入口。验收:输入缺失或被修改、残留成功标记、失败后重试和并发目录互相覆盖均有可复现反例;不能只凭状态码名字判断可重试。
  2. muFerro 显式入口的最小实现(P1)。实现输入校验与 --input--output-dir--help 等入口,复用既有求解流程。验收:在仓库外目录准备/启动算例,help 在 MPI 初始化前返回;非法输入产生清楚的失败结果。
  3. 收尾现有已验证改动。按 muAFM、贡献框架、科学修复、工具与文档分别整理审阅和提交材料。验收:每个主题有对应范围、实际证据及兼容说明,数值变化单列,原始源码及 108 次对照证据可追溯。

第二周 · 9 月 20–26 日:接通结果,并用安装包验证

  1. 运行中进度与标量结果(P10/P4)。先暴露 muFerro 已有结果中的一个关注量(QoI),声明名称、单位或单位未指定、计算定义及来源文件,不重选公式。验收:结束前能读取进度;最终值与原有输出一致,缺失或非有限结果、未完成输出不能被读取为成功。
  2. 安装后链路与能力说明(P1/P5/P6,衔接 P0)。从搬迁后的 SDK 运行真实算例,检查输入、run/result manifest、退出状态和结果闭包;补齐这条链路的能力索引、帮助与可执行 Skill。验收:一个成功场景和非法输入、运行失败、重复运行场景都可复现,索引如实声明已支持范围,验收绑定实际安装包。
  3. 回归与例会交付。对改动影响的模块、下游 app 和安装边界执行检查;涉及共享运行/构建合同的改动补足完整配置回归。交付:可演示的 muFerro 样例、验收摘要,以及下一周期剩余问题。

依赖完成后的延伸项

若上述主链路提前完成,再实施 P7 的三个参数点真实并发与三个可追溯 QoI,以及 P8 的真实 MCP 客户端发现、校验、启动、监控、取结果。现有可视化 MCP 的通过记录不能代替求解器运行链验收。

可并行、但需要明确容量的工作

  • 接口与科学检查:围绕配置/求解状态分离、字段所有权和 context 重复生命周期逐项补合同与独立检查;muAFM 继续保留原版兼容证据。数学上可判定的内容直接验证,材料模型疑问形成具名审阅材料。
  • 客户参考页:按已有恢复步骤寻找原工作机源文件或构建产物,恢复后核对 13 页和侧边栏链接,并补构建检查;资料无法取得时记录具体阻塞,再决定重写。该项不替代主运行链。
  • muPREDICT 更新与 Computherm 对接准备:明确 muPREDICT 新模式的改动范围与完成条件,安排更新;完成后再与曹伟生重新对接新版 PanPhaseField SDK。先落实这条前置依赖,具体实施和对接日期待排期。

GPU、多 runtime、in-process Python 求解、全部 app 同时统一、ACCH/CALPHAD 和全量科学批准不列入这两周的主验收目标,仍按既有后续路线推进。

05 / 未完成与需协调事项

  • 运行链仍有实质工作。11 个 app 的登记和既有可执行文件,不等于统一 CLI、manifest、Python/MCP 已经支持它们;beta 的接口冻结与真实场景验收也尚未完成。
  • 科研与维护责任需落到人。36 个维护人字段仍为 unassigned。需要分配模块维护和科学标准审阅责任;缺少批准不阻塞可判定的基础检查或合格的 alpha/beta。
  • AFM 兼容模式有已知限制。原版对照继续作为来源兼容依据,空间非均匀磁静力修正模式应单独定义和验证;材料标定、温度律与噪声/多物理模型不能从当前数学检查直接推定。
  • 历史结果和客户文档仍需收尾。既有数值修复的历史算例影响与客户告知、外部仓库遗留问题仍按 H2/OWNER-007 等已有责任线处理;13 页客户模块参考当前未恢复。
  • 发布工程待接入真实产品范围。P0 还需完整 muFerro 验收、组合配置矩阵及可信批准回执;本月完成的是相关工具与局部验证,未发布 SDK。

06 / 证据与报告口径

工程证据范围为 muprosdk 单仓库,2026-08-12 至 2026-09-12,按 America/Los_Angeles 时区归集;另纳入 owner 于 2026-09-12 补充的沈阳参会与 Computherm 交流情况。实际上一场会议的精确日期未提供,本次采用截至今日的一个日历月窗口,并非追认某日已召开会议。

本地 Git 基准:11c1b7818114bd09ed4a1f20de78e33ea1c8497b。技能脚本按日采集全体作者,去除合并提交后共有 58 个唯一提交;这只是追溯口径,不衡量工时或生产率。当前工作树还有未提交改动,分别按其实现文件与已有验收记录纳入。

  • 当前工作包与发布定义 · 当前交接 · 历史交接
  • HDF5 实现与边界 · 文档站决策 · 模块与应用完成记录
  • 发布工具/CI 验收 · muAFM 对照 · 独立科学检查
  • 按日 Git 证据(本机) · 最新回归与安装摘要(本机) · Python 首次执行(本机) · MCP 定向重试(本机)

out/ 不随 Git 转移;另一台机器需要取得原始证据或重新执行。历史报告保持原日期与配置,不把当时未验证项目推定为今天通过。修订说明:2026-09-12 应本次会议安排,将同日的两周草稿扩展为本月总结并细化后续两周计划;修订前副本保留于本机证据目录。

补充说明:2026-09-12 按 owner 的参会补充,加入与 Computherm 曹伟生的交流、此前密钥已找回,以及「muPREDICT 新模式更新 → 新版 PanPhaseField SDK 重新对接」的顺序。工程资料截止时间与测试证据沿用原记录。