Repository navigation
[DEV P0 AUDIT · DO NOT MERGE/CLOSE] Living correctness and real-hardware test ledger · master #61 - #75
[DEV P0 AUDIT · DO NOT MERGE/CLOSE] Living correctness and real-hardware test ledger · master #61#75hydrogen1222 wants to merge 1 commit into
Conversation
Documentation only in pull request body; no tree changes. DATA IMPACT: no scientific record invalidated.
Round-1 supervisory review — 2026-10-31 (main @ 1ef9a1b)Reviewed the source diffs, PR bodies and GitHub CI check-runs for audit PRs #76–#79. All four have green applicable GitHub Actions on Python 3.10–3.13; none has been merged. These are code/CI reviews, not independent full GPU science reproductions.
Review comments were posted on the four implementation PRs. No approval, merge, close or feature change occurred. Keep this PR open and Draft; update this tracker only with actual red/green evidence and merged fixes. |
…cating AUD-001 (tracker #75). TrajectoryDataset.load cast the finite raw/md.csv "step" column with astype(int), so steps 0.5, 1.5, 2.5, 3.5 loaded as 0, 1, 2, 3. The fabricated indices were then re-exported as the step axis (thermodynamic_diagnostics "step" column) and used to recompute frame_stride_steps in analysis_view()/slice_frames(). A step beyond the int64 range wrapped as well, with a numpy "invalid value encountered in cast" RuntimeWarning. Step indices are integers by contract: mliport writes int steps and _uniform_integer_step already treats non-integral values as unknown. Add _validated_steps(), which requires finite, integral, in-range values, and use it in both cast sites (TrajectoryDataset.load and TrajectoryDataset.from_frames). Invalid input now fails closed with a clear ValueError instead of being silently reinterpreted. Tests (red before the fix, green after): test_fractional_md_csv_steps_are_rejected_not_truncated test_out_of_range_md_csv_steps_are_rejected test_from_frames_rejects_fractional_steps test_integral_float_md_csv_steps_still_load (guard) DATA IMPACT: no scientific record invalidated. No stored trajectory is rewritten; only the handling of an already-invalid step column changes, from silent truncation to an explicit error. Tracking: #75
…float AUD-001 review follow-up (tracker #75, PR #76). _validated_steps() began with np.asarray(values, dtype=float), so an integer input such as steps=[2**53 + 1] silently became 2**53 before the integrality/range checks could see it, and the md.csv step column was parsed through float() for the same reason. The symmetric abs() >= 2**63 bound also rejected the representable int64 minimum -2**63. Dispatch on the input dtype instead: * integer input is never routed through float; only the asymmetric int64 range is enforced (so -2**63 is accepted, 2**63 is rejected); * float input must be finite, integral and within the exactly representable float range (|v| <= 2**53); * a CSV step column is parsed exactly from its text with Decimal, so "9007199254740993" and "9007199254740993.0" both keep their exact integer value. A finite non-integral cell is rejected; blank, unparseable or non-finite cells keep the pre-existing "axis unknown" fallback (unchanged, tracked separately). Regressions added (red before this commit, green after): test_from_frames_preserves_large_integer_steps_exactly test_from_frames_accepts_int64_min_and_rejects_overflow test_md_csv_huge_integer_step_text_is_parsed_exactly test_md_csv_float_literal_step_keeps_its_exact_integer_value test_md_csv_unparseable_step_makes_the_axis_unknown DATA IMPACT: no scientific record invalidated. No stored trajectory is rewritten; only the handling of a step column changes. Tracking: #75
AUD-003 (tracker #75). OptimizationRunner.run caught every non-NaN optimizer/calculator exception, logged it, re-evaluated energy/forces and returned results with converged=False. classify_result maps that to NOT_CONVERGED (exit 2), so a backend crash was indistinguishable from an honest "hit max_steps" run: exit 2 instead of 1, queue status "not_converged" instead of "failed", and no record of the error outside the log. This contradicted docs/workflows/optimization.md, which promises that "a backend or runtime error exits with 1, and partial results are kept". Keep the partial results, but record the failure: set results["status"] = "failed" and results["error"] to the exception summary. JsonWriter now carries status/error into mliport_results.json for optimization runs instead of dropping them. The NaN/inf abort path still re-raises. Tests (red before, green after): test_optimizer_exception_is_reported_as_failed_not_non_convergence test_optimizer_exception_is_recorded_in_results_json DATA IMPACT: no scientific record invalidated. No stored trajectory or structure is rewritten; only the outcome classification and the machine-readable record of an already-failed optimization change. Tracking: #75
AUD-003 review follow-up (tracker #75, PR #78). BaseRunner deferred only the ``done`` progress phase, and OptimizationRunner emitted ``done`` ("Optimization not converged ...") even after an optimizer exception, so a UI/progress consumer received a success-looking terminal phase for a failed run. * _emit_progress() now defers the ``error`` phase as well as ``done``, and execute() publishes the deferred terminal event with the timing attached, so the terminal phase reflects the outcome. (Renamed the private _pending_done_event to _pending_terminal_event.) * OptimizationRunner emits an ``error`` event when the optimizer crashed; an honest max_steps non-convergence still ends on ``done``. * The post-crash energy/force re-evaluation is wrapped: if it also fails, the raised error names both causes and chains the second via __cause__ instead of replacing the original crash. CancellationRequested is excluded from that wrap so a cancel stays a cancel. Tests (red before, green after): test_failed_optimization_publishes_error_not_done test_reevaluation_failure_keeps_the_original_crash test_cancellation_during_reevaluation_is_not_wrapped guards: test_honest_non_convergence_still_publishes_done DATA IMPACT: no scientific record invalidated. Only the terminal progress phase and the failure message of an already-failed optimization change. Tracking: #75
Review round 2 — 2026-11-01 · main @ 77a94af
Only GitHub source diffs and CI evidence were reviewed by the supervisor. No real MLIP GPU inference independently executed. No merge or status change performed by reviewer. Keep #75 open and update status/checkboxes only where accepted evidence is recorded. |
…coercion AUD-001 round-2 review follow-up (tracker #75, PR #76). _validated_steps still began with np.asarray(values), so a heterogeneous Python sequence such as [2**53 + 1, 2.0] was promoted to float64 and the integer was silently rounded to 2**53 before any dtype check could see it -- exactly the data-identity failure AUD-001 exists to prevent. * An np.ndarray keeps the vectorised dtype path (_validated_step_array). * Any other sequence is validated element by element via the new _step_index(), which checks Python int first (exact, never through float), then float (finite / integral / |v| <= 2**53), and rejects everything else. The int64 array is only built afterwards, so numpy promotion can no longer round a value. Secondary hardening: _parse_step_column now compares the Decimal against the int64 bounds before int(integral). This is a real robustness fix, not just a micro-optimisation -- on the previous commit int(Decimal("1e999999999")) tried to build a ~10**9-digit integer and the process hung. Regressions (red before, green after): test_from_frames_preserves_mixed_integer_and_float_steps_exactly test_from_frames_rejects_invalid_mixed_sequences (4 parametrised cases) test_md_csv_astronomical_step_exponent_is_rejected DATA IMPACT: no scientific record invalidated. No stored trajectory is rewritten; only the handling of a step axis changes. Tracking: #75
Round-3 review update — 2026-11-01, main @ 77a94af
No automatic merges, approvals, scientific data rewrites or physical GPU revalidation performed in this review. Keep #75 open as the audit tracker. |
AUD-007 (tracker #75). No production behaviour changes; test-only plus one documentation sentence. confsearch: the engine already checkpoints the per-replica md_rng/mc_rng bit-generator states after every unit and restores them in _restore(). The new test kills a run after every durable unit boundary (1-3 units for one replica / three cycles, 1-4 for two replicas / two cycles) and asserts the resumed run's search_results.json is identical to an uninterrupted run's, apart from model.model_path (not identity). Verified non-vacuous: skipping the RNG restore or perturbing the restored geometry each make it fail. NEB: the checkpoint stores the whole band plus band_sha256, and the loader verifies the checksum and re-validates the band. The new tests show the resumed attempt starts from a byte-identical band, that the interrupted attempt's checkpoints and exports survive, and that the resumed run converges to the same climbing image and saddle. NEB has no stochastic optimizer, so there is no generator state to restore. The checkpoint is geometry_resume_only, so a resume restarts the optimiser instead of replaying its state: in the fixture the barrier is 0.9592721 eV uninterrupted vs 0.9590986 eV resumed (~2e-4 eV). That limitation was already recorded in the checkpoint and run_context.json; document it in docs/workflows/neb.md and its Chinese twin as well. DATA IMPACT: no scientific record invalidated (test-only + docs). Tracking: #75
… review) Independent-review follow-up on PR #81. Two defects found by fault injection; neither touches the integrator, model inference, energy or forces. 1. The post-run guard could not correct the OUTCAR it had already written. MDOutcarWriter.finalize() returned early once _finished was set, so when _write_artifacts_manifest(status="completed") failed -- the exact boundary the guard exists for -- the corrective finalize(status="failed") was a silent no-op and the OUTCAR kept claiming "completed" for a run that raised. finalize() now appends a corrective summary when the status differs (the earlier block is kept: evidence is never deleted) and the last Status: line is the authoritative one. 2. Best-effort reporting could mask the original exception. The pre-existing terminal handlers (output drain, force abort, cancellation, Ctrl-C, generic failure) called finalize() and _write_artifacts_manifest() unguarded, so a reporting OSError replaced the real cause: a cancelled run with a full disk was classified FAILED (exit 1) instead of CANCELLED (exit 130). The post-run guard's own best-effort pattern is now one publish_terminal() helper used by every terminal path, so reporting failures are suppressed and the original exception always propagates. Regressions (red on 8eee6f2, green now): test_md_manifest_write_failure_does_not_leave_a_completed_outcar test_md_cancellation_survives_a_manifest_write_failure DATA IMPACT: no scientific record invalidated. No stored trajectory, md.csv or energy/force value changes; only the terminal status trailer of a failed MD OUTCAR and which exception propagates from a reporting failure. Tracking: #75
Model-support round · callable checks on the V100 host (2026-11-14)Evidence for #61 model-support spec Rev 2 §5. Scope: "called correctly", not accuracy. Environment
Structures:
Commands (per model; mliport doctor --engine E --device D --model M --task bulk [--head H] [--dtype D] \
--structure examples/structures/li10gep2s12_primitive.vasp
python scripts/validate_runtime.py E M report.json --device D --task bulk [--head H] \
[--dtype D] --full --raw-dir raw/
Identity read-out (verbatim from the artifacts)
Directory hashes are sha256 over sorted Results · MACE
Results · DPA
Results · GRACE
Results · UMA
CPU vs GPU agreement (§5.3)Same model, same 50-atom LGPS cell, same task/head/dtype; forces compared
On the Cu probe fixture the same comparison gives |ΔE|/atom ≤ 5e-07 eV and Failures found by these runs (verbatim) and their fixes
Residual gaps
|
Model-support round · UMA callable checks on the V100 host (2026-11-14)Follow-up to the model-support evidence comment, Same host and conventions as the previous comment: Tesla V100-SXM2-16GB Checkpoints
All three local sizes equal the upstream tree listing byte-for-byte. License:
|
| Check | cpu | cuda:0 |
|---|---|---|
mliport doctor single point (50 atoms) |
failed: checkpoint corrupt | failed: checkpoint corrupt |
validate_runtime.py --task omat --full |
failed: checkpoint corrupt | failed: checkpoint corrupt |
uma_s_1p2p1_omat — verified on both devices
| Check | cpu | cuda:0 |
|---|---|---|
mliport doctor --task omat --structure li10gep2s12_primitive.vasp |
passed, E=-216.344373 eV, stress checked | passed, E=-216.344373 eV |
validate_runtime.py --task omat --full (Cu) |
passed: SP, shared calculator, FD, 10 NVE, 5-image NEB | passed: same |
| recorded identity | task: omat, inference_mode: default, inference_preset: batch, nitro_enabled: false, tf32_enabled: false, compile_enabled: false |
same, actual_device_type: cuda |
LGPS CPU–GPU: |ΔE|/atom = 1.03e-08 eV, max |ΔF| = 3.40e-06 eV/Å.
Turbo single point (GPU, §11 task 1 second half):
| Run | Recorded identity | Energy (LGPS) |
|---|---|---|
mliport sp ... --inference-mode turbo |
inference_mode: turbo, inference_preset: multigpu, nitro_enabled: false, tf32_enabled: true, compile_enabled: true |
-216.344368 eV |
So --inference-mode turbo reproduces upstream's "turbo's former settings"
(multigpu) and still cannot select Nitro.
uma_s_1p2p1_ft_r2scan_omat — callable, NEB refused by the physics gate
| Check | cpu | cuda:0 |
|---|---|---|
mliport doctor --task omat --structure li10gep2s12_primitive.vasp |
passed, E=-417537.948266 eV, stress checked | passed, E=-417537.948269 eV |
| probe single point / FD / 10 NVE | passed | passed |
| probe 5-image NEB | refused (verbatim below) | refused |
| recorded identity | inference_preset: batch, nitro_enabled: false, tf32_enabled: false |
same |
LGPS CPU–GPU: |ΔE|/atom = 4.57e-08 eV, max |ΔF| = 4.11e-06 eV/Å.
The NEB leg stops in mliport's own gradient preflight, which is the intended
fail-closed behaviour and not an adapter defect:
mliport.neb.schema.NEBGradientConsistencyError: NEB refused: the model's forces
are not verifiably the gradient of its energy (12/12 checks failed; worst:
image 4, force direction, an energy resolution too coarse to discriminate the
derivative (noise allowance 1.62 eV/A); use float64 or a smaller cell). NEB
optimizes with these forces, so the band and any barrier would be meaningless.
Use a conservative (autograd-force) model or precision.
Reason: the r²SCAN head carries total energies of order -1.8e5 eV for the tiny
Cu fixture, so float32 energy differences at a 1e-3 Å displacement are inside
the numerical noise. Single point, finite-difference forces and MD are fine; NEB
on that model/precision/cell is unsupported, and mliport says so instead of
producing a band.
Residual gaps
uma_omatis blocked by a corrupt local checkpoint; re-download needed.- UMA Nitro is never exercised by design (mliport refuses nitro presets);
themultigpupreset was verified on Volta, where TF32 is a no-op. - The NEB inside the probe is not saddle-validated (
saddle_validation: not_performed), and the LGPS cell gets single points only (the probe caps the
fixture at 32 atoms). - No accuracy statement of any kind.
LGPS CPU–GPU agreement · complete table (2026-11-14)Follow-up to the MACE/DPA/GRACE comment
Measured maxima across every profile: 6.10e-07 eV/atom and |
Tracking: #61 (model-support spec §6.5 + §11 tasks 1 and 5) What changes: - The status table leaves its initial state and carries what was measured on 2026-11-14 on the owner's V100 in the installer-built environments: 17 profiles `verified` on CPU and GPU (15 MACE/DPA/GRACE + the two UMA `uma-s-1p2p1` checkpoints), each with finite energy/force/stress on the 50-atom LGPS cell, a matching recorded identity and the bounded probe (shared calculator, central differences, 10 NVE steps, five-image NEB). - UMA rows filled from §11 task 1: `uma_s_1p2p1_omat` and `uma_s_1p2p1_ft_r2scan_omat` verified on both devices and recorded with `inference_preset: batch`, `nitro_enabled: false`, `tf32_enabled: false`; `--inference-mode turbo` records `multigpu` with `nitro_enabled: false`. The r2SCAN fine-tune's NEB leg is refused by the gradient preflight (energy resolution), which the table states instead of hiding. - `uma_omat` stays `untested`: the local `uma-s-1p2.pt` fails the zip CRC (`PytorchStreamReader ... data/115`), the repository is gated and this host cannot re-fetch it. - The CPU-GPU claim now quotes the measured maxima (6.1e-7 eV/atom, 7.5e-6 eV/Angstrom, `mace_omat_float32`) instead of a rounded "1e-7/1e-5 or better". - Every Evidence cell links the specific #75 comment (runs, deltas, UMA record, NEP89 record) instead of the pull request. DATA IMPACT: no scientific record invalidated. Statuses describe calling the models correctly; no accuracy claim is made and no stored campaign record changed.
|
| Item | Value |
|---|---|
| SHA-256 | ba5c0d912efa22dc238e5fb1b5b7f66ee2e68c48c1b95b7cfd7fe1da5938398b |
| Size | 2333393167 bytes (matches checkpoints/uma-s-1p2.pt in the upstream tree) |
| Container | zipfile.testzip() → clean over all 315 members |
| Upstream pin | matches validation/science/model_manifest.json profile uma_omat (ba5c0d912efa…) |
| Task list | omat (UMATask: omol, omat, odac, oc20, oc25, omc) |
The previous copy had the same size but failed the CRC on
inference_ckpt_stage2/data/114, so it was a transfer corruption, not an
adapter problem.
Checks (Tesla V100-SXM2-16GB, driver 580.173.02, fairchem-core 2.25.0 / torch 2.13.0+cu126)
| Check | cpu | cuda:0 |
|---|---|---|
mliport doctor --engine uma --task omat --structure li10gep2s12_primitive.vasp |
passed, E=-216.30181 eV, stress checked | passed, E=-216.30181 eV |
validate_runtime.py --task omat --full (Cu fixture) |
passed: SP, shared calculator, FD, 10 NVE, 5-image NEB | passed: same |
| recorded identity | task: omat, inference_mode: default, inference_preset: batch, nitro_enabled: false, tf32_enabled: false, compile_enabled: false |
same, actual_device_type: cuda |
LGPS CPU–GPU: |ΔE|/atom = 3.60e-09 eV, max |ΔF| = 5.70e-06 eV/Å
(E = -216.30180917 eV on CPU, -216.30180899 eV on GPU).
NEB inside the probe is the usual bounded band with relaxed endpoints and
saddle_validation: not_performed; no accuracy claim is made.
Status
uma_omat: untested → verified on CPU and GPU. The previous "blocked"
note in the UMA comment stands as history for the corrupt artifact; this comment
replaces it for the status table.
Tracking: #61 (model-support spec §11 task 1, re-check) The earlier `uma-s-1p2.pt` copy had the right size but failed the zip CRC; the owner re-downloaded it and the new file is clean: 315 members pass `testzip()`, and its SHA-256 `ba5c0d912efa…` matches the pinned `uma_omat` profile in `validation/science/model_manifest.json`. Measured on the same host (Tesla V100-SXM2-16GB, driver 580.173.02, fairchem-core 2.25.0 / torch 2.13.0+cu126): - `mliport doctor --task omat --structure li10gep2s12_primitive.vasp` passes on cpu and cuda:0 (E = -216.30181 eV, stress checked); - `validate_runtime.py --task omat --full` passes on both devices (single point, shared calculator, central differences, 10 NVE steps, five-image NEB); - recorded identity `inference_preset: batch`, `nitro_enabled: false`, `tf32_enabled: false`, `compile_enabled: false`; - LGPS CPU-GPU: |dE|/atom 3.60e-09 eV, max |dF| 5.70e-06 eV/A. The table now shows 18 profiles `verified` on CPU and GPU, the Chinese table is translated column by column (dtype and evidence cells were still English), and the Evidence cell points at the re-check record in #75. DATA IMPACT: no scientific record invalidated. The previous "blocked" note stays in #75 as history for the corrupt artifact.
Tracking: #61 (model-support spec §6.5 + §11 tasks 1 and 5) Rebased onto `main` after #94, #96 and #97 merged, so this carries only the status-table change. What changes: - The status table leaves its initial state and carries what was measured on 2026-11-14 on the owner's V100 in the installer-built environments: 18 profiles `verified` on CPU and GPU, each with finite energy/force/stress on the 50-atom LGPS cell, a matching recorded identity and the bounded probe (shared calculator, central differences, 10 NVE steps, five-image NEB). - UMA rows from §11 task 1: `uma_omat`, `uma_s_1p2p1_omat` and `uma_s_1p2p1_ft_r2scan_omat` verified on both devices and recorded with `inference_preset: batch`, `nitro_enabled: false`, `tf32_enabled: false`; `--inference-mode turbo` records `multigpu` with `nitro_enabled: false`. The r2SCAN fine-tune's NEB leg is refused by the gradient preflight (energy resolution), which the table states instead of hiding. `uma_omat` needed the re-uploaded checkpoint: the first copy had the right size but failed the zip CRC; the new file matches the pinned manifest hash `ba5c0d912efa...`. - The CPU-GPU claim quotes the measured maxima (6.1e-7 eV/atom, 7.5e-6 eV/Angstrom, `mace_omat_float32`) instead of a rounded "1e-7/1e-5 or better". - Every Evidence cell links the specific #75 comment (runs, deltas, UMA record, re-check, NEP89 record) instead of the pull request. - The Chinese table is translated column by column; it previously carried the English dtype and evidence cells. DATA IMPACT: no scientific record invalidated. Statuses describe calling the models correctly; no accuracy claim is made and no stored campaign record changed.
DPA-SSE reference values · original runtime (deepmd-kit 3.0.0b3 + torch 2.3.1)Evidence for #61 DPA-SSE spec §2.1. These are the numbers a conversion or a Artifacts
Runtime that loads the original file unmodified
Structures
All three contain only elements from the model's training list; Reference values (float64, CPU, virial in eV, 3x3 row-major){
"runtime": {
"deepmd-kit": "3.0.0b3",
"torch": "2.3.1+cpu",
"python": "3.12",
"precision": "default (=float64 in deepmd-pt)"
},
"lgps_primitive": {
"formula": "Ge2Li20P4S24",
"atoms": 50,
"energy_eV": -226.088601521,
"forces_eV_A": [
[
0.007015,
-0.014847,
-0.031144
],
[
0.022789,
0.010903,
0.028326
],
[
0.005196,
0.007061,
-0.030123
],
[
0.000593,
-0.006614,
0.019599
],
[
0.023264,
0.025453,
0.03796
],
[
-0.025446,
-0.000844,
0.023252
],
[
-0.000423,
-0.03947,
-0.004332
],
[
-0.012887,
-0.01258,
0.006172
],
[
0.001488,
-0.005003,
-0.01709
],
[
-0.011884,
0.016481,
-0.000751
],
[
0.021289,
0.016951,
0.005585
],
[
-0.043332,
-0.015528,
-0.061074
],
[
0.005363,
0.004098,
0.029064
],
[
0.021945,
0.000978,
-0.016849
],
[
-0.001881,
-0.02592,
-0.014794
],
[
0.005911,
-0.01828,
0.001968
],
[
0.00232,
-0.033098,
-0.038294
],
[
-0.034692,
0.019484,
0.015896
],
[
-0.003314,
-0.029785,
0.045681
],
[
-0.007582,
0.001414,
0.00927
],
[
-0.022498,
0.080276,
-0.081263
],
[
-0.001579,
0.049822,
-0.051992
],
[
0.091779,
0.009556,
-0.11985
],
[
0.040508,
0.027901,
-0.014845
],
[
0.037476,
0.005179,
0.035534
],
[
0.119105,
-0.047866,
-0.150389
],
[
0.004106,
-0.216207,
0.120095
],
[
-0.010645,
0.070928,
-0.046309
],
[
0.034549,
0.001998,
0.035677
],
[
0.018253,
0.248033,
0.118504
],
[
-0.070139,
-0.02041,
-0.054312
],
[
-0.120679,
0.054476,
-0.119427
],
[
-0.180178,
0.000404,
0.075166
],
[
0.215386,
-0.008312,
-0.050698
],
[
0.015891,
-0.014186,
0.079453
],
[
0.05336,
-0.03095,
-0.029273
],
[
-0.032547,
0.139951,
-0.043748
],
[
-0.018166,
0.08947,
-0.02624
],
[
0.131541,
0.119264,
0.189869
],
[
-0.00355,
0.016581,
-0.02696
],
[
0.019237,
-0.214659,
-0.091803
],
[
0.062376,
-0.138945,
0.09269
],
[
-0.158878,
-0.007211,
-0.026202
],
[
-0.072684,
-0.016182,
0.108558
],
[
-0.299584,
-0.055233,
-0.105917
],
[
0.121531,
0.070928,
-0.10962
],
[
-0.083528,
-0.00748,
0.120572
],
[
0.148012,
0.021305,
0.093327
],
[
0.010044,
-0.112839,
0.093083
],
[
-0.024231,
-0.016445,
-0.022003
]
],
"virial_eV": [
-8.377595,
-0.329522,
-0.260692,
-0.329522,
-9.159341,
0.070161,
-0.260692,
0.070161,
-7.469619
]
},
"li2s_conventional": {
"formula": "Li8S4",
"atoms": 12,
"energy_eV": -49.468821625,
"forces_eV_A": [
[
-0.0,
-0.0,
0.0
],
[
-0.0,
0.0,
0.0
],
[
-0.0,
0.0,
-0.0
],
[
0.0,
-0.0,
0.0
],
[
-0.0,
-0.0,
-0.0
],
[
-0.0,
0.0,
0.0
],
[
0.0,
-0.0,
0.0
],
[
0.0,
0.0,
-0.0
],
[
0.0,
0.0,
0.0
],
[
0.0,
-0.0,
-0.0
],
[
-0.0,
0.0,
-0.0
],
[
0.0,
-0.0,
0.0
]
],
"virial_eV": [
-1.997121,
0.0,
-0.0,
0.0,
-1.997121,
0.0,
-0.0,
0.0,
-1.997121
]
},
"licl_rocksalt": {
"formula": "Cl4Li4",
"atoms": 8,
"energy_eV": -30.530082885,
"forces_eV_A": [
[
-0.0,
-0.0,
-0.0
],
[
-0.0,
0.0,
0.0
],
[
-0.0,
0.0,
0.0
],
[
0.0,
0.0,
-0.0
],
[
0.0,
-0.0,
0.0
],
[
0.0,
-0.0,
-0.0
],
[
-0.0,
0.0,
-0.0
],
[
-0.0,
-0.0,
0.0
]
],
"virial_eV": [
-1.240451,
0.0,
0.0,
0.0,
-1.240451,
-0.0,
0.0,
-0.0,
-1.240451
]
}
}sha256 of the JSON payload above (as printed, canonical Forces are printed to 1e-6 eV/A, energies to 1e-9 eV, virials to 1e-6 eV: finer than the |
DPA-SSE callable check (legacy runtime) · 2026-11-15Evidence for #61 DPA-SSE spec §2.3 and §5, after the route decision in §5 Environment
mliport against the references (§5.1 and §2.3)
Tolerances were |ΔE| ≤ 1e-6 eV/atom, max |ΔF| ≤ 1e-5 eV/Å, max |Δvirial| ≤ 1e-5 eV. Identity read-out
Per-device checks
Fail-closed behaviour verified by hand
Limits
|
Tracking: #61 (DPA-SSE spec §5), review of #100 1. The strict tensor check can no longer be skipped in the legacy runtime. `_validate_pt_checkpoint` returns quietly when the loader exposes no inspectable torch model; in `.venv-dpa-legacy` that verification is the only guard against a partial or reshaped load, so `DPA_RUNTIME=legacy` now raises unless `checkpoint_tensors_verified` is true. The flag is recorded in `info()`, in the model record and in `IDENTITY_KEYS`, and the real CPU and GPU runs report `checkpoint_tensors_verified: true` (see #75). 2. `dpa-legacy` no longer claims Blackwell: torch 2.3.1+cu121 carries kernels up to sm_90 only, so `blackwell.upstream_supported` is false (like `maxwell`). 3. `dpa_runtime_problems` requires exactly `3.0.0b3` (a local version suffix is allowed); b0 is too old for `use_tebd_bias` and b4+ already changed the repformer layout, so accepting any `3.0.0b*` was wrong. 4. The legacy runtime accepts only `.pt`: any other suffix is refused before loading, and an unreadable model definition is now an error instead of a silent return. Tests: `test_dpa_runtime.py` grows to 20 cases (non-`.pt` refusal, unverified load refusal, exact-pin matrix, Blackwell support flag); the real install/probe still pass. DATA IMPACT: no scientific record invalidated; the legacy runtime simply refuses more unsafe inputs.
DPA-SSE ·
|
| Field | cpu | cuda:0 |
|---|---|---|
dpa_runtime |
legacy |
legacy |
deepmd_version |
3.0.0b3 |
3.0.0b3 |
checkpoint_tensors_verified |
true |
true |
checkpoint_migrations |
[] (nothing widened, renamed or reshaped) |
[] |
model_precision |
['float64'] |
['float64'] |
actual_device_type |
cpu |
cuda |
actual_device_uuid_source |
— | CUDA_VISIBLE_DEVICES |
| energy on the rattled Li₂S cell | -49.37500995424997 eV |
-49.37500995424997 eV |
The --full probe on the same cell still passes on both devices after the change (SP, shared
calculator, central differences, 10 NVE steps, five-image NEB; checkpoint_tensors_verified
is true in the probe's record as well).
Behaviour change requested by the review: in DPA_RUNTIME=legacy a load that cannot run the
strict tensor comparison now fails closed instead of continuing with
checkpoint_tensors_verified: false.
Rev 10 · 执行结果(第一批 + 第二批,部分第三批) — 2026-11-17 · main @
|
| 项 | 实测值 |
|---|---|
| main | 449ec9a4(#105/#106/#107 已合并;合并后 main CI 13/13 success) |
| Python | 3.12.13(core dev .venv-dev);仓库声称支持 3.10–3.13,本轮只在本地 3.12 全量跑,其余版本以 CI 矩阵为准 |
| 核心依赖 | ase 3.29.0, numpy 2.5.4, scipy 1.18.1, torch 2.14.1+cpu, textual 8.2.8, ruff 0.5.1, mkdocs 1.6.1 |
| 后端环境 | .venv(fairchem, torch 2.13+cu126) / .venv-mace(mace 0.3.16, torch 2.8+cu126, torch-dftd 0.5.3) / .venv-grace(tf 2.20.0, GPU 可见) / .venv-dpa(deepmd 3.2.1.dev63, torch 2.11+cu126) / .venv-dpa-legacy(deepmd 3.0.0b3, torch 2.3.1+cu121) / .venv-nep(calorine 4.1) |
| GPU | Tesla V100-SXM2-16GB,UUID GPU-f24116e9-bea2-e0a6-70a9-d0b50811856b,driver 580.173.02,sm_70;mliport setup --json 识别一致 |
| 权重 | 未下载任何新权重。使用本机既有:DPA(Nano/Mini/Neo/Plus/Air/4.1c-air/DPA-3.1-3M/SSE-VASP-dpa2)、UMA(s-1p1, s-1p2, s-1p2p1, -ft-d4rev, -ft-r2scan)、MACE(mace-mh-1 多头)、GRACE(2L-SMAX-OMAT-medium SavedModel)、NEP89(nep89_20250409.txt)。hash 见 §6 |
1. E 批次
| ID | 状态 | 证据 |
|---|---|---|
| E02 全工程检查 | PASS | pytest tests -q -ra → 2310 passed, 48 skipped(2356 collected);ruff@0.5.1 check/format --check 干净;generate_docs.py --check up to date;check_repository_hygiene.py passed;uv build --wheel --sdist + check_package_contents 2/2 PASS;mkdocs build --strict 通过 |
| 跳过项如实统计 | PASS | 48 skips 全部有原因:pymatgen×2、kinisi×13、scipp×12、fairchem/coralline/matscipy×3、MLIPORT_REAL_INSTALL=1 门控×13、MLIPORT_PACKAGE_ARTIFACTS×1、GRACE GPU 可选件×1、fairchem checkpoint×1(详见日志)。skips 不计入 PASS |
| E03 source→test 映射 | PARTIAL | 114 个模块比对:7 个模块在测试中没有名字引用;逐个核查后 queue_daemon(test_scheduler_daemon_processes_queue 真实起进程)、writers/oszicar(optimization 写 OSZICAR)、nep_model_format(nep/gpumd 间接)均有间接覆盖;confsearch/revisions、neb/revisions 由 checkpoint 测试间接覆盖;mliport/utils.py 无任何 importer、无任何测试(见 F04) |
| E04 打包/安装 | PASS | wheel 609 KB / sdist 545 KB;干净 venv(无源码树,cd /)安装后 mliport --version、--help、setup --json(识别 V100/Volta/sm_70/16384 MiB)、doctor(5 个可选特性 WARN 且给出 mliport[analysis-all] 指引,未导入后端)全部正常;CI 风格 --no-deps capability smoke 通过 |
2. U 批次(#104–#107,本轮重点)
| ID | 状态 | 证据 |
|---|---|---|
| U01 四入口一致 | PASS | 同一结构(Si8 弛豫胞)+ 同一 DPA-nano/GPU:CLI 参数 E=-42.852352333;INCAR 任务夹 + mliport run -42.852353287;TUI 向导同一函数路径(create_task_folder+run_task_folder)-42.852346135(DEVICE 默认 cpu);Python API -42.852357102。相对偏差 ≤2e-7,差异在 float32 GPU/CPU 噪声内;公式/原子序/身份一致 |
U02 models/ 查找 |
PASS | 真实用例:bare 文件名→<MLIPORT_ROOT>/models;一层子目录;GRACE SavedModel 目录按名解析成功;两个同名候选明确拒绝并列出两者;MLIPORT_ROOT 环境变量优先于 venv 派生;含分隔符/绝对路径不被重定向;找不到时列出全部已查位置 + models/ 实际内容(真实触发过一次,消息完整)。定向测试 19/19 通过 |
| U03 非标准路径 | PASS(含 2 项已修缺陷) | 空格+中文路径 odd dir 中文/task one 正常运行;OUTPUT_DIR = . 真实写回任务夹(不再生成 results/);符号链接结构文件正常;从其他 CWD 调用见 F02;只读输出目录见 F03(两者已在 #109 修复)。未测:只读输入、磁盘配额、Windows 原生(BLOCKED) |
| U04 schema→模板→文档一致 | PASS | test_incar_templates.py(模板/schema/文档三方键集与顺序)+ test_template_roundtrip.py(5 类型×6 后端模板可被 run 接受)+ generate_docs --check;严格性实测:未知键 NAPT_TDAMP→Did you mean 'npt_tdamp'?;WRITE_OUTCAR = perhaps→布尔转换错误;TEMPERATURE = nan→"expects a finite float";TIMESTEP = 0→拒绝;OPT 里写 MD_ENSEMBLE→"not valid for calc_type='opt'";CS_MODE = MODE_B→"must be one of 'adsorbate'"(信息可操作) |
| U05 TUI 向导 | PASS | 创建任务夹:INCAR.mliport(MODEL_PATH 保留 bare 名,让 models/ 生效)+ POSCAR 逐字节副本;remaining_placeholders = ['HEAD','TASK'];未填 TASK 时 run_task_folder 返回 1 且报 Invalid TASK 'required'(这正是 #107 复审修复的行为:不允许一键启动未选定的 task/head);填好 TASK 后正常跑完 |
| U06 结果/provenance | PASS | SP 布局与 docs/outputs.md 一致(artifacts.json 是 MD 专有);resolved_config.json 记录解析后的绝对模型路径(symlink 解析到真实目标);MD 有 artifacts.json(units/observables/hashes)+ raw/ + vasp/ |
3. P 批次(数值核心 / MD / NPT / #102)
| ID | 状态 | 证据 |
|---|---|---|
| P01 E/F/stress 有限差分 | PASS | 先用 ASE EMT(Cu)标定 FD 装置本身:力 max err 1.3e-4 eV/Å(h=0.01)、应力 2.0e-5 eV/ų(h=0.005)。真实模型(Si8 + 0.06 Å 扰动 + 剪切胞,fmax≈2.1 eV/Å):DPA-nano 力 4.4e-4 / 应力 8.2e-6;MACE(omat_pbe) 1.5e-4 / 7.3e-6;GRACE-2L 2.6e-4 / 1.4e-5;UMA-s1p1(omat) 2.0e-4 / 5.5e-6。误差随 h 增大(截断)而非噪声,符号/Voigt 顺序/单位均正确。过程中发现并纠正了审计脚本自身两处错误(未按 fractional 坐标缩放应变、DOM 无真空),已用 EMT 独立复核 |
| P02 OPT | PASS | 立方 Si8 与三斜胞均收敛(fmax 降到 1e-6 eV/Å 量级);cell_opt 把人为剪切的胞弛豫回立方(物理正确) |
| P03 NVE | PASS(PARTIAL 统计) | 初始温度精确 300.0 K(速度初始化);200 步内总能量 −42.541245→−42.541050 eV(漂移 ≈2e-5 eV/atom / 0.2 ps);短单次运行的瞬时 T 波动大(8 原子 24 DOF,σ_T/T≈29%),未做步长收敛速率研究(时间预算) |
| P04 NVT 三种恒温器 | PARTIAL | Langevin/Bussi/NHC 均正常完成并写出 md.csv/traj/OUTCAR;但 150 步(0.15 ps)从 150 K 起步不足以判定统计温度(297/244/362 K vs 目标 500 K 属瞬态),未做自相关/有效样本统计 |
| P05 NPT(Isotropic MTK) | PASS | 弛豫立方胞:P=0 GPa → 平均总压 +0.010 ± 0.389 GPa,体积稳定(+0.15%);P=2 GPa → +2.078 ± 1.367 GPa,体积 −3.21%;GPa↔eV/ų 换算由 stress 列独立重算,误差 1e-8 GPa;动能压强贡献 ≈+0.17 GPa 且确实计入 |
| P06 非立方胞 NPT 形状 | PASS | a≠b≠c、角度 86.67/91.72/87.24° 的 Si8 胞,12 帧内长度比与夹角漂移 = 0.000(机器精度),体积随压力变化(P=0 −1.68%,P=2 GPa −5.75%)→ 各向同性 MTK 只缩放体积,没有偷偷强制 cubic;残余偏应力属方法限制(已知) |
| P07 NPT 拒绝链与输出契约 | PASS(拒绝链) / F01 | NPT+BUSSI、NPT+T=0、NPT+TCHAIN=0、NPT+WRITE_TRAJECTORY=FALSE、NVE+PRESSURE_GPA、NPT+NEP 全部 rc=1;NPT 产物:无 XDATCAR、artifacts.json 中 variable_cell=True/transport_eligible=False;analyze validate 报 "Cell changes across frames… refuses MSD/transport",analyze msd/transport 直接拒绝并给出原因;固定胞 NVT 可正常 msd。缺陷 F01:这些拒绝发生在 results/ 已创建、模型已加载之后(见下) |
| P08 Issue #102 | FAIL → 已修复(PR #108) | 复现:MDRunner(calc, "NVT", 300, 1, 500, 10, "NHC", 0.5, …) 历史上第 8 个位置参数是 friction,NPT 参数插入后绑定成 pressure_gpa,bussi_tau→npt_tdamp、nhc_tdamp→npt_pdamp、save_interval→npt_tloop、output_dir→npt_ploop(后者直接 TypeError: npt_ploop must be an integer)。红测 3/4 失败 → 把 7 个 NPT 参数移到末尾并设为 keyword-only → 4/4 绿,全量 2314 passed。PR #108(CI 全绿、MERGEABLE/CLEAN,待 owner 授权合并) |
| P09 帧数/写盘一致性 | PARTIAL | 抽查 NVE/NVT/NPT:帧数 = steps/save_interval + 1,md.csv/trajectory.traj/OUTCAR/CONTCAR 一致;未做 1e5 帧内存上界、写盘背压、磁盘满 |
4. W 批次
| ID | 状态 | 证据 |
|---|---|---|
| W03 confsearch | PASS | 真实 DPA-nano/GPU、mliport run 派发 CONFSEARCH:预算行 "2 replicas x 1 cycles, 160 MD steps, <= 4 quenches";每循环 anneal→quench、quench 收敛统计(2 valid)、去重(1 new unique / 1 重复被拒)、Metropolis 接受(+0.0046 eV)/拒绝(+0.0023 eV);产物 search_results.json(status=completed、schema/scientific_revision/ranking/exports)、minima/all_minima.extxyz+registry.json、checkpoints/、diagnostics/、raw/。失败路径同样实测:无真空 slab → 放置 1000 次全 height_not_solvable 并列出计数;反应性吸附质 → reacted/quench_not_converged 分类 + "No replica survived the start-quench stage" 明确失败 |
| W07 闭环(任务夹→执行→分析) | PARTIAL | SP:任务夹→run→JSON;MD:任务夹→run→analyze msd 成功产出分析目录;NEB 闭环本轮未跑 |
| W01/W02/W04/W05/W06 | NOT_RUN | batch/NEB 真实任务、kinisi/GEMDAT/scipp 分析(核心环境无这些包;CI analysis-backends job 为绿但不算本地通过)、VACF/RDF 已知答案:本轮未执行 |
5. R 批次
| ID | 状态 | 证据 |
|---|---|---|
| R01 故障注入 | PARTIAL + 2 修复 | SIGINT 中止长 MD:日志停在 "next safe point"、artifacts.json status="cancelled"(不是 completed)、退出码非 0;只读输出目录 → 修复前是 PermissionError traceback,修复后 Error: Cannot write in output directory …(#109);模型异常/NaN 由既有测试覆盖(test_fixes.py),磁盘满/半写 JSON 未测 |
| R02 队列 | NOT_RUN | 双调度器/lease/GC 竞争由 test_queue.py(64 用例,含真实 daemon 进程)覆盖,本轮未做活体并发实验 |
| R03 入口一致性 | PARTIAL + F05 | 见 U01;发现 confsearch run 子命令没有 --device(sp/opt/md/neb/batch 都有),用户只能靠 INCAR/settings 指定设备 → 记 F05(P2,未修,属 CLI 表面不一致) |
| R04 包装/隔离 | PASS | 见 E04;后端隔离、无静默 CPU 回退(DPA/GRACE 的 require_isolated_visibility 实测会拒绝父进程已初始化 CUDA 的情况,报错给出 UUID 用法) |
| R05 性能回归 | NOT_RUN | 仅记录了冷/热启动 wall time(DPA-nano SP ≈7.7 s 含模型加载、MD ≈40 steps/s 含 8 原子),未做受控基准对比 |
6. B 批次(真实后端矩阵,Si8 金刚石,E/F/stress 全开)
| 案例 | 结果 | E/atom (eV) | 设备 | 精度 |
|---|---|---|---|---|
| DPA4C-Nano (cpu / cuda) | PASS / PASS | −5.3516 / −5.3516 | cpu / cuda:0 | float32 |
| DPA4C-Mini / DPA4-Neo / DPA4-Plus / DPA4-Air / dpa-4.1c-air | PASS(cpu) | −5.3938 / −5.4291 / −5.4225 / −5.4244 / −5.3472 | cpu | float32 |
DPA-3.1-3M(--head Omat24) |
PASS | −5.3893 | cpu | float32 |
| SSE-VASP-dpa2(legacy runtime) | PASS | +0.2896 | cpu | float64 |
MACE mace-mh-1(--head omat_pbe) |
PASS(cpu/cuda) | −5.4232 | cpu, cuda:0 | float64 |
| GRACE-2L-SMAX-OMAT-medium | PASS(cpu/cuda) | −5.4187 | cpu, cuda:0 | float32 |
| UMA s-1p1 (omat, cpu) / s-1p2 (cuda) / s-1p2p1 (cuda) | PASS | −5.4116 / −5.4165 / −5.4205 | cpu, cuda:0 | float32 |
NEP89 (nep89_20250409.txt, Calorine) |
FAIL(已知限制) | – | – | Calorine 无法解析 NEP89 v1:Failed to parse line 6 |
| NEP89 GPUMD runtime | BLOCKED | – | – | 本机无 gpumd 可执行文件;解除条件:安装 GPUMD 二进制(或 owner 指定路径) |
UMA uma-s-1p2p1-ft-d4rev 用 omat |
拒绝(正确) | – | – | Invalid task_name 'omat'. Valid options are ['omol'] |
载荷子模型缺 --head(MACE 多头、DPA-3.1 多头) |
拒绝(正确) | – | – | 列全部可用 head,要求显式指定 |
- B01/B02/B06:上表 +
metadata.actual_device_type/uuid、model_precision、模型解析后绝对路径全部记录;CPU/GPU 同模型 E 差 ≤1.1e-4 eV(float32 可解释),MACE float64 差 1e-6 eV。 - B03:GPUMD 路径 BLOCKED(见上),Calorine 限制复现(与文档一致,不算产品缺陷)。
- B04(缓存 A→B→A、OOM 回收)NOT_RUN;B05(DFT 参考精度)BLOCKED(本机无可信 CP2K/DFT 标签,且按要求不得用 Na₃PS₄ 未收敛力标签)。
7. 本轮确认的缺陷 / 修复 PR
| 编号 | 级别 | 现象 | 状态 |
|---|---|---|---|
| #102 / E8 | P1(兼容性,静默改配置) | MDRunner 位置参数错绑(见 P08) |
PR #108 待授权合并 |
| R10-F03 | P1(诊断) | 只读输出目录 → Python traceback | PR #109 待授权合并 |
| R10-F02 | P2(诊断) | run --incar 跨目录时只说“没有结构”,不说查了哪里 |
PR #109(仅改消息;结构默认仍是 CWD 相对——若要改成 INCAR 目录锚定需 owner 决策) |
| R10-F01 | P2(顺序) | MD 参数/设备拒绝发生在 results/、resolved_config.json 与模型加载之后 |
未修,建议下一步:把交叉字段校验提前到 CalculationEngine._validate() |
| R10-F04 | P3(死代码) | mliport/utils.py(191 行、8 个函数)无 importer、无测试,但仍打进 wheel |
未修,建议 owner 决定删除或补测试 |
| R10-F05 | P3(CLI 不一致) | confsearch run 无 --device,与其他子命令不一致 |
未修(文档化或补齐需 owner 决策) |
8. BLOCKED / NOT_RUN 清单(含解除条件)
- BLOCKED:NEP89 GPUMD(需 gpumd 二进制);真实 GPU 家族扩展(仅 1×V100);Windows 原生路径/安装;可信 DFT 参考(CP2K/DFT 标签不在本轮预算,需 owner 授权算力)。
- NOT_RUN:NEB 真实闭环(W02/W07)、batch 真实任务(W01)、kinisi/GEMDAT/scipp 分析(W04/W05;CI job 绿但本地未跑)、队列活体并发(R02)、性能基准(R05)、缓存 A→B→A / OOM(B04)、1e5 帧内存与磁盘满(P09/R01)、NVT 统计收敛与 NVE 步长速率研究(P03/P04)、文档内容级双语言复核(D01 仅自动检查通过)。
9. 版本冻结建议(G02)
建议:可以冻结功能(bugfix-only),但暂不打 tag,直到 #108、#109 合并且 main CI 全绿。
理由:Rev 10 覆盖的核心数值契约(E/F/stress 有限差分、单位/Voigt/符号、NPT 压力换算与形状保持、models/ 与任务夹、四入口一致、confsearch 端到端)在实际模型与 V100 上 未发现 P0 级科学错误或数据破坏;已知 P1 缺陷只有 #102(已修待合并)。剩余缺口集中在 NEB/batch 真实闭环、分析后端本地执行、NEP GPUMD 与统计收敛研究——都是可列明的残余限制,不是未知风险。
冻结后建议的后续顺序:合并 #108 → 合并 #109 → 补 NEB/batch 真实闭环证据 → 视算力许可补 DFT 参考 → 再考虑打 tag。
Rev 10 · 修复 PR 合并结果 — 2026-11-17接上方 执行结果评论。只记录合并后的事实;该评论中的 NOT_RUN / BLOCKED / 残余风险全部保留不变,未因合并而勾销。 合并记录(顺序 #108 → #109)
#109 合并前的追加修正(按要求,仅测试)Windows 上
本轮之后仍未完成 / 仍有风险(与上方评论一致,逐条保留)
冻结建议(不变)功能维持冻结(bugfix-only)。#102 这个已知 P1 兼容性缺陷已修复并合并,main CI 全绿,因此“先合并修复再谈冻结”的前置条件已满足;但 tag/发布建议仍等 NOT_RUN 清单中的 NEB/batch 真实闭环与分析后端本地执行补齐(或由 owner 明确接受这些残余风险)后再决定。 |
Rev 10 · 第二阶段执行结果(多材料 / 全工作流 / 无人值守)— 2026-11-18 · main @
|
| 项 | 实测 |
|---|---|
| main SHA / 工作区 | fb2935c7 / 干净;所有测试在仓库外 mliport_validation_runs/rev10_remaining_20261117_232213/ |
pytest tests -q |
2316 passed, 48 skipped(exit 0);修复分支 worktree 上 2317 / 2322 passed |
| 48 skips | 44 个真实安装门控 + calorine/pymatgen/kinisi;其中 4 个(kinisi/pymatgen)已在具备依赖的环境实跑通过(33 passed) |
| ruff / docs / hygiene | check 通过、format 通过、generate_docs.py --check up to date、hygiene passed |
| GPU | V100-SXM2-16GB UUID GPU-f24116e9-…,单任务串行(flock),累计 GPU 墙钟 ≈3 h(harness 记录 1.72 h + 裸子进程链) |
| 后端环境 | .venv(fairchem 2.25.0) / .venv-mace(0.3.16) / .venv-dpa(deepmd 3.2.1.dev63) / .venv-dpa-legacy(3.0.0b3) / .venv-grace(tf 2.20.0) / .venv-nep(calorine 4.1),全部实测可加载 |
2. 覆盖(真实模型 × 真实材料)
- 16 个本地 checkpoint 全部实测(15 个成功加载,NEP89 因格式限制单列):DPA(Nano/Mini/Neo/Air/Plus/4.1C-Air/3.1-3M/SSE-legacy)、MACE(mh-1 四 head、matpes-r2scan-ft)、GRACE(SMAX-medium、OMAT-base fp64)、UMA(s-1p1/s-1p2/s-1p2p1/两个 ft)、NEP89。
- 7 种晶胞:Si(立方 / 菱方 60° 非正交)、Cu(fcc/超胞/空位)、Li₂S(反萤石)、Na₃PS₄(四方,含 2×2×2 128 原子与 2×1×2)、Li₆PS₅Cl(13/26 原子)、LGPS(50/200 原子,三斜)、LLZO(96 原子)、受控剪切 Na₃PS₄。
- 结构全部来自仓库 fixture 或 Materials Project OPTIMADE 几何 pin(
mp-1153/mp-28782/mp-985592/mp-942733/mp-696138),并记录 sha256;Na₃PS₄ 与 LGPS 的 pin 与仓库既有 fixture/examples逐坐标一致。不使用 MP 能量。
3. 关键科学结果
| 项 | 数值 | 判读 |
|---|---|---|
| 上游直连对照 | DPA 能量逐位相同(−42.81268901860108 eV)、MACE ΔE=7.1e-15 eV、应力差 <1e-9 | mliport 未引入自己的换算 |
| Si 变胞 OPT | DPA4C-Nano a=5.3751 Å;mace-mh-1(omat_pbe) a=5.4674 Å | PBE≈5.47 → MACE 对,Nano 偏小(模型性质) |
| Si 菱方原胞 OPT | a=3.8003 Å、60° 保持 | 与 5.3751/√2=3.8008 自洽(晶胞算法正确) |
| Cu 空位 NEB | 0.739337 / 0.739353 eV(普通);0.750910 / 0.750900 eV(CI-NEB) | 正反一致 ≤1.6e-5 eV;落在文档 0.735–0.762 区间 |
| NVE 能量守恒 | Si64 3 ps:|ΔE|=1.2e-5 / 2.5e-4 / 1.3e-3 eV(0.25/0.5/1.0 fs);Na₃PS₄128:1.1e-3 / 4.5e-3 eV | 漂移 ~1e-8…5e-7 eV/atom/ps;ASE VelocityVerlet 对照同量级 → 噪声主导,非积分器缺陷 |
| NVE 复现 | 同种子逐帧差 2.7e-5 eV;save-interval 1 vs 10 差 2.7e-5 eV;换种子差 6.6e-4 eV | 复现合同成立 |
| NVT | 300 K:294.5±6.1 / 293.7±8.2 / 294.8±8.1(Langevin/Bussi/NHC);600 K:587±7 / 580±18;800 K:784±18 | 三恒温器均在块 SEM 内到点 |
| NPT(各向同性 MTK) | 0 GPa:0.011±0.012(Si)、0.011±0.028(Na₃PS₄)、0.014±0.037(LGPS);2 GPa:2.054±0.023 / 1.987±0.035 / 1.996±0.028 | 轴比散布 ≤6.7e-16、角度散布 0.0° → 严格等比例、不强行立方;逐帧偏应力幅度 0.003–0.006 eV/ų(非立方体系的已知限制,晶胞形状未被改变) |
| NPT 数据边界 | artifacts.json: variable_cell=true、transport_eligible=false,不写 XDATCAR |
正确 |
| confsearch 续算 | 参考 vs 同参重跑:7 极小、最大能量差 4.4e-4 eV;参考 vs 中断+续算:7 极小、1.2e-3 eV | 续算偏差 ≈ 后端自身重复性 → 忠实 |
| 输运(Na₃PS₄ 10 ps) | 600 K D=3.18e-11(CI 3.1e-12…7.0e-11)、σ_NE=17.5 mS/cm;700 K 9.63e-11;800 K 8.23e-11 | sampling_insufficient:700→800 非单调;Arrhenius Ea=0.120±0.121 eV、R²=0.43 |
| Arrhenius 已知答案 | 合成 Ea=0.3 → 反演 0.29999995±2.6e-8 eV、D₀=9.99999e-5、R²=0.9999999999 | 算法正确 |
| GEMDAT | 三温度 No jumps found(显式晶格 Na 位点) |
事件不足,非软件错误 |
4. 本轮发现并修复的缺陷
R10-F06(新,P1)→ PR #110(Draft,12/12 checks SUCCESS,MERGEABLE/CLEAN)
DPA 返回 np.bool_(False),classify_result 用 converged is False 判断 → 未收敛的 OPT 被记为 completed:
| 接口 | main 上实测 | 修复后 |
|---|---|---|
mliport opt(步数耗尽) |
打印 Converged: No,exit 0 |
exit 2(文档承诺) |
mliport batch --calc-type opt |
status: completed、success: true、not_converged: 0 |
not_converged、success: false |
| 队列作业状态(按退出码派生) | completed | not_converged |
红测试 2 个(batch 参数化 + classify_result),修复后 2317 passed。这是本轮唯一会悄悄污染批量/队列统计的缺陷。
R10-F01(旧账,P2)→ PR #111(Draft,12/12 checks SUCCESS)
NPT 的 4 个纯配置冲突(非 Langevin thermostat / --no-write-trajectory / 温度≤0 / 阻尼≤0)原先在 results/、resolved_config.json、模型加载之后才拒绝。现将校验前移到 resolver:
- 修复前:4 个用例全部
results_dir=Y resolved=Y model_loaded=Y; - 修复后:全部
N/N/N,退出码与错误文本不变; - 合法 NVE / NVT-NHC / NPT 的
md.csv与 main 逐字节相同(md5)。
5. 已确认但未修复(需 owner 裁定)
| 编号 | 级别 | 内容 |
|---|---|---|
| NEB-RESUME-01 | P2 | docs/workflows/neb.md 承诺"resume 改 --max-steps 会被拒绝"。实测:同一 checkpoint 分别用相同选项、--max-steps 123、去掉 --climb resume,三者全部 exit 0 跑完;resolved_config.json 里 max_steps 仍是记录值 200(source 标 CLI)→ checkpoint 层覆盖了用户显式值,指纹恒等。科学数据不会被污染(协议保持一致),但静默忽略用户意图,违背"fail closed"。修复点在 cmd_neb resume 分支与 resolver 层优先级,属公共行为重设计,本轮按规则停止改码并记录。建议二选一:显式拒绝并列出冲突项,或文档改为"resume 一律沿用 checklist 记录值"。 |
| R10-F07 | P3 | mliport analyze <单点运行目录> thermo 报 [Errno 21] Is a directory,真实原因是"该目录没有轨迹",信息误导。 |
| R10-F08 | P3 | 分析结果 id 不覆盖 raw/mliport_results.json;结果文件被截断时若同 id 分析已完成则直接复用(--force 后会在轨迹截断处硬失败)。 |
| R10-F05 | P3 | confsearch run 无 --device(复现),只能经 settings/INCAR;confsearch resume 只接受计算器选项。本轮用 --settings 的 DEVICE=cuda:0 完成 confsearch 验收,建议补文档。 |
| R10-F04 | P3 | mliport/utils.py(191 行、8 函数)无任何 importer,仍随 wheel 发布;按任务书不删除。 |
| — | 观察 | 官方 harness 6 条 fail 全是 float32 旋转/平移不变性在 ~1e-6 eV/Å 的偏差(阈值 = 10×实测重复性下限);保留 fail 原样,不改判。 |
6. 可靠性 / 故障注入 / 性能
- 队列(隔离
MLIPORT_JOBS_DIR):max_concurrent=1实测并发度恒为 1、作业区间零重叠;第二个调度器被拒;暂停/恢复生效;失败作业不中断整批并如实记failed;SIGTERM 前台调度器 0.5 s 退出、运行中的 worker 独立跑完并写回状态、重启后队列排空、结束无残留调度器。 - 故障注入:只读目录 / 已存在结果目录 / 并发写同一目录 → 全部拒绝且无产物;ENOSPC(定向注入
JsonWriter.write)→OSError(28)、只留 OUTCAR、无 results JSON、无 success 声明、无临时残留;截断轨迹 →analyze硬失败不写分析。 - 缓存与显存:DPA A→B→A 能量差 2e-6 eV(float32 噪声级,无跨模型污染证据);加载失败后正常加载结果不变;8 次创建/销毁计算器显存恒为 17.039 MB;GRACE neighbor-cache ON/OFF ΔE=7.2e-7 eV;MACE dtype 正确上报。
- 性能(官方 T8,pass):DPA-3.1-3M SP 暖 165.7/167.9/177.6 ms(32/128/512 原子),MD 5.94 步/s(128 原子);UMA-s-1p2 SP 103.7/105.2/205.0 ms,MD 9.50 步/s。冷启动 14.0 s(DPA@32 原子)vs 暖 0.17 s。
7. NOT_RUN / BLOCKED / INCONCLUSIVE(不得当成通过)
| 项 | 状态 | 原因 |
|---|---|---|
| MLIP vs DFT 精度对照 | BLOCKED | 本机无已收敛且元数据完整的 DFT 标签;旧 Na₃PS₄ 力标签不可当真值 |
| NEP89 原生 GPUMD | BLOCKED | GPUMD/src/gpumd 缺 libnvJitLink.so.12(其余 CUDA 库可从 uv 缓存补齐);不重新编译 GPUMD |
| NEP89 ASE/Calorine | UNSUPPORTED | 新版 nep.txt 格式 Calorine 解析失败(已知限制) |
| 官方 T6(MD 套件) | NOT_RUN(启动后中止) | pinned DPA-3.1-3M 实测 ~4.6 步/s(128 原子),NVE 步长扫描即超预算;已用自建 MD 矩阵覆盖并记录速率 |
| 官方 T5(NEB 套件) | NOT_RUN | 8 条内置工作流耗时不可控;用直接 CLI NEB/CI-NEB + 中断续算覆盖 |
| MACE 官方 pinned profile | BLOCKED | manifest 钉的 mace-omat-0-medium 本机不存在;mace-mh-1 是不同 artifact,不得替代 |
| Na₃PS₄ 电导率/Ea | INCONCLUSIVE | 10 ps×3 温度,D 不确定度约 2×,700→800 非单调 |
| GEMDAT 定量 | INCONCLUSIVE | 三温度零跳跃事件 |
| LLZO / LPSC 深度工作流 | 部分 | LLZO 只做 SP + E/F/stress(5 个模型,96 原子);LPSC 做 SP + 固定胞 OPT + 1500 K 短 NVT |
| TUI | NOT_RUN(交互) | 由 test_tui.py 覆盖(全绿) |
| 500 原子以上长时 MD/NEB | NOT_RUN | 仅 512 原子 SP/短 MD 性能冒烟 |
8. 停留状态
- [DEV P0 AUDIT · DO NOT MERGE/CLOSE] Living correctness and real-hardware test ledger · master #61 #75 / [DEV MASTER · DO NOT MERGE/CLOSE] MLIP validation roadmap (#75) + confsearch living spec #61 保持 Open + Draft,未合并、未关闭;本轮零代码改动落到这两个 PR。
- 新 PR:fix(run-status): numpy converged flag no longer becomes success (R10-F06/P1) #110(P1,Draft,12/12 checks SUCCESS)、fix(md): reject illegal NPT requests before any output or model load (R10-F01/P2) #111(P2,Draft,12/12 checks SUCCESS),两者均 MERGEABLE/CLEAN,均未合并,等 owner 审核。
- 现场已清理:无本轮残留的调度器、GPU lease 或子进程;测试产物 509 MB(远低于 30 GiB),磁盘剩余 103 GB。
9. 完整报告与用例矩阵
FINAL_REPORT.md(中文)
Mliport Rev 10 第二阶段综合验收 · 最终报告
- 基线:
main@fb2935c730118bcaa86ede6154ac10c512f46677(origin/main已重新获取,工作区干净,无本地提交) - 执行时间:2026-11-17 23:22 → 2026-11-18(本机时区 UTC+8),单人/单卡无人值守
- 硬件:Tesla V100-SXM2-16GB(UUID
GPU-f24116e9-bea2-e0a6-70a9-d0b50811856b,driver 580.173.02)、72 物理核、109 GB RAM - 全部原始证据:
/home/storm/hdd500/dev/mliport_validation_runs/rev10_remaining_20261117_232213/(509 MB) - 台账回填:[DEV P0 AUDIT · DO NOT MERGE/CLOSE] Living correctness and real-hardware test ledger · master #61 #75 (comment);[DEV P0 AUDIT · DO NOT MERGE/CLOSE] Living correctness and real-hardware test ledger · master #61 #75 / [DEV MASTER · DO NOT MERGE/CLOSE] MLIP validation roadmap (#75) + confsearch living spec #61 保持 Open + Draft
- 本轮未新增功能、未改动 CLI 语义、未合并任何 PR、未下载新权重、未使用 DFT/HPC/云算力
1. 总结:Mliport 现在可靠到什么程度
结论分三层,不要混着读:
已经用真实模型 + 真实硬件验证的部分。 四个后端(UMA / MACE / DPA / GRACE)在本机 V100 上都能被 mliport 正确调用,15 个本地 checkpoint 全部加载成功并给出有限的 E/F/stress(NEP89 是第 16 个,因格式不兼容单列,见 §3);6 种材料(Si、Cu、Li₂S、Na₃PS₄、Li₆PS₅Cl、LGPS)加 LLZO 的 7 个晶胞上,SP、变胞/固定胞 OPT、batch、NEB/CI-NEB、confsearch、NVE/NVT/NPT、MSD/kinisi/GEMDAT/VACF/RDF/Arrhenius 都能真实跑通并留下可追溯产物。Cu 空位 NEB 得到 0.739 eV(普通 NEB)与 0.751 eV(CI-NEB),正反向一致到 2×10⁻⁵ eV,落在仓库文档记录的 0.735–0.762 eV 区间内。
发现的真实软件缺陷。 2 个,都不在"跑不通"的层面,而在"悄悄把失败写成成功"的层面:
- P1(已修复,PR fix(run-status): numpy converged flag no longer becomes success (R10-F06/P1) #110,Draft,12/12 checks SUCCESS):
converged是numpy.bool_时,classify_result用is False判断失效,导致未收敛的 OPT 被记为completed、进程退出码 0、batch 汇总把它算成success: true。这是本轮最重要的发现。 - P2(已修复待审,PR fix(md): reject illegal NPT requests before any output or model load (R10-F01/P2) #111,Draft):R10-F01,NPT 的 4 个纯配置类非法组合(非法 thermostat、无轨迹输出、温度 ≤0、阻尼 ≤0)在创建
results/、写resolved_config.json、加载模型之后才被拒绝。修复把校验提前到 resolver,合法 NVE/NVT/NPT 的md.csv与修复前逐字节相同。
明确没有证明的部分。 本机没有任何 MLIP 与 DFT 的同体系对照标签(Na₃PS₄ 的旧 CP2K 力标签未充分收敛,按既定规则不可用),因此没有做 MLIP-vs-DFT 精度验证;所有绝对能量只用于同一模型内部的相对比较。输运只完成"软件闭环",10–12 ps 的轨迹不足以给出可发表的 Na₃PS₄ 电导率(见 §8)。
一句话:软件层面的科学正确性(单位、符号、Voigt 顺序、PBC、task/head、续算、失败语义)在本轮覆盖面内是可靠的;模型精度与统计收敛没有、也不应该由本轮验收来背书。
2. 基线、环境与工程检查
| 项 | 实测 |
|---|---|
| main SHA | fb2935c730118bcaa86ede6154ac10c512f46677(= 任务书给定基线,git rev-list --count 前后均为 0) |
| 工作区 | 干净;本轮所有测试在仓库外目录执行;修复走独立 worktree + 独立分支 |
pytest tests -q -ra(.venv-dev) |
2316 passed, 48 skipped(7 分 40 秒,exit 0) |
| 同一套测试在修复分支 worktree | 2317 passed, 48 skipped(+1 为新增参数化用例) |
ruff check / ruff format --check |
All checks passed / 275 files already formatted |
check_repository_hygiene.py / generate_docs.py --check |
passed / up to date |
| 48 个 skip 的性质 | 44 个 MLIPORT_REAL_INSTALL 等真实安装门控、calorine 缺失、pymatgen/kinisi 在 .venv-dev 缺失;其中 4 个(kinisi/pymatgen)已在具备依赖的环境中实跑并通过(test_science_analysis_known_answers.py:33 passed) |
| 后端环境 | .venv(fairchem 2.25.0, torch 2.13+cu126) / .venv-mace(mace 0.3.16) / .venv-dpa(deepmd 3.2.1.dev63) / .venv-dpa-legacy(3.0.0b3) / .venv-grace(tf 2.20.0) / .venv-nep(calorine 4.1) 全部实测可用且均以 editable 指向本仓库 |
| GPU / CPU 分离 | 所有 GPU 用例经同一把 flock 串行;全程只有一个真实 GPU 任务 |
3. 模型与材料覆盖(T1:身份 + 加载 + E/F/stress)
16 个本地 checkpoint 全部实测(不是按文件名判断;其中 15 个成功加载,NEP89 见下)。每个模型在 6–7 个材料晶胞上求 E/F/stress,全部有限值;无一例 stress 缺失或静默跳过。
| 模型 | 类型/head | task | 加载 | 材料数 | Si E/atom (eV) | Na₃PS₄ E/atom | LGPS E/atom |
|---|---|---|---|---|---|---|---|
| DPA4C-Nano | dpa | bulk | LOADED | 7 | −5.3516 | −4.0821 | −4.2799 |
| DPA4C-Mini | dpa | bulk | LOADED | 6 | −5.3938 | −4.0833 | −4.3043 |
| DPA4-Neo | dpa | bulk | LOADED | 6 | −5.4291 | −4.1149 | −4.3246 |
| DPA4-Air | dpa | bulk | LOADED | 6 | −5.4244 | −4.1151 | −4.3265 |
| DPA4-Plus | dpa | bulk | LOADED | 6 | −5.4225 | −4.1151 | −4.3272 |
| DPA-4.1C-Air | dpa | bulk | LOADED | 6 | −5.3472 | −4.1134 | −4.3237 |
| DPA-3.1-3M | dpa head=Omat24 |
bulk | LOADED | 6 | −5.3893 | −4.0999 | −4.3220 |
| SSE-VASP-dpa2 | dpa legacy 运行时 |
bulk | LOADED | 6 | +0.2896 | −2.6760 | −4.5218 |
| mace-mh-1 | mace head=omat_pbe, float64 |
bulk | LOADED | 7 | −5.4232 | −4.1102 | −4.3241 |
| GRACE-2L-SMAX-OMAT-medium | grace | bulk | LOADED | 7 | −5.4187 | −4.1127 | −4.3221 |
| GRACE-2L-OMAT-base fp64 | grace | bulk | LOADED | 6 | −5.4233 | −4.1128 | −4.3231 |
| UMA-s-1p2 | uma | omat | LOADED | 7 | −5.4165 | −4.1151 | −4.3260 |
| UMA-s-1p1 | uma | omat | LOADED | 6 | −5.4116 | −4.1156 | −4.3273 |
| UMA-s-1p2p1 | uma | omat | LOADED | 6 | −5.4205 | −4.1147 | −4.3269 |
| UMA-s-1p2p1-ft-r2scan | uma | omat | LOADED | 2 | −7904.61 | – | – |
| NEP89 | nep ase/Calorine |
bulk | 不支持 | 0 | – | – | – |
必须分开读的三点:
- 绝对能量不可跨模型/跨参考面比较。 DPA 家族内部 −5.35…−5.43 eV/atom 的差距是模型规模差异;
SSE-VASP-dpa2(+0.29 eV/atom)与uma-…-ft-r2scan(−7904.61 eV/atom)是不同参考面/带任意能量零点的 checkpoint,它们的力与应力仍然合理(r2scan 微调在 Si₈ 上 fmax=5.6×10⁻⁶ eV/Å,stress 有限),但绝对能量不得与 PBE/OMat 系模型混用。这是本轮实测证据,不是猜测。 - mace-mh-1 的 4 个 head 是 4 个不同参考面:
omat_pbe−5.4232、mp_pbe_refit_add−5.3989、matpes_r2scan−8.7584、MACE-matpes-r2scan-omat-ft−8.7912 eV/atom。必须显式选 head,mliport 会拒绝不存在的 head(MACE head 'omat_pbe' is not available in this model. Available heads: ['default'])。 - NEP89 新版模型格式:Calorine 解析失败(
Failed to parse line 6),这是已知且文档化的限制,不是新 bug。原生gpumd路径本轮 BLOCKED:本机GPUMD/src/gpumd存在,但动态链接缺少libnvJitLink.so.12(libcublas.so.12/libcusolver.so.11/libcufft.so.11可从 uv 缓存补齐,libnvJitLink.so.12本机没有),按授权不得重新编译 GPUMD,因此只记录,不重试。
4. 单点、几何优化与批处理
4.1 单点输出契约与 CPU/GPU 一致性
同一结构、同一模型,CLI 在 cuda 与 cpu 上的差异:
| 模型 | Si₈ ΔE (eV) | Na₃PS₄ ΔE (eV) | 说明 |
|---|---|---|---|
| DPA4C-Nano (float32) | 1.4×10⁻⁵ | 1.6×10⁻⁵ | float32 后端噪声 |
| GRACE-2L (float32) | 1.9×10⁻⁶ | 5.5×10⁻⁶ | 同上 |
| UMA-s-1p2 (float32) | 1.1×10⁻⁶ | 7.9×10⁻⁷ | 同上 |
| mace-mh-1 (float64) | 7.1×10⁻¹⁵ | 1.4×10⁻¹⁴ | 位级一致 |
OUTCAR的 Voigt 表头显式写作xx yy zz yz xz xy(ASE 顺序),并同时给出 eV/ų 与 GPa;压力-trace(σ)/3与Pressure:行吻合到 10⁻⁶ GPa。用一个只有 xy 剪切的受控形变胞(Na₃PS₄,人为施加,不是平衡态)验证:JSON 与 OUTCAR 均只有xy分量非零,yz/xz ≈10⁻⁹ → Voigt 顺序与单位无歧义。- 与上游计算器直连对照(同一进程、同一模型文件、同一结构,mliport CLI 的 JSON vs 直接调用上游 ASE 计算器):DPA 能量逐位相同(−42.81268901860108 eV,应力分量差 <1×10⁻⁹);MACE(float64) ΔE = 7.1×10⁻¹⁵ eV、应力差 <1×10⁻¹⁷。→ mliport 没有在 E/F/stress 上引入自己的换算。
- 非周期输入 fail closed:水分子 +
--task bulk→Task 'bulk' requires full 3D periodicity, but the input PBC is [False, False, False]. …mliport will not change it.;同一分子用--task molecule正常(exit 0)。2D slab 的拒绝本轮未覆盖:我构造的 slab fixture 实际写成了 3D 周期胞(pbc=[T,T,T],真空在 c 方向),因此它被当作合法 bulk 接受;这一项记为 NOT_RUN,不能声称已验证。 - 输出目录契约:已存在结果的目录、只读目录、并发写同一目录,全部被拒绝并给出明确原因(见 §9)。
4.2 几何优化(全部真实 GPU)
| 用例 | 体系 | 模型 | 结果 |
|---|---|---|---|
| 变胞 OPT | Si₈ | DPA4C-Nano | a = 5.3751 Å,20 步,fmax 4.7×10⁻⁶ |
| 变胞 OPT | Si₈ | mace-mh-1 (omat_pbe) | a = 5.4674 Å,15 步(PBE 参考 ≈5.47 Å) |
| 变胞 OPT | Cu₃₂ | DPA4C-Nano | a = 3.6114 Å(实验 3.615) |
| 固定胞 OPT | Na₃PS₄(2×1×2) | DPA4C-Nano | 晶胞逐位不变(Δcell = 0.0),fmax 0.0125 |
| 变胞 OPT | Na₃PS₄ | DPA4C-Nano | a 6.924→7.029、c 14.154→14.328,fmax 0.0107 |
| 固定胞 OPT | Li₆PS₅Cl | DPA4C-Nano | 晶胞不变,fmax 0.0176(阈值 0.02) |
| 变胞 OPT | Si 菱方原胞(60°,非正交) | DPA4C-Nano | a=3.8003 Å,60° 保持 → 与 5.3751/√2=3.8008 自洽 |
| 变胞 OPT | 受控剪切 Na₃PS₄(88.28°) | DPA4C-Nano | 剪切回复到 90.007°,晶胞 (7.028, 7.059, 7.167),与上一行独立结果一致 |
| 步数不足 | 320-atom 级无关;见注 | DPA4C-Nano | Converged: No 被正确打印;修复前退出码却是 0 → PR #110 |
注:最初的"步数不足"用例用了理想 fcc Cu₃₂(DPA 在该几何上力已 ≈10⁻⁷),第 0 步即收敛,因此标记 INCONCLUSIVE,另用 0.08 Å 扰动的 Cu₃₂ 重测(cu32_rattled),得到 Converged: No、exit 0(main)/ exit 2(#110)。
4.3 批处理(14 个输入,首次真实验收)
输入集:8 个 VASP、2 个 CIF、2 个 extxyz(含扩展 XYZ)、两组同名结构(a_si/si.vasp 与 g_rep1/si.vasp、h_rep2/si.vasp)、扰动结构、一个损坏 CIF、一个空 POSCAR、一个非周期水分子、一个受压 Cu₃₂。
| 步骤 | 结果 |
|---|---|
| Batch SP | 14 任务 = 11 completed + 3 failed(损坏 CIF / 空结构 / 非周期分子),单任务失败不中断整批 |
--resume(无变化) |
reused = 11,未重算任何成功项;进度文件不追加 |
修改 1 个输入内容后 --resume |
reused = 10,只有被改的 a_si/si 重算(shasum 变化被识别) |
换模型后 --resume |
拒绝:Cannot resume: batch settings differ … model_path / model_sha256: f1309e91… -> 49a341ff…,不混淆不同模型的结果 |
| Batch OPT(max-steps=4, fmax=1e-3) | 9 个结构 converged: false;main 上这些记录 status=completed、success: true、not_converged: 0 → 即 PR #110 的缺陷 |
| 中断后 resume | SIGINT 中断后 --resume 继续,已完成项复用,未留下"假的 completed";batch_summary.json 总数为 14 且与 14 个 batch_status.json 一致 |
5. 分子动力学:NVE / NVT / NPT / 高温
全部为 DPA4C-Nano 真实 GPU 运行,产物为 raw/md.csv + raw/trajectory.traj + artifacts.json。注意一个物理事实,避免误判为 bug:从弛豫到极小值的构型出发、按目标温度赋 Maxwell-Boltzmann 速度做 NVE,系统会按能量均分自发降温到 ≈T/2(初始全部能量在动能上,平衡后一半进入势能)。Si₆₄ 300 K → 149 K、Na₃PS₄ 600 K → 303 K 都是这个效应,不是恒温器或积分器错误。
| 体系 | 步长 | 物理时长 | |ΔE_total| | 漂移斜率 (eV/atom/ps) | T 初→均值 | 帧数 |
|---|---|---|---|---|---|
| Si₆₄ | 0.25 fs | 3 ps | 1.2×10⁻⁵ eV | −5.6×10⁻⁹ | 300→149.5 K | 1201 |
| Si₆₄ | 0.50 fs | 3 ps | 2.5×10⁻⁴ eV | −1.8×10⁻⁸ | 300→149.5 K | 601 |
| Si₆₄ | 1.00 fs | 3 ps | 1.3×10⁻³ eV | −7.6×10⁻⁹ | 300→149.6 K | 301 |
| Na₃PS₄₁₂₈ | 0.50 fs | 3 ps | 1.1×10⁻³ eV | +1.2×10⁻⁷ | 600→303 K | 601 |
| Na₃PS₄₁₂₈ | 1.00 fs | 3 ps | 4.5×10⁻³ eV | +5.2×10⁻⁷ | 600→304 K | 301 |
NVT(三种恒温器)
E_kin + E_pot = E_tot残差为 0.0(所有 NVE 用例,逐帧核对),能量记账没有错位。- 同种子重复:两次
dt=1.0 fs运行逐帧最大差 2.7×10⁻⁵ eV、温度 5×10⁻⁴ K → 复现合同成立(float32 噪声级)。 - 保存频率不影响物理:
--save-interval 1与10在同一物理时刻的最大能量差 2.7×10⁻⁵ eV。 - 换种子:最大差 6.6×10⁻⁴ eV、温度 52.6 K → 不同轨迹,符合预期。
- 独立积分器对照(ASE
VelocityVerlet+ 同一 DPA 模型,从 mliport 第 0 帧的坐标和动量起步):0.25 fs 漂移 −9.8×10⁻⁹、ΔE=1.0×10⁻⁴ eV;1.0 fs 漂移 +3.7×10⁻⁸、ΔE=1.4×10⁻³ eV。与 mliport 同量级,说明 mliport 的 NVE 就是 ASE 的 Velocity Verlet 语义,漂移由 float32 模型噪声主导,而不是积分器缺陷;这也解释了为什么 Si₆₄ 上漂移对步长不单调(噪声底 ≈ 积分误差)。
NPT(各向同性 MTK)
| 体系 | 温度设定 | 恒温器 | 平衡+生产 | T 均值 ± 块 SEM | fmax |
|---|---|---|---|---|---|
| Si₆₄ | 300 K | Langevin (γ=0.01) | 1+5 ps | 294.5 ± 6.1 K | 3.18 |
| Si₆₄ | 300 K | Bussi/CSVR (τ=100 fs) | 1+5 ps | 293.7 ± 8.2 K | 3.26 |
| Si₆₄ | 300 K | NHC (4 链, 2 子步) | 1+5 ps | 294.8 ± 8.1 K | 3.60 |
| Na₃PS₄₁₂₈ | 600 K | Langevin | 1+5 ps | 587.0 ± 7.1 K | 6.10 |
| Na₃PS₄₁₂₈ | 600 K | NHC | 1+5 ps | 579.8 ± 17.8 K | 5.47 |
| Na₃PS₄₁₂₈ | 800 K | Bussi | 1+5 ps | 784.0 ± 18.5 K | 6.90 |
6. NEB / CI-NEB
体系与构建方式完全按 docs/test-systems.md 配方 2:3×3×3 fcc Cu(a=3.63 Å,107 原子)+ 一个空位 + 最近邻跳入空位,跳距 2.5668 Å。端点未预弛豫时 fmax=0.141 eV/Å,mliport 按 --endpoint-fmax 0.02 拒绝启动(fail closed),改用文档的 --endpoint-policy relax 在运行内弛豫端点。
| 用例 | 结果 |
|---|---|
| 普通 NEB(5 内插,非爬坡) | 23 步收敛,最大带力 0.0444 eV/Å(目标 0.05);前向 0.739337 eV / 反向 0.739353 eV(差 1.6×10⁻⁵ eV,对称路径自洽) |
| CI-NEB(5 内插,爬坡) | 收敛;前向 0.750910 / 反向 0.750900 eV;barrier_status = converged_path_estimate,saddle_validation = not_performed(未做 Hessian,因此不称其为已验证过渡态) |
| 端点未弛豫时的行为 | Endpoint 0 fmax=0.141 eV/A exceeds endpoint_fmax_eV_A=0.02 → 拒绝启动(fail closed),改用 --endpoint-policy relax 后正常 |
| 中断(SIGINT) | 在 checkpoints/step_000002 处中断:exit 130、status=cancelled、converged=false,band 7 帧完整保留 |
| 用完全相同的选项 resume | exit 0、status=completed、收敛,势垒 0.751460 eV(与未中断的 0.750910 eV 差 5.5×10⁻⁴ eV;几何续算、不重放优化器历史,与文档一致) |
| resume 换模型 | 拒绝:Resume fingerprint is incompatible with this model, backend, task/head/dtype, cell/PBC, identity, constraints, or band setup,checkpoint 未被破坏 |
resume 改 --max-steps |
未拒绝:exit 0 并跑完;resolved_config.json 里 max_steps 仍是记录值 200(source 标为 CLI)→ 用户显式改的值被静默忽略(见 §10 NEB-RESUME-01) |
resume 去掉 --climb |
同上:静默沿用记录的 climb=true,不报错 |
| 损坏 checkpoint | 早期尝试中把 latest 指针写成普通文件 → 明确拒绝:Refusing to replace non-symlink checkpoint pointer,不静默重头开始 |
梯度预检真实执行:Pre-flight passed: 12 checks on images [0,2,4,6], max |FD − (−F·u)| = 5.1×10⁻⁴ eV/Å。
7. 构型搜索(confsearch)
体系沿用仓库 confsearch_suite.py 的 LGPS 切片 + 甲醇(模式 B 自动放置),--n-starts 4 --cycles 2,--hold-ps 0.5 --cool-ps 0.5,seed 20261117。confsearch run 没有 --device(R10-F05 复现),设备通过 --settings settings.ini 的 DEVICE = cuda:0 传入,这是当前支持的路径。
| 项 | 结果 |
|---|---|
| 参考运行 | status=completed,7 个唯一极小,最优 −123.911922 eV,2/8 周期出现 md_integrity_abort(吸附质键断裂保护)→ 失败计数如实记录 |
中断 + confsearch resume <dir> |
完成,7 个极小,最优 −123.911918 eV |
| 对照组:同参数重跑(不中断) | 7 个极小,与参考的最大能量差 4.4×10⁻⁴ eV(中位 7.7×10⁻⁵) |
| 中断+续算 vs 参考 | 7 个极小,最大能量差 1.2×10⁻³ eV(中位 5.9×10⁻⁵) |
| 换模型 resume | 拒绝:model.model_sha256: recorded 'f1309e91…' != current '49a341ff…' |
| 换 task resume | 拒绝:model.task: recorded 'bulk' != current 'molecule' |
| 损坏 checkpoint | 未 crash:从仍有效的 checkpoint 继续并完成;无半写结果被当成有效数据 |
结论:续算偏差与"同参数重跑"的偏差同量级(10⁻³ eV),因此续算是忠实的;DPA float32 后端本身在 MD 重启后不保证位级可重复,这一点由对照组量化,而不是假设。
8. 输运与分析(真实轨迹 + 已知答案)
轨迹:α-Na₃PS₄ 2×2×2(128 原子),NVT-NHC,600/700/800 K,2 ps 平衡 + 10 ps 生产,1 fs 步长,每 10 fs 一帧(1001 帧)。
| T (K) | D_tracer 中位 (m²/s) | σ_NE 中位 (mS/cm) | σ_collective (mS/cm) | Haven | 拟合滞后点数 |
|---|---|---|---|---|---|
| 600 | 3.18×10⁻¹¹(95% CI 3.1×10⁻¹²…7.0×10⁻¹¹) | 17.5(CI 1.7…38.6) | 61.0 | 0.287 | 802 |
| 700 | 9.63×10⁻¹¹ | 45.2 | 未启用该选项 | – | 802 |
| 800 | 8.23×10⁻¹¹ | 33.8 | 27.8 | 1.04 | 802 |
这些数字不能当作 Na₃PS₄ 的电导率。 700→800 K 的 D 非单调(3 个温度、每个±2 倍不确定度),Arrhenius 拟合得到 Ea = 0.120 ± 0.121 eV、R² = 0.43,即"没有可分辨的 Arrhenius 行为"。按任务书要求,本轮结论是 pipeline_validated / sampling_insufficient,不是材料结论。collective 与 Nernst-Einstein 的差别(Haven 0.29)在 10 ps 尺度不足以判定为真实相关运动。
已知答案校验(与真实轨迹无关,纯算法):
- Arrhenius:用 D₀=10⁻⁴ m²/s、Ea=0.3 eV 合成三个温度点 → 反演得到 Ea = 0.29999995 ± 2.6×10⁻⁸ eV、D₀ = 9.99999×10⁻⁵、R² = 0.9999999999。
- MSD/kinisi/GEMDAT 的已知答案路径由
test_science_analysis_known_answers.py覆盖,并在具备 kinisi/pymatgen 的环境中实跑通过(33 passed)。
其它分析模块在 800 K 轨迹上全部真实执行:validate、thermo、msd(含 mass-weighted COM 漂移修正)、rdf(Na–S、Na–Na)、vacf、spectrum、density、rmsd、transport、transport --collective-conductivity 均 exit 0 并写出 JSON/CSV/图与 provenance。
GEMDAT 在三温度全部 Error: No jumps found(显式 --sites 用理想 2×2×2 的 Na 位点)。这是 10 ps 内位点跳跃事件不足,属统计不足,不是软件错误;仓库自身的 analysis_suite.py 也要求 ≥24 次事件才给定量结论。
9. 可靠性:队列、故障注入、缓存与性能
队列(隔离 MLIPORT_JOBS_DIR,6+3 个 CPU 任务)
max_concurrent=1下实测并发度始终为 1,作业时间区间零重叠(overlapping_pairs: [])。- 第二个调度器被拒绝:
Error: A scheduler is already running。 - 暂停/恢复(单个作业与整队)生效,状态机为
pending → paused → pending → running → done。 - 作业失败(损坏结构)如实记为
failed,不影响后续作业;汇总done 6 / failed 1。 - SIGTERM 到前台调度器:0.5 s 内退出(退出码 −15;一个正在运行作业的
job_worker属于独立会话,继续跑完并自行写回状态)、重启后队列继续排空、结束时无残留调度器进程。注意:这是"调度器被杀但正在运行的 worker 存活"的设计,若 worker 本身被 SIGKILL,作业会停在 running,直到下一次调度器的 stale 恢复逻辑接手(本轮未单独验证这一点)。
输出与磁盘故障注入
| 用例 | 结果 |
|---|---|
| 只读输出目录 | 拒绝并提示:Cannot write in output directory … Permission denied,未产生任何结果文件 |
已存在结果的目录(无 --overwrite) |
拒绝,并列出已存在的文件 |
| 两个进程同时写同一目录 | 第二个被运行目录锁拒绝 |
| 轨迹被截断 | analyze 硬失败(buffer is smaller than requested size,exit 1),不写分析结果 |
ENOSPC(定向注入到 JsonWriter.write) |
抛出 OSError: [Errno 28],只留下 OUTCAR,没有 mliport_results.json、没有 success 声明、没有残留临时文件 |
单点运行目录交给 analyze |
报 [Errno 21] Is a directory(真实原因是"没有轨迹")——信息误导,见 §10 R10-F07 |
模型切换、缓存与显存
- DPA A→B→A:三次同一模型同一结构的能量为 −42.8126919 / −42.8126899(B 之后)/ −42.8126919(另一结构之后)eV。差 2×10⁻⁶ eV,与官方 harness 测得的 DPA float32 重复性下限同量级 → 没有证据表明存在跨模型的状态污染;同时说明 float32 后端本身不位级可重复,任何"逐位相同"的断言都不成立。
- 模型加载失败(不存在路径)后立刻加载正常模型:能量与失败前完全相同 → 失败不污染后续加载。
- 连续 8 次创建/销毁 DPA 计算器:
torch.cuda.memory_allocated()恒为 17.039 MB → 无泄漏。 - GRACE 邻居缓存 ON/OFF:ΔE = 7.2×10⁻⁷ eV、Δσ ≤ 2.5×10⁻⁹ eV/ų(TF float32 噪声)。
- MACE dtype 切换:
info()正确报告['float32']/['float64'],能量差 6.6×10⁻⁶ eV,不混淆精度身份。
性能(官方 T8 套件,全部 pass)
| 模型 | SP 冷启动 | SP 暖 32/128/512 原子 | 原子/秒 (512) | MD 128 原子 | MD 512 原子 |
|---|---|---|---|---|---|
| DPA-3.1-3M | 14.04 s(32 原子,含编译) | 165.7 / 167.9 / 177.6 ms | 2893 | 5.94 步/s(760 atom-step/s) | 5.64 步/s(2889 atom-step/s) |
| UMA-s-1p2 | 2.05 s | 103.7 / 105.2 / 205.0 ms | 2501 | 9.50 步/s(1216 atom-step/s) | 4.88 步/s(2499 atom-step/s) |
这些数字只属于"本机 V100 + 该模型/版本",不推广到其他 GPU。
10. 发现的缺陷与修复
R10-F06(新,P1,已修复 → PR #110,Draft)
- 症状:DPA 后端返回
converged = np.bool_(False);classify_result用converged is False判断,np.False_ is False为假 → 落到COMPLETED。 - 影响:
mliport opt打印Converged: No却 exit 0(文档承诺 status 2);mliport batch --calc-type opt记为completed/success: true/not_converged: 0;队列作业按退出码派生状态同样错。不会改变已写入的converged字段,但会让下游脚本/汇总把未收敛结构当成成功。 - 最小复现:
mliport opt cu32_rattled.vasp --fmax 0.0001 --max-steps 5(DPA4C-Nano, GPU)。 - 修复:比较前归一化为 Python bool;无法解释为单一布尔值时 fail closed 为
NOT_CONVERGED。 - 红/绿:新增 2 个失败用例(batch 参数化 +
classify_result),修复后 2317 passed。CI 12/12 checks SUCCESS,MERGEABLE/CLEAN。
R10-F01(旧账,P2,已修复待审 → PR #111,Draft,CI 12/12 SUCCESS)
- 症状:NPT 的 4 个纯配置冲突(
thermostat≠LANGEVIN、--no-write-trajectory、temperature≤0、npt_tdamp/pdamp≤0)在results/、resolved_config.json、模型加载之后才拒绝。 - 修复:四条校验前移到
resolver._validate_resolved(),错误文本与MDRunner完全一致;MDRunner内校验保留(API 直调仍受保护)。 - 证据:修复前 4 个用例全部
results_dir=Y resolved=Y model_loaded=Y;修复后全部N/N/N,退出码仍为 1、消息不变。合法 NVE / NVT-NHC / NPT 的md.csv与修复前逐字节相同(md5 一致)。 - 仍残留:
NHC + FixAtoms的拒绝仍发生在模型加载之后(它依赖结构,不是纯配置);设备不可用时的报错仍是原始 torch 文本(Attempting to deserialize object on a CUDA device…)。这两条记录为遗留项,不在本轮修改。
NEB-RESUME-01(新,P2,未修复)
docs/workflows/neb.md 明确写:"Step budgets are part of that identity in this
beta, so a resume that changes --max-steps is rejected with
Resume fingerprint is incompatible。"
本轮实测:从同一个已取消(cancelled,3 个 checkpoint)的 CI-NEB 复制出三份,
分别用 ① 完全相同的选项、② --max-steps 123(记录值 200)、③ 去掉 --climb
去 resume。三者全部 exit 0 并跑完。检查 resolved_config.json:max_steps
仍是记录值 200,source 标成 CLI——也就是说 checkpoint 层的 run_options
覆盖了用户显式传入的值,指纹因此永远与记录一致,"改了参数就拒绝"这条文档承诺
没有被执行。
- 科学影响:不会污染数据(band 与协议保持一致,续算忠实),但会静默忽略用户意图(例如用户以为自己在切换 CI-NEB,实际没有),与 AGENTS.md 第 2/3 条"不得静默改变语义、不满足假设时 fail closed"相悖。
- 为什么本轮不改:修复点在
cmd_neb的 resume 分支与 resolver 的层优先级(checkpoint_resolved_layer作为incar_layer注入,实际优先级高于 CLI)。改动会波及 INCAR/设置/alise 等所有 resume 入口的既有语义,属于需要重新设计的公共行为;按任务书"若提前校验需要改变公共 API/重新设计,则停止代码修改,记录技术障碍",本轮只记录。 - 建议(供 owner 决策):在 resume 分支里对显式传入的 CLI 参数与 checkpoint 记录值逐项比较,冲突时抛出文档承诺的错误(并列出冲突项名);或在文档中明确"resume 一律沿用 checkpoint 的记录值,命令行同名参数被忽略"。两条路都必须二选一,现状是第三种(文档说拒绝、行为是静默覆盖)。
其它已确认但未修改的问题
| 编号 | 级别 | 现象 | 处理 |
|---|---|---|---|
| R10-F07 | P3 | mliport analyze <单点运行目录> thermo 报 [Errno 21] Is a directory,实际原因是"该目录里没有轨迹";错误信息误导 |
只记录,建议改成明确的"no trajectory in this run" |
| R10-F08 | P3 | 分析结果 id 不覆盖 raw/mliport_results.json;结果文件被截断时,若同 id 的分析已完成则直接复用(--force 后在轨迹被截断时报 buffer is smaller than requested size) |
只记录;分析主输入是轨迹,复用语义本身有文档 |
| R10-F05 | P3 | mliport confsearch run 没有 --device,只能经 settings/INCAR 传设备;confsearch resume 只接受计算器选项 |
只验证既有路径可用,建议补文档说明,不新增选项 |
| R10-F04 | P3 | mliport/utils.py(191 行、8 函数)无任何 importer,仍随 wheel 发布 |
确认无引用;按任务书不删除,只记录 |
| — | 观察 | 官方 science harness 有 6 条 fail 记录,全部是 float32 旋转/平移不变性在 10⁻⁶ eV/Å 量级的偏差(阈值 = 10×实测重复性下限) |
保留 fail 原样,本轮不擅自改判;这是后端精度而非产品缺陷 |
11. 未完成项与风险
没有做、或只做了一部分的(按任务书要求如实分类)
| 项 | 状态 | 原因 |
|---|---|---|
| MLIP vs DFT 精度对照(Na₃PS₄ / LPSC / Li₂S) | BLOCKED | 本机没有元数据完整且已收敛的 CP2K/VASP 标签;旧 Na₃PS₄ 力标签未充分收敛,按规则不得当真值;本轮无 DFT 授权 |
| LLZO(Li₇La₃Zr₂O₁₂)工作流 | 部分 | 只用 mp-942733 做了 SP + E/F/stress(5 个模型);96 原子单胞的 OPT/MD/输运未做 |
| LPSC 深度工作流 | 部分 | SP(7 模型)、固定胞 OPT、1500 K 短时 NVT 完成;未做变胞 OPT、NPT、长 MD、输运(无 Na/Li 迁移统计意义) |
| LGPS 输运 / Arrhenius | NOT_RUN | 时间与 GPU 预算优先给了 Na₃PS₄ 三温度;LGPS 只做了 SP、NPT(0/2 GPa)与 examples/ 结构一致性核对 |
| Na₃PS₄ 电导率 / 活化能 | INCONCLUSIVE | 10 ps×3 温度,D 的不确定度约 2 倍,700→800 K 非单调;Arrhenius Ea=0.120±0.121 eV、R²=0.43 → 只能说"算法正确、采样不足" |
| GEMDAT 位点/跳跃定量 | INCONCLUSIVE | 三温度均 No jumps found(10 ps 内事件不足);仓库自身要求 ≥24 事件 |
| NEP89 原生 GPUMD 路径 | BLOCKED | GPUMD/src/gpumd 缺少 libnvJitLink.so.12(其余 CUDA 库可从 uv 缓存补齐);按授权不重新编译 GPUMD |
| NEP89 ASE/Calorine 路径 | UNSUPPORTED | 新版 nep.txt 格式 Calorine 无法解析(已知限制) |
| 官方 science harness T6(MD 套件) | NOT_RUN(已启动后中止) | 固定 profile 是 DPA-3.1-3M,实测约 4.6 步/s(128 原子),单是 NVE 步长扫描就远超本轮剩余预算;改用本报告 §5 的自建 MD 矩阵覆盖,并在 #75 记录中止事实与速率 |
| 官方 science harness T5(NEB 套件) | NOT_RUN | 其 Na₃PS₄ hop 与 Cu 空位端点需要内置 fixture 的完整 8 条工作流,耗时不可控;改用 §6 的直接 CLI NEB/CI-NEB + 中断/续算覆盖 |
| MACE 官方 pinned profile | BLOCKED | model_manifest.json 钉的是 mace-omat-0-medium(sha256 d4b14be9…),本机没有该文件;mace-mh-1 是不同 artifact,按规则不得替代 |
| TUI | NOT_RUN | 交互式界面无法在无人值守下做真实点击;其代码路径由 pytest tests/mliport/mliport/test_tui.py 覆盖(本轮全绿) |
| INCAR / settings / API / CLI 语义一致性 | 部分 | 通过 INCAR(run + npt 用例)、settings(confsearch 的 DEVICE)、CLI(全部用例)、Python API(F3 探针)分别跑通;没有做四入口的穷举笛卡尔积 |
| 队列的 stale-PID / 被盗 lease 恢复 | 部分 | SIGTERM 调度器→worker 继续→重启排空已验证;SIGKILL 掉 worker 后的 stale 恢复未单独构造 |
| 500 原子以上的长时间 MD/NEB | NOT_RUN | 只做了 512 原子 SP/短 MD 性能冒烟(T8),符合"不强行跑 500 原子"的约束 |
12. 统计口径
154 条用例:PASS 119 / CHARACTERIZED 31 / INCONCLUSIVE 1 / FAIL 2 / NOT_RUN 1(两个 FAIL 都是 NEB resume 的"文档承诺未执行",不是算错数)。harness 记录 96 个带日志的用例(83 OK / 13 非零退出,后者含预期中的拒绝与负例),GPU 墙钟约 3 h、磁盘 509 MB、无残留进程/调度器/GPU lease。逐条证据见 CASE_MATRIX.md 与 summary.json。
13. 稳定版本建议
建议:可以打"稳定测试版"标签(2.0.0b4 之后的下一个 beta),但不要打正式 2.0.0。
支持这个判断的证据:
- 2316 个测试全绿、lint/docs/hygiene 全清;本轮 154 条验收用例中 119 PASS、31 CHARACTERIZED、1 INCONCLUSIVE、2 FAIL、1 NOT_RUN(后两者都是文档承诺未被执行,不是算错数)。
- 真实 V100 上四个后端、16 个本地 checkpoint、7 种晶胞、SP/OPT/batch/NEB/CI-NEB/confsearch/NVE/NVT/NPT/输运分析全部跑通并且产物可追溯。
- 全部"失败即静默成功"的路径都做了主动攻击:损坏结构、空结构、非周期输入、只读目录、并发写、ENOSPC、截断轨迹、换模型续算、损坏 checkpoint、非法 MD 组合。除 §10 的两条已修复缺陷外,其余全部 fail closed 并留下可诊断的 provenance。
- 单位、符号、Voigt 顺序、PBC、task/head/dtype 身份在 CLI 输出、JSON、OUTCAR、
artifacts.json之间一致,并且有独立已知答案(Arrhenius 反演精确到 1e-8;Si 变胞 a=5.3751 Å 与菱方原胞 3.8003 Å 自洽;Cu 空位势垒 0.739/0.751 eV 落在文档区间)。
打正式版之前仍应处理:
- 合并或明确拒绝 fix(run-status): numpy converged flag no longer becomes success (R10-F06/P1) #110(numpy bool → 未收敛被记为成功)。这是本轮唯一会悄悄污染批量/队列统计的缺陷;不合并就应在发布说明里明确"未收敛判定不可靠"。
- 裁定 NEB resume 的文档与行为冲突(NEB-RESUME-01)。科学数据不会因此损坏,但"改了参数却被静默忽略"在科研软件里不可接受。
- 把 §11 的 INCONCLUSIVE 项(Na₃PS₄ 电导率、GEMDAT 跳跃)从任何"材料结论"里排除;它们目前只是软件闭环证据。
- 若要在发布说明里声称"支持 NEP89",必须先解决原生 GPUMD 的 CUDA 运行库依赖(本机缺
libnvJitLink.so.12)或明确只支持旧格式。
一句话:软件工程与科学契约层面可以定版;材料精度与统计结论层面不能。 这两件事不要写在同一个句子里。
CASE_MATRIX.md(154 条用例)
| Case ID | Material | Model | Task | Device | Status | Evidence |
|---|---|---|---|---|---|---|
| T1-dpa-sse-legacy | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | SSE-VASP-dpa2 (legacy runtime) | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa-sse-legacy.json: 6 materials, load_error=None |
| T1-dpa31-3m-omat24 | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | DPA-3.1-3M (Omat24) | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa31-3m-omat24.json: 6 materials, load_error=None |
| T1-dpa4-air | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | DPA4-Air | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa4-air.json: 6 materials, load_error=None |
| T1-dpa4-neo | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | DPA4-Neo | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa4-neo.json: 6 materials, load_error=None |
| T1-dpa4-plus | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | DPA4-Plus | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa4-plus.json: 6 materials, load_error=None |
| T1-dpa41c-air | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | DPA-4.1C-Air | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa41c-air.json: 6 materials, load_error=None |
| T1-dpa4c-mini | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | DPA4C-Mini | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa4c-mini.json: 6 materials, load_error=None |
| T1-dpa4c-nano | Si/Cu/Li2S/Na3PS4/LPSC/LGPS/LLZO | DPA4C-Nano | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-dpa4c-nano.json: 7 materials, load_error=None |
| T1-grace-2l-omat-fp64 | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | GRACE-2L-OMAT-medium-base fp64 | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-grace-2l-omat-fp64.json: 6 materials, load_error=None |
| T1-grace-2l-omat | Si/Cu/Li2S/Na3PS4/LPSC/LGPS/LLZO | GRACE-2L-SMAX-OMAT-medium | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-grace-2l-omat.json: 7 materials, load_error=None |
| T1-mace-mh1-omat | Si/Cu/Li2S/Na3PS4/LPSC/LGPS/LLZO | mace-mh-1 head=omat_pbe | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-mace-mh1-omat.json: 7 materials, load_error=None |
| T1-uma-ft-r2scan | Si/Li2S | UMA-s-1p2p1-ft-r2scan (omat) | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-uma-ft-r2scan.json: 2 materials, load_error=None |
| T1-uma-s1p1-omat | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | UMA-s-1p1 (omat) | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-uma-s1p1-omat.json: 6 materials, load_error=None |
| T1-uma-s1p2-omat | Si/Cu/Li2S/Na3PS4/LPSC/LGPS/LLZO | UMA-s-1p2 (omat) | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-uma-s1p2-omat.json: 7 materials, load_error=None |
| T1-uma-s1p2p1-omat | Si/Cu/Li2S/Na3PS4/LPSC/LGPS | UMA-s-1p2p1 (omat) | SP T1 (E/F/stress, identity) | cuda:0 | PASS | probe/T1-uma-s1p2p1-omat.json: 6 materials, load_error=None |
| SCI-dpa-t1_cu_fcc | cu | DPA | science harness t1_real_inference | cuda:0 | PASS | science_commit/summary.json[t1_cu_fcc/t1_real_inference/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t1_cu_fcc | cu | UMA | science harness t1_real_inference | cuda:0 | PASS | science_commit/summary.json[t1_cu_fcc/t1_real_inference/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t1_mgo_rocksalt | mgo | DPA | science harness t1_real_inference | cuda:0 | PASS | science_commit/summary.json[t1_mgo_rocksalt/t1_real_inference/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t1_mgo_rocksalt | mgo | UMA | science harness t1_real_inference | cuda:0 | PASS | science_commit/summary.json[t1_mgo_rocksalt/t1_real_inference/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t1_si_diamond | si | DPA | science harness t1_real_inference | cuda:0 | PASS | science_commit/summary.json[t1_si_diamond/t1_real_inference/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t1_si_diamond | si | UMA | science harness t1_real_inference | cuda:0 | PASS | science_commit/summary.json[t1_si_diamond/t1_real_inference/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_distorted | cu | DPA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_cu_distorted/t2_invariance_ab_reversibility/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_distorted | cu | UMA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_cu_distorted/t2_invariance_ab_reversibility/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_distorted | cu | DPA | science harness t2_invariance_global_rotation | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_distorted/t2_invariance_global_rotation/dpa-upstream-model-defined-24dc1695f3] = fail |
| SCI-uma-t2_cu_distorted | cu | UMA | science harness t2_invariance_global_rotation | cuda:0 | PASS | science_commit/summary.json[t2_cu_distorted/t2_invariance_global_rotation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_distorted | cu | DPA | science harness t2_invariance_global_translation | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_distorted/t2_invariance_global_translation/dpa-upstream-model-defined-24dc1695f3] = fail |
| SCI-uma-t2_cu_distorted | cu | UMA | science harness t2_invariance_global_translation | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_distorted/t2_invariance_global_translation/uma-upstream-model-defined-f16c843796] = fail |
| SCI-dpa-t2_cu_distorted | cu | DPA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_cu_distorted/t2_invariance_pbc_wrap/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_distorted | cu | UMA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_cu_distorted/t2_invariance_pbc_wrap/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_distorted | cu | DPA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_cu_distorted/t2_invariance_permutation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_distorted | cu | UMA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_cu_distorted/t2_invariance_permutation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_distorted | cu | DPA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_distorted/t2_invariance_repeatability/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2_cu_distorted | cu | UMA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_distorted/t2_invariance_repeatability/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2_cu_fcc | cu | DPA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_ab_reversibility/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_fcc | cu | UMA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_ab_reversibility/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_fcc | cu | DPA | science harness t2_invariance_global_rotation | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_global_rotation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_fcc | cu | UMA | science harness t2_invariance_global_rotation | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_fcc/t2_invariance_global_rotation/uma-upstream-model-defined-f16c843796] = fail |
| SCI-dpa-t2_cu_fcc | cu | DPA | science harness t2_invariance_global_translation | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_global_translation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_fcc | cu | UMA | science harness t2_invariance_global_translation | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_global_translation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_fcc | cu | DPA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_pbc_wrap/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_fcc | cu | UMA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_pbc_wrap/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_fcc | cu | DPA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_permutation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_cu_fcc | cu | UMA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_cu_fcc/t2_invariance_permutation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_cu_fcc | cu | DPA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_fcc/t2_invariance_repeatability/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2_cu_fcc | cu | UMA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_cu_fcc/t2_invariance_repeatability/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2_mgo_rocksalt | mgo | DPA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_ab_reversibility/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_mgo_rocksalt | mgo | UMA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_ab_reversibility/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_mgo_rocksalt | mgo | DPA | science harness t2_invariance_global_rotation | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_global_rotation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_mgo_rocksalt | mgo | UMA | science harness t2_invariance_global_rotation | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_global_rotation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_mgo_rocksalt | mgo | DPA | science harness t2_invariance_global_translation | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_global_translation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_mgo_rocksalt | mgo | UMA | science harness t2_invariance_global_translation | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_global_translation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_mgo_rocksalt | mgo | DPA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_pbc_wrap/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_mgo_rocksalt | mgo | UMA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_pbc_wrap/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_mgo_rocksalt | mgo | DPA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_permutation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_mgo_rocksalt | mgo | UMA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_permutation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_mgo_rocksalt | mgo | DPA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_repeatability/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2_mgo_rocksalt | mgo | UMA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_mgo_rocksalt/t2_invariance_repeatability/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2_si_diamond_prim | si | DPA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_ab_reversibility/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_si_diamond_prim | si | UMA | science harness t2_invariance_ab_reversibility | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_ab_reversibility/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_si_diamond_prim | si | DPA | science harness t2_invariance_global_rotation | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_global_rotation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_si_diamond_prim | si | UMA | science harness t2_invariance_global_rotation | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_global_rotation/uma-upstream-model-defined-f16c843796] = fail |
| SCI-dpa-t2_si_diamond_prim | si | DPA | science harness t2_invariance_global_translation | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_global_translation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_si_diamond_prim | si | UMA | science harness t2_invariance_global_translation | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_global_translation/uma-upstream-model-defined-f16c843796] = fail |
| SCI-dpa-t2_si_diamond_prim | si | DPA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_pbc_wrap/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_si_diamond_prim | si | UMA | science harness t2_invariance_pbc_wrap | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_pbc_wrap/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_si_diamond_prim | si | DPA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_permutation/dpa-upstream-model-defined-24dc1695f3] = pass |
| SCI-uma-t2_si_diamond_prim | si | UMA | science harness t2_invariance_permutation | cuda:0 | PASS | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_permutation/uma-upstream-model-defined-f16c843796] = pass |
| SCI-dpa-t2_si_diamond_prim | si | DPA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_repeatability/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2_si_diamond_prim | si | UMA | science harness t2_invariance_repeatability | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2_si_diamond_prim/t2_invariance_repeatability/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_cu_distorted | cu | DPA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_distorted/t2_force_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_cu_distorted | cu | UMA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_distorted/t2_force_fd/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_cu_distorted | cu | DPA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_distorted/t2_stress_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_cu_distorted | cu | UMA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_distorted/t2_stress_fd/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_cu_fcc | cu | DPA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_fcc/t2_force_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_cu_fcc | cu | UMA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_fcc/t2_force_fd/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_cu_fcc | cu | DPA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_fcc/t2_stress_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_cu_fcc | cu | UMA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_cu_fcc/t2_stress_fd/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_mgo_rocksalt | mgo | DPA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_mgo_rocksalt/t2_force_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_mgo_rocksalt | mgo | UMA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_mgo_rocksalt/t2_force_fd/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_mgo_rocksalt | mgo | DPA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_mgo_rocksalt/t2_stress_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_mgo_rocksalt | mgo | UMA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_mgo_rocksalt/t2_stress_fd/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_si_diamond_prim | si | DPA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_si_diamond_prim/t2_force_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_si_diamond_prim | si | UMA | science harness t2_force_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_si_diamond_prim/t2_force_fd/uma-upstream-model-defined-f16c843796] = characterized |
| SCI-dpa-t2fd_si_diamond_prim | si | DPA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_si_diamond_prim/t2_stress_fd/dpa-upstream-model-defined-24dc1695f3] = characterized |
| SCI-uma-t2fd_si_diamond_prim | si | UMA | science harness t2_stress_fd | cuda:0 | CHARACTERIZED | science_commit/summary.json[t2fd_si_diamond_prim/t2_stress_fd/uma-upstream-model-defined-f16c843796] = characterized |
| opt_cu32_cellopt_dpa | cu32 | DPA4C-Nano | OPT cell | cuda:0 | PASS | a2_opt/opt_cu32_cellopt_dpa.json converged=True nsteps=12 fmax=1.0635959459132094e-06 |
| opt_cu32_maxsteps_dpa | cu32 | DPA4C-Nano | OPT fixed cell | cuda:0 | INCONCLUSIVE | a2_opt/opt_cu32_maxsteps_dpa.json converged=True nsteps=0 fmax=5.65804145670739e-07 |
| opt_lpsc_26_fixed_dpa | lpsc | DPA4C-Nano | OPT fixed cell | cuda:0 | PASS | a2_opt/opt_lpsc_26_fixed_dpa.json converged=True nsteps=22 fmax=0.01756567727352376 |
| opt_na3ps4_32_cellopt_dpa | na3ps4 | DPA4C-Nano | OPT cell | cuda:0 | PASS | a2_opt/opt_na3ps4_32_cellopt_dpa.json converged=True nsteps=28 fmax=0.01068125585152302 |
| opt_na3ps4_32_fixed_dpa | na3ps4 | DPA4C-Nano | OPT fixed cell | cuda:0 | PASS | a2_opt/opt_na3ps4_32_fixed_dpa.json converged=True nsteps=11 fmax=0.012493796122726053 |
| opt_na3ps4_sheared_cellopt_dpa | na3ps4 | DPA4C-Nano | OPT cell | cuda:0 | PASS | a2_opt/opt_na3ps4_sheared_cellopt_dpa.json converged=True nsteps=59 fmax=0.019162205639986496 |
| opt_si8_cellopt_dpa | si8 | DPA4C-Nano | OPT cell | cuda:0 | PASS | a2_opt/opt_si8_cellopt_dpa.json converged=True nsteps=20 fmax=4.729372808543126e-06 |
| opt_si8_cellopt_mace | si8 | mace-mh-1 | OPT cell | cuda:0 | PASS | a2_opt/opt_si8_cellopt_mace.json converged=True nsteps=15 fmax=2.429995817060512e-14 |
| opt_si_prim_nonortho_cellopt_dpa | si | DPA4C-Nano | OPT cell | cuda:0 | PASS | a2_opt/opt_si_prim_nonortho_cellopt_dpa.json converged=True nsteps=11 fmax=6.88305590371141e-08 |
| BATCH-sp_baseline | 14 mixed | DPA4C-Nano | batch sp/opt + resume | cuda:0 | PASS | batch_acceptance.json[sp_baseline] counts={'completed': 11, 'failed': 3} reused=0 status_files=14 |
| BATCH-sp_resume_noop | 14 mixed | DPA4C-Nano | batch sp/opt + resume | cuda:0 | PASS | batch_acceptance.json[sp_resume_noop] counts={'completed': 11, 'failed': 3} reused=11 status_files=14 |
| BATCH-sp_resume_changed_input | 14 mixed | DPA4C-Nano | batch sp/opt + resume | cuda:0 | PASS | batch_acceptance.json[sp_resume_changed_input] counts={'completed': 11, 'failed': 3} reused=10 status_files=14 |
| BATCH-sp_resume_changed_model | 14 mixed | DPA4C-Nano | batch sp/opt + resume | cuda:0 | PASS | batch_acceptance.json[sp_resume_changed_model] counts={'completed': 11, 'failed': 3} reused=10 status_files=14 |
| BATCH-opt_limited_steps | 14 mixed | DPA4C-Nano | batch sp/opt + resume | cuda:0 | PASS | batch_acceptance.json[opt_limited_steps] counts={'completed': 11, 'failed': 3} reused=0 status_files=14 |
| BATCH-sp_interrupted | 14 mixed | DPA4C-Nano | batch sp/opt + resume | cuda:0 | PASS | batch_acceptance.json[sp_interrupted] counts={'completed': 11, 'failed': 3} reused=0 status_files=14 |
| BATCH-sp_interrupted_resume | 14 mixed | DPA4C-Nano | batch sp/opt + resume | cuda:0 | PASS | batch_acceptance.json[sp_interrupted_resume] counts={'completed': 11, 'failed': 3} reused=11 status_files=14 |
| cu_neb_plain | Cu (vacancy, 107 atoms) | DPA4C-Nano | NEB/CI-NEB | cuda:0 | PASS | neb/cu_neb_plain.json barrier_fwd=None barrier_rev=None converged=True exit=0 |
| cu_neb_climb | Cu (vacancy, 107 atoms) | DPA4C-Nano | NEB/CI-NEB | cuda:0 | PASS | neb/cu_neb_climb.json barrier_fwd=None barrier_rev=None converged=True exit=0 |
| cu_neb_step_limited | Cu (vacancy, 107 atoms) | DPA4C-Nano | NEB/CI-NEB | cuda:0 | PASS | neb/cu_neb_step_limited.json barrier_fwd=0.753931999206543 barrier_rev=0.7539281845092773 converged=False exit=2 |
| cu_neb_resumed_from_limit | Cu (vacancy, 107 atoms) | DPA4C-Nano | NEB/CI-NEB | cuda:0 | PASS | neb/cu_neb_resumed_from_limit.json barrier_fwd=0.753931999206543 barrier_rev=0.7539281845092773 converged=False exit=1 |
| cu_neb_interrupted | Cu (vacancy, 107 atoms) | DPA4C-Nano | NEB/CI-NEB | cuda:0 | PASS | neb/cu_neb_interrupted.json barrier_fwd=0.7509031295776367 barrier_rev=0.7509031295776367 converged=True exit=0 |
| cu_neb_resumed_after_interrupt | Cu (vacancy, 107 atoms) | DPA4C-Nano | NEB/CI-NEB | cuda:0 | PASS | neb/cu_neb_resumed_after_interrupt.json barrier_fwd=0.7509021759033203 barrier_rev=0.7509098052978516 converged=True exit=0 |
| NEB-interrupt-resume | Cu (vacancy) | DPA4C-Nano | CI-NEB interrupted then resumed | cuda:0 | PASS | interrupted status=cancelled exit=130; resumed barrier=0.751460075378418 eV vs uninterrupted None eV |
| NEB-resume-other-model | Cu (vacancy) | DPA4C-Nano vs Mini | resume with another model | cuda:0 | PASS | refused: ['NEB calculation failed: Resume fingerprint is incompatible with this model, backend, task/head/dtype, cell/PBC, identi |
| NEB-resume identical options | Cu (vacancy) | DPA4C-Nano | resume identical options | cuda:0 | PASS | exit=0 status=['NEB status: completed'] checkpoint step_000002:7:f1b6b98abf53 -> step_000025:7:ec2229e5a0f9 |
| NEB-resume with --max-steps changed | Cu (vacancy) | DPA4C-Nano | resume with --max-steps changed | cuda:0 | FAIL | exit=0 status=['NEB status: completed'] checkpoint step_000002:7:f1b6b98abf53 -> step_000006:7:4203b56b5f31 — docs promise a rejection; the recorded options silently win |
| NEB-resume with --climb removed | Cu (vacancy) | DPA4C-Nano | resume with --climb removed | cuda:0 | FAIL | exit=0 status=['NEB status: completed'] checkpoint step_000002:7:f1b6b98abf53 -> step_000025:7:d59ef7bee311 — docs promise a rejection; the recorded options silently win |
| A1-voigt-dpa | Na3PS4 sheared (artificial) | DPA | SP stress component order | cuda | PASS | voigt=['-8.15e-03', '-1.86e-02', '8.53e-03', '3.44e-09', '-1.55e-08', '7.32e-03'] (xy non-zero, yz/xz ~0) |
| A1-voigt-mace | Na3PS4 sheared (artificial) | MACE | SP stress component order | cuda | PASS | voigt=['-5.53e-03', '-1.50e-02', '7.86e-03', '-1.23e-17', '1.08e-17', '6.90e-03'] (xy non-zero, yz/xz ~0) |
| A1-pbc-molecule | H2O (non-periodic) | DPA4C-Nano | SP with task=bulk | cuda | PASS | bulk task refused a non-periodic input |
| A1-pbc-molecule-ok | H2O (non-periodic) | mace-mh-1 | SP with task=molecule | cuda | PASS | molecule task accepted the same input |
| A1-pbc-slab2d | Cu 2D slab | DPA4C-Nano | SP with task=bulk | cuda | NOT_RUN | the slab fixture was written as a 3D-periodic cell, so 2D rejection was not exercised |
| A1-upstream-dpa | Si8 | DPA | mliport CLI vs upstream ASE calculator | cuda | PASS | dE=0.0 eV, upstream=deepmd 3.2.1.dev63+g0edeaef56 (upstream ASE DP calculator) |
| A1-upstream-mace | Si8 | MACE | mliport CLI vs upstream ASE calculator | cuda | PASS | dE=7.105427357601002e-15 eV, upstream=mace 0.3.16 (upstream MACECalculator) |
| CONFSEARCH-ref | CH3OH on LGPS slab | DPA4C-Nano | confsearch mode B | cuda:0 | PASS | confsearch_resume.json reference |
| CONFSEARCH-resume | CH3OH on LGPS slab | DPA4C-Nano | confsearch interrupted + resume | cuda:0 | PASS | confsearch_determinism.json |
| CONFSEARCH-refusal | CH3OH on LGPS slab | DPA4C-Nano | resume with other model/task; corrupt state | cuda:0 | PASS | confsearch_resume.json resume_other_model/task, corrupt |
| ARRHENIUS-known-answer | - | synthetic D0/Ea | arrhenius fit | cpu | PASS | Ea=0.29999995 eV recovered from a known 0.3 eV synthetic set |
| QUEUE-serialisation | - | DPA4C-Nano (cpu) | queue max_concurrent=1 | cpu | PASS | queue_acceptance.json overlaps=[] |
| QUEUE-race | - | - | two schedulers | cpu | PASS | second scheduler exit=1 |
| QUEUE-pause-resume | - | - | pause/resume job and queue | cpu | PASS | queue_acceptance.json pause/resume_job/resume_queue |
| QUEUE-sigterm | - | - | SIGTERM scheduler + restart | cpu | PASS | exit=-15 delay=0.5s final={'t0': 'done', 't1': 'done', 't2': 'done', 't3': 'done'} |
| FAULT-output-writes | - | DPA4C-Nano | readonly dir / existing dir / concurrency | cuda:0 | PASS | f2_output_faults.json |
| FAULT-enospc | - | stub calculator | ENOSPC at JsonWriter | cpu | PASS | f2b_faults.json enospc_at_json_writer: OSError(28), no results json |
| FAULT-truncated-evidence | - | - | truncated trajectory/results | cpu | PASS | f2b_faults.json / faults2/f2c_md_faults.json |
| CACHE-A-B-A | - | DPA4C-Nano | model switch + failed load recovery | cuda:0 | CHARACTERIZED | A_first vs A_second delta=1.91e-06 eV (float32 backend floor); bad load then good load identical=True |
| CACHE-grace-neighbor | Na3PS4 | GRACE-2L | neighbor cache ON vs OFF | cuda:0 | PASS | |dE|=7.15e-07 eV |
| DTYPE-mace-32-64 | Si | mace-mh-1 | float32 vs float64 identity | cuda:0 | PASS | reported dtypes ['float32'] / ['float64'] |
| npt_lgps_200_0GPa | Si8/Na3PS4/LGPS | DPA4C-Nano | MD NPT (isotropic MTK) | cuda:0 | PASS | P=0.0144±0.0368 GPa, axis spread=6.661338147750939e-16, angle spread=0.0 |
| npt_lgps_200_2GPa | Si8/Na3PS4/LGPS | DPA4C-Nano | MD NPT (isotropic MTK) | cuda:0 | PASS | P=1.996±0.0276 GPa, axis spread=6.661338147750939e-16, angle spread=0.0 |
| npt_na3ps4_32_0GPa | Si8/Na3PS4/LGPS | DPA4C-Nano | MD NPT (isotropic MTK) | cuda:0 | PASS | P=0.0107±0.0279 GPa, axis spread=4.440892098500626e-16, angle spread=0.0 |
| npt_na3ps4_32_2GPa | Si8/Na3PS4/LGPS | DPA4C-Nano | MD NPT (isotropic MTK) | cuda:0 | PASS | P=1.9872±0.0353 GPa, axis spread=4.440892098500626e-16, angle spread=0.0 |
| npt_na3ps4_sheared_0GPa | Si8/Na3PS4/LGPS | DPA4C-Nano | MD NPT (isotropic MTK) | cuda:0 | PASS | P=0.0006±0.113 GPa, axis spread=4.440892098500626e-16, angle spread=0.0 |
| npt_si8_0GPa | Si8/Na3PS4/LGPS | DPA4C-Nano | MD NPT (isotropic MTK) | cuda:0 | PASS | P=0.011±0.0118 GPa, axis spread=0.0, angle spread=0.0 |
| npt_si8_2GPa | Si8/Na3PS4/LGPS | DPA4C-Nano | MD NPT (isotropic MTK) | cuda:0 | PASS | P=2.0541±0.0226 GPa, axis spread=0.0, angle spread=0.0 |
| nve_na3ps4_dt0.5 | Na3PS4 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=1.2312704013890578e-07 eV/atom/ps over 3.0 ps |
| nve_na3ps4_dt1.0 | Na3PS4 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=5.211118188851388e-07 eV/atom/ps over 3.0 ps |
| nve_si64_dt0.25 | Si64 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=-5.638071929660157e-09 eV/atom/ps over 3.0 ps |
| nve_si64_dt0.5 | Si64 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=-1.8014370387028793e-08 eV/atom/ps over 3.0 ps |
| nve_si64_dt1.0 | Si64 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=-7.587542154682241e-09 eV/atom/ps over 3.0 ps |
| nve_si64_dt1.0_repeat | Si64 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=1.5627503020165184e-08 eV/atom/ps over 3.0 ps |
| nve_si64_dt1.0_save1 | Si64 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=-5.100257581699348e-08 eV/atom/ps over 3.0 ps |
| nve_si64_dt1.0_seedB | Si64 | DPA4C-Nano | MD NVE | cuda:0 | PASS | drift=3.16893338315932e-07 eV/atom/ps over 3.0 ps |
| nvt_na3ps4_600K_LANGEVIN | Si64/Na3PS4 | DPA4C-Nano | MD NVT | cuda:0 | PASS | T=587.02±7.075 K (target in name) |
| nvt_na3ps4_600K_NHC | Si64/Na3PS4 | DPA4C-Nano | MD NVT | cuda:0 | PASS | T=579.8±17.838 K (target in name) |
| nvt_na3ps4_800K_BUSSI | Si64/Na3PS4 | DPA4C-Nano | MD NVT | cuda:0 | PASS | T=784.03±18.488 K (target in name) |
| nvt_si64_300K_BUSSI | Si64/Na3PS4 | DPA4C-Nano | MD NVT | cuda:0 | PASS | T=293.66±8.217 K (target in name) |
| nvt_si64_300K_LANGEVIN | Si64/Na3PS4 | DPA4C-Nano | MD NVT | cuda:0 | PASS | T=294.45±6.094 K (target in name) |
| nvt_si64_300K_NHC | Si64/Na3PS4 | DPA4C-Nano | MD NVT | cuda:0 | PASS | T=294.77±8.135 K (target in name) |
Rev 10 · 2026-11-17 · 冻结功能后的全覆盖验证与稳定化执行单(当前有效)
R10-执行状态 · 2026-11-17
第一批/第二批已执行完毕,结果见下方评论Rev 10 · 执行结果(2026-11-17)(main @
449ec9a4)。计划中的复选框未在本文勾选,避免把未执行项伪装成通过;确认缺陷的修复 PR:#108(#102/E8)、#109(R10-F02/F03)——两者已按 #108 → #109 合并,结果与 main 最新 SHA 见 合并结果;未修条目 F01/F04/F05 与 NOT_RUN/BLOCKED 清单保留在执行结果评论中。R10-0. Agent 执行指令与验收原则
R10-1. 基线与全仓工程检查(E)
R10-2. #104–#107 任务文件夹、INCAR、models/ 与 TUI(U;本轮新增重点)
R10-3. 数值核心、优化与所有 MD 系综(P;高风险)
R10-4. 全工作流与分析科学正确性(W/A)
R10-5. 全后端与硬件(B;有条件尽可能实测)
R10-6. 可靠性、接口、安装与安全(R)
R10-7. 文档、证据与发布门禁(D/G)
R10 执行顺序与停止条件
停止条件: 发现 P0 错误结果/静默数据破坏时暂停受影响工作流的信任声明并优先复现修复,其余独立测试继续;出现可破坏用户数据的操作或需要高成本硬件/下载时不执行并集中申请许可;无法复现只报 INCONCLUSIVE,不无休止重试。分阶段更新 #75,不等待全部工作完成后才首次报告。#61 和 #75 不添加代码、不合并关闭;独立修复 PR 是否 merge 仍由 owner 最终授权。
[DEV AUDIT · DO NOT MERGE / DO NOT CLOSE] Continuous correctness, reliability & exhaustive test campaign
0. 中文总纲(给项目负责人及执行 agent)
本 PR 只管理穷尽式代码审计、Bug 复现、科学/工程正确性测试和回归修复。不新增计算功能,不改训练/推理模型算法,不靠放宽阈值刷绿,不删除失败记录。任何性能改动也必须先有正确性证明,不允许静默改变默认任务、head、dtype、单位或 PBC。
分开评估:①静态代码审查;②隔离的 CPU/模拟 calculator 自动测试;③真实后端及硬件验证;④可复现的物理 known-answer / DFT 或 ASE 对照;⑤破坏性故障注入与结果持久化。CI 绿灯仅说明该 CI 矩阵通过,并不说明 GPU、科学外推可靠性及真实模型全覆盖。
覆盖四个推理后端 MACE / DPA / GRACE / UMA、D3、SP、opt、MD、NEB、confsearch、analysis、CLI/API/INCAR/TUI/queue、安装器及 VASP-like 输出。逐项填写证据和真实状态,不得虚构测试已经执行。
1. Binding rules (agents must follow)
2. Baseline and confidence boundaries
Current execution ledger (Revision 9)
ad44f578; finite fractional/overflow and exact large integer/CSV parsing regressions; rare longdouble/other dtype questions remain outside scopec7880a2; standard VASP XDATCAR preserved; matching MD provenance restores PBC; missing/untrusted PBC blocks bulk analysis. Branch CI green before merge; latest main CI tests still running at this update. Standalone-old-run analyses need provenance review.47fa28f; error result/JSON/progress regressions0d71f0a; per-result success/status/error/converged fields and summary totals now follow shared outcome classifier; PR and merge-to-main CI were green. Historical batch summaries may overstate success; check child results.77a94afd; kinetic stress with nonzero momenta and other writer paths remainec28ba3f) — see §2b — covering NEP89 weight loading, single-point E/F, force finite differences, 100 fs NVE and provenance. MACE / DPA / GRACE / UMA still have no real-model GPU evidence in this ledger.ec28ba3f, modelnep89_20250409.txtSHA256518c7065…d82b85, GPUMD 5.9.1 (sm_70) SHA256148259f2…d94bedb97, Tesla V100-SXM2-16GBGPU-f24116e9…. Native runtime loadsformat_version 1weights and produces FD-consistent forces (max 4.2e-4 eV/Å), zero net force, bit-identical repeats and 100 fs NVE drift of 5.5e-6 eV/atom. ASE/Calorine runtime cannot parse this model layout (documented limitation — fails closed). Provenance records model/gpumd/GPU/source SHA256 and float32 precision note. Details, numbers and residual gaps in §2b.3d6ca2e: synthetic CPU fault injection covers final-state validation, output/summary writing, manifest write failure and cancellation with reporting failure; the last OUTCAR status supersedes earlier trailers. PR headbf9d45ee11/11 checks passed. Residual: manifest writes are non-atomic, cross-file atomicity unavailable, external OUTCAR consumers must use the lastStatus:. Main tests post-merge were in progress at update.ec28ba3f(headf7b0afb0, synced to main4ddd54bbbefore merge). Adds CPU resume-equivalence tests (tests/mliport/mliport/confsearch/test_resume_equivalence.py,tests/mliport/mliport/neb/test_neb_resume_equivalence.py) and the corrected EN/ZH geometry-only resume wording (checkpointed band restored, optimiser state not replayed, convergence/saddle/barrier may differ). Review objection (same-saddle guarantee) resolved ind84b795f(EN) and585da68a(ZH). Acceptance AC1–AC3 passed — see §2a. PR head CI green:tests(3.10–3.13),lint,docs,package-build,wheel-install-smoke×4,analysis-backends,installer-real-nep(deployis main-only and skipped on PRs). Residual: synthetic CPU calculators only, no real-backend/GPU resume evidence.2d0cbea5df7a2c62fe32b749e0ec73f238b6ba43: fail-closed on out-of-range unit, missing RNG streams and malformed JSON/schema; fixed-atom mask restored on every exported minimum; registry members now serialize and restore their own numbers/positions/cell/PBC/classification, which removes the representative-geometry substitution (3/21 frames, up to 0.19 Å, with retained per-member energies). Checkpoint layout bumped to schema/revision 2; schema-1 checkpoints are refused as non-resumable instead of fabricating lost geometry; historical files untouched for forensics. The previously strict xfail was removed and selected output plusminima/all_minima.extxyzare compared against an uninterrupted synthetic-CPU reference. Historical caveat (unchanged): confsearch runs resumed from schema-1 checkpoints before this fix may carry wrong member geometry; do not relabel such artifacts as corrected — regenerate from the original quench raw files if available.Current CI baseline: latest
mainec28ba3f(merge of #82) is green acrosstests(3.10–3.13),lint,docs,package-build,wheel-install-smoke×4,analysis-backendsandinstaller-real-nep. Two pre-existing main failures were repaired separately in #92 (merge4ddd54bb): 14 stale DPAtorch==2.10.0plan assertions, anduv venv --allow-existingbeing applied unconditionally. No real-model GPU campaign was run by the auditor.Owner decisions: retain standard XDATCAR layout, preserve original ASE PBC mask in matching MD artifacts and refuse unsupported bulk-physics claims when source PBC is unverified. Never alter historical artifacts. Keep the two living tracker PRs #61 and #75 open. This ledger is a rolling summary; only mark per-file checkboxes after function-level audit evidence.
2a. AUD-007 acceptance record — 2026-11-14
Scope: verify the merged AUD-007 work (#82 tests/docs + #83 schema-2 repair) end to end on
main4ddd54bb, then merge #82 asec28ba3f. Environment: Python 3.12.13, pytest 9.1.1, CPU-only.venv-dev; synthetic calculators (EggCrateCalculator, curved-MEP_CurvedMEP); no real MLIP backend, no GPU.AC1 — confsearch resume equivalence (PASS). Interrupted after every durable unit boundary (1–3 units for 1 replica × 3 cycles; 1–4 units for 2 replicas × 2 cycles; 7 interruption points) and resumed, compared with an uninterrupted reference run of the same fixture:
search_results.json(all fields exceptmodel.model_path)minima/all_minima.extxyz— numbers, positions, cell, PBC,energy_eV,fmax_eV_A,move_maskminima/registry.json— including each member's ownpositions_A(the #83 surface)rng_states(md/mcbit_generator.state) at every unit index, pre-crash and at resumeNegative controls (mutations applied to the resumed state; each detected): re-seeded replica RNGs (13 differences), 1e-6 Å perturbation of a restored member (positions differ), simulated #83 regression where members borrow the representative geometry (positions + registry differ). The committed tests assert selected-result equality and RNG restoration; the coordinate/registry comparison above is audit evidence from the acceptance run, not a committed assertion.
AC2 — NEB resume correctness (PASS). Resumed attempt's first checkpoint is byte-identical to the band the interrupted attempt checkpointed (band
sha256verified, then re-validated for atom count/indices/masses/PBC/cell/symbols); the interrupted attempt'sstep_*checkpoints andvasp_path*exports all survive; the resumed run reachesstatus=completed,converged=True, the same climbing image and the same saddle. Barrier equality is deliberately not asserted: the optimiser state is not replayed (geometry_resume_only: truein both the checkpoint andrun_context.json), and the test only guards a loose 1e-3 eV bound (observed ≈2e-4 eV on this fixture).AC3 — regression (PASS). Full suite on the merged head: 2077 passed, 48 skipped, 0 failed (
pytest tests). For comparison the same suite on unmodified327c44adwas14 failed, 2039 passed; those failures were main-side defects (stale DPAtorch==2.10.0assertions; unconditional--allow-existing) and were repaired in #92, not attributed to #82.ruff check,ruff format --check,generate_docs.py --check,check_repository_hygiene.pyandtest_docs_contract.pyclean.DATA IMPACT: #82 is tests + documentation only; no checkpoint, trajectory or evidence file is touched, and no stored result is invalidated. #83's schema-2 change only affects newly written checkpoints; schema-1 checkpoints are refused rather than repaired.
Residual risk carried forward (not a pass): synthetic CPU calculators only — no real-backend (MACE/DPA/GRACE/UMA/NEP) checkpoint/resume run, no GPU, no interrupted multi-hour production run.
test_resume_converges_to_the_same_saddleverifies the resume contract on a synthetic curved MEP, not model accuracy.2b. NEP89 real V100/GPUMD acceptance — 2026-11-14 (tier 1)
Scope: first real-model, real-GPU acceptance of the NEP backend on current
main. Priority order per the owner request: single-point energy → atomic forces → short NVE → output provenance. No source change, no fix PR (no defect reproduced). Not a model-accuracy campaign: this verifies the mliport NEP adapter (format handling, forces, energy conservation, provenance) against one published universal potential.Identity (all hashes recorded)
ec28ba3f39fe9aa865e99aebf9c4c2452c72e256(v2.0.0b4), editable install in.venv-nepnep89_20250409.txt, 14,156,597 B, 976,331 parameters, SHA256518c70656302ea9d1e95ad8da66bd2e73b31bb03f4134e2f9fd7b3b589d82b85; headernep 89 …/format_version 1/model nep/zbl 1 2/cutoff 6 5 274 158/ 89 element types / energy references all zero/tmp/gpumd-src/src/gpumd, SHA256148259f2c24fe17c12be09fd0bba02528b98988cd86bd553fa896d6d94bedb97, built-arch=sm_70from source commitaa63ffdd60dc57c03b5641a9b29eb329514452c9(CUDA runtime libraries supplied by the PyTorch wheel set of another environment, driver 580.173.02 / CUDA 13.0)GPU-f24116e9-bea2-e0a6-70a9-d0b50811856b; GPUMD stdout confirmsDevice name: Tesla V100-SXM2-16GBSi16.vaspSHA256810560d8f9a5564cf87e9ca397154b5332bf254f616408a4ffbe6bf22c461370;Cu8.vasp1e7bc25b…f8be0; distorted Si160c948788…0f09c; mixed Si/Ob9209861…04c94; per-run effective inputnative/model.xyzSHA2567a4e971fb96a5afb917eab326f888bdf6197d7e2011cd4311578a847c05d957cmliport doctor --engine nep --device cuda:0passes (gpumd probe ✓). Warnings only for optional features missing from this environment (textual,kinisi,gemdat) — environment state, not a NEP finding.1. Single-point energy (native
NEP_RUNTIME=gpumd, V100, float32)Mechanical equilibrium is reproduced at the symmetry-preserving geometries (forces ~1e−6), while the distorted cell yields physical force magnitudes with a zero net force.
2. Atomic forces (verification)
−dE/dxagreement within 4.2e−4 eV/Å (max relative 0.16 %), consistent with the float32 energy floor (ε·|E|/2h ≈ 2.6e−4 eV/Åat E ≈ −86.55 eV). Sign, magnitude and units (eV/Å) are correct.3. Short NVE (native, 200 steps × 0.5 fs = 100 fs, 16 Si atoms,
velocity 300 seed 2026)KE + PEdrift over the run: +8.8e−5 eV = +5.5e−6 eV/atom (max−min 1.5e−4 eV = 9.1e−6 eV/atom; relative 1.0e−6) — consistent with float32 GPUMD inference.thermo.outinternals are self-consistent (T ↔ KE ratio 1.000 in all 20 dumped rows); mliport's normalizedtrajectory.extxyzreproduces the raw GPUMD potential energies in 20/20 frames.dump_xyzruns withoutvel), so VACF-type analyses remain unavailable; T/KE live innative/thermo.out.4. Output provenance (verified in
manifest.json/native/provenance.json)Recorded and cross-checked: model SHA256 (
nep.sha256), format version/model family/element list/cutoffs/ZBL/energy references, effective inputmodel.xyzSHA256, GPUMD path + SHA256 + version, GPU UUID + requested device,numeric_precision: float32with the explicit note thatprecision doubleonly widens text output,mliport_source_sha, and the fullrun.in(velocity 300 seed 2026,time_step 0.5,ensemble nve,run 200,dump_thermo 10,dump_xyz 10 … force virial mass unwrapped_position). Raw GPUMDstdout.log/stderr.log,thermo.outandtraj.xyzare retained next to the normalized outputs; run statuscompleted, process return code 0.Failure paths (classified, no fix PR)
NEP_RUNTIME=ase(CPUNEP on cpu, GPUNEP on cuda:0) with NEP89 v1Failed to parse line 6 from …nep89_20250409.txt, no manifest, no success artifactsdocs/backends/nep.md("Calorine support for this newer model layout has not been verified; use the native runtime for its first real test"). Fails closed; mliport's own header parser and identity reporting still work.Am)--gpumd-commandResidual gaps (explicitly not passed)
gpumdbinary is partially unknown: the CUDA toolkit version used for that build was not recorded (the binary is sm_70, version 5.9.1, source commit pinned above)./tmp/nep89-accept(not committed, per AGENTS.md rule 9); every number above is reproducible with the commands recorded in the issue conversation.3. Source-backed audit leads — dispositions updated as reproduced
astype(int)pathad44f578), with fractional, mixed large-int/float and exact CSV text regressions; rare nonstandard dtype limitations remain outside the tested contractc7880a2): warn on lossy export, persist PBC in MD metadata, restore if source identifies same artifact, deny bulk analysis eligibility without verified source PBC47fa28f) with status, event and error provenance regressions; cross-batch masking handled separately in #802d0cbea5) and pinned by #82 (ec28ba3f): interrupting at every durable unit boundary and resuming reproducessearch_results.json, every minimum's coordinates and the per-unitmd/mcbit-generator states; NEB restores the checkpointed band verbatim and keeps prior checkpoints/exports; corrupt schema-1 checkpoints are refused. Residual: synthetic CPU calculators only, no GPU/real-model resumeWhen a lead is disproven, mark "not a bug" with reproduction and add a guard test if useful; do not keep stale defect claims.
4. Universal scientific invariants (apply across ALL public entry points)
5. Exhaustive executable test matrix
5.1 Backend calculators, runtime and GPU
5.2 Single point, optimization, MD, NEB
5.3 Configuration search (#61; audit ONLY, no redesign)
5.4 Analysis, thermodynamics, transport
5.5 Four user interfaces, queue, cancellation, installation
5.6 File formats, scientific reporting, durability
6. Cross-product / adversarial input families (mandatory where applicable)
Test all applicable combinations rather than only happy paths: zero/one/many atoms; small/large systems; identical/mixed elements; atom order permutations; zero/negative/singular/inverted/strained/strongly skewed cell; 3D/2D/1D/0D PBC; fixed/unfixed atoms; nonperiodic molecule; float32/64; negative/zero/NaN/Inf stress/force/energy/time; tiny/huge velocity; too-close atoms; 0/1/2 frames; irregular saved steps; failed/interrupted calculation; backend out-of-memory; wrong/corrupt/stale checkpoints; read-only directory/full disk; canceled job; simultaneous scheduler. Avoid generating scientifically unrealistic "pass" fixtures: use them to prove clean rejection, not to establish model quality.
7. Required evidence, status table and acceptance protocol
For EACH case create a stable short ID; update this tracker with:
Definition of done for an individual bug: reproducible red test, minimal green fix, upstream independent known answer for physical claims, affected matrix tests green, no record corruption, and reviewed DATA IMPACT. A suite skip must have a recorded explicit reason and cannot count as success.
Campaign acceptance does not mean "all models are accurate". It means the audited scope is documented, every production module accounted for, no unresolved P0 without explicit owner decision, all feasible P1 tested/fixed, CI green, real-model campaign repeated for current source where required, and residual limitations transparently reported.
8. Execution order: small independent PRs (no code on this branch)
9. Exact initial CI and local commands (do not conflate environments)
Core, from repository root, on a clean development Python:
Run the isolated analysis-backend CI environment per .github/workflows/test.yml (including kinisi and GEMDAT); run actual backend smoke and validation/science tiers only in correct isolated backends on approved hardware. Capture the complete commands, logs, model hashes and exact software commit. Use pytest reporting of skipped/xfail to prevent "green" hiding unexecuted scientific tests. Do not introduce new CI dependencies blindly; verify across Python 3.10/3.11/3.12/3.13.
10. Code-by-code review ledger (every box starts UNTICKED)
Agent must inspect each listed production Python file individually, assign one or more test IDs, inspect error paths as well as normal paths, compare to public interface and existing tests, and only then tick it with a linked evidence comment. A directory or large file being named here does NOT mean it was completely reviewed. Review/compare existing tests under tests/ and validation/ as part of the evidence mapping. Update this ledger when files are added/renamed on main.
(root) (23)
analysis (15)
calculators (7)
config (8)
confsearch (18)
data (1)
install (10)
neb (8)
runners (9)
tui (7)
writers (7)
11. Required progress update format
On every meaningful update, replace the revision/date and add one entry:
Don't use a checkbox alone as proof. New scientific problems are never "resolved" because a mock tests green. When an upstream version or feature PR changes a surface, reopen affected cases, and leave this audit PR open indefinitely.
12. Findings ledger — agent audit + GPU validation (2026-11-05)
Baseline examined:
main@3d6ca2ea. Hardware: Tesla V100-SXM2-16GB, driver580.173.02, CUDA 13.0. CPU core suite: 1694 passed / 33 skipped / 1 xfailed.
Real-model validation on CPU+GPU: MACE-OMAT-0 medium (
d4b14be9…) andGRACE-2L-OMAT-medium-base + fp64 (
d497af4c…/53b945ef…), both hash-verifiedagainst
model_manifest.json; 276 evidence records aggregated with no harnessviolation (224 pass / 34 characterized / 14 fail / 4 unsupported).
Nothing below has been fixed unless the Status column says so. The venv path
issue is excluded by request.
12.1 Product-code findings — previous development round
TrajectoryDataset.loadcast the finiteraw/md.csvstepcolumn withastype(int), so0.5,1.5,2.5,3.5loaded as0,1,2,3;2**53+1was also rounded through float and a mixed[2**53+1, 2.0]sequence lost the integer identity.test_dataset_validation.py; PR #762adfc2ef)pbc=(T,T,F)/(F,F,F)round-tripped to(T,T,T)and flipped thethree_dimensional_pbc/eligible_for_rdfgates.test_xdatcar_convert.py; PR #77converged=False→ exit 2 (not_converged) instead of 1 (failed), contradictingdocs/workflows/optimization.md.test_optimization_failure_outcome.py; PR #78MDOutcarWriter.finalize()was first-call-wins, so the post-run guard's correctivefinalize(status="failed")was a guaranteed no-op and a run that raised kept an OUTCAR sayingcompleted. (b) The pre-existing terminal handlers calledfinalize()/_write_artifacts_manifest()unguarded, so a reportingOSErrormasked the real cause — a cancelled run with a full disk was classified FAILED (exit 1) instead of CANCELLED (130).test_md_manifest_write_failure_does_not_leave_a_completed_outcar,test_md_cancellation_survives_a_manifest_write_failurebf9d45ee)BatchRunner.run_from_filessetsuccess: Truewhenever_run_singlereturned, and_run_singledropped the optimizationstatus/converged.0d71f0a9)configurational_pressure_gpa/total_pressure_gpaconversion had no numeric known-answer test (only None-ness and inequality).unit_index=10**6made the unit loop skip everything and report a truncated search ascompleted(15 quenches/12 minima vs the reference's 21/15); an empty/partialrng_statessilently re-seeded the replicas and diverged; a missing stream raised a rawKeyError. (b) A truncated checkpoint file raised a bareJSONDecodeErrorand theschemawas never checked. (c)minima/all_minima.extxyzwas not reproducible across a resume — the fixed-atom mask survived only on minima registered after the resume (15 of 21 frames lost it).tests/mliport/mliport/confsearch/test_resume_integrity.py(6 red→green, 1 xfail)geometry_resume_only, so the resumed optimiser restarts: the barrier is0.9592721 eVuninterrupted vs0.9590986 eVresumed (~2e-4 eV). Structure itself is restored byte-identically.tests/mliport/mliport/neb/test_neb_resume_equivalence.py; PR #8212.2 Validation-harness findings — this GPU round
validation/science/scripts/neb_suite.py::model_identity_checkcompares mliport's directory artifact hash against the manifest's single-file hash, so every GRACEt5h_saddle_hessianrecord is a falsefail. mliport computesa8df2705…(=hash_model_path(dir), verified), the manifest pinsd497af4c…(=saved_model.pb). The harness's ownresolve_profilealready handles directory artifacts viasecondary_hashes, so the two disagree. The science in that record passed (ci_converged=true,min_eigenvalue = -2.04 eV/Ų,min_mode_overlap_vs_first = 0.99999998).validation-work/grace/t5/t5_saddle__t5h_saddle_hessian__grace.jsonrun_suite.pydoes not forward--subsettoomat_eval.py, sorun_suite.py --tiers t3 …dies withomat_eval.py: error: the following arguments are required: --subset. Calling the tier script directly works.val-mace-t3.log(first attempt)fail(robust imaginary modes) while the same fixture at 3×3×3 passes. This is a supercell-convergence artifact (see 12.3), but the status vocabulary has no way to say "converged at 3×3×3, not at 2×2×2" — the summary therefore reads as 12 failures.t4f_*_2x2x2_*vst4f_*_3x3x3_*records, MACE + GRACE12.3 Characterised, NOT defects
-12.35 meV(68 modes), Si diamond-4.14 meV(6 modes); identical at δ = 0.005/0.01/0.02 Å, and 0 imaginary modes at 3×3×3not_runfor every engine.t2_force_fdon MgOfail(2.6e-3 eV/Å)7.1e-12 eV/Å→characterized. Precision characterisation.energetics=unsupported(2 records)run_suite.pyexit code 1 after an otherwise complete runfailrecords; not a crash.12.4 Blocked coverage (explicitly
blocked, never silently skipped)those engines were not run. Downloading checkpoints was not authorised.
test_grace_neighbor_cache_gpu.py(opt-in GPU gate): needsmodels/grace/GRACE-2L-SMAX-OMAT-largeandlocal-data/LGPS222.vasp/LGPS222.vasp;neither exists → cannot run.
.venv-dev; the real-backend coverage above comes from the harness, which is theproject's designed path.
12.5 Environment / process observations
doctorreportsInstalled environment differs from saved inventory: packagesbecausetorch-dftdwas installed after the inventory wasrecorded. The inventory was deliberately not rewritten, since doing so would hide
the drift.
mliport/utils.pyis unreferenced dead code (all 8 public functions unused byproduction or tests); its
check_structure_validalso disagrees with the realcell check in
runners/base.py. Not removed (no unrelated refactors).(
160.2177vs160.21766208, ~8e-9 relative). Not a correctness issue; aconsolidation follow-up.
stepcolumn still falls back toinfo/arange(nframes) * strideinstead of failing closed.doneevent leavesartifacts.json = completedwhile the run raises (the manifest iscorrect about the MD; the callback is the caller's).
representative geometry of each unique minimum, so after a resume every member of
that minimum reports the representative's coordinates in
all_minima.extxyz— 3 of 21frames, up to 0.19 Å off (energies identical). Fixing it is a checkpoint-layout
change and therefore a
CS_CHECKPOINT_SCHEMA_REVISIONbump, which would makein-flight checkpoints non-resumable. Pinned as
xfail(strict=True)in PR fix(confsearch): fail closed on a damaged checkpoint and keep the minima mask (AUD-007) #83.12.6 Evidence locations
~/hdd500/dev/mliport-audit/validation-work/(outside therepository; 276 records +
summary.json).~/hdd500/dev/mliport-audit/logs/.~/hdd500/dev/mliport-audit/repro/.mainwas notmodified.
Revision log
3d6ca2eCI successful. AUD-007 opened Drafts test(neb,confsearch): AUD-007 — pin what checkpoint resume really preserves #82 (test-only NEB/confsearch resume contract; behind main, docs wording too categorical) and fix(confsearch): fail closed on a damaged checkpoint and keep the minima mask (AUD-007) #83 (confsearch fail-closed checkpoint repair; CI green with one strict xfail: per-member geometry lost on checkpoint restore, 3/21 extxyz frames displaced up to ~0.19 Å). Code review directly confirms registry serialization persists only the representative geometry, while restore copies that geometry to every member. This affects scientific provenance and older interrupted-resumed exports may require audit; do not mark AUD-007 fixed or count xfail as pass. Before merge, decide checkpoint-schema revision and a safe policy for legacy checkpoints; correct test(neb,confsearch): AUD-007 — pin what checkpoint resume really preserves #82 NEB documentation to avoid guaranteed same-saddle claims. No GPU claim. Tracker remains open and code-free.main@3d6ca2ea(V100, MACE-OMAT-0 + GRACE-2L-OMAT). Added section 12: the full findings ledger from this round and the previous development round, including two validation-harness defects (H-01 false GRACE saddlefailfrom a directory-vs-file hash mismatch, H-02--subsetnot forwarded) and one open owner decision (per-member geometry lost on resume). 276 evidence records aggregated with no harness violation; 14failrecords triaged as model/supercell/precision characterisation, not product defects. Nothing fixed in this revision; tracker stays open and code-free.3d6ca2efollowing independent Agent review that reproduced and fixed two additional terminal-output failure boundaries (corrective OUTCAR status trailer and preventing manifest-write failure from masking cancellation). PR head 11/11 green. Main lint/build green, main tests pending at update. AUD-006 marked merged with unresolved atomic manifest writes / multi-file crash window recorded. Begin AUD-007 restart/resume correctness using disposable CPU fixtures; no hardware checkpoint downloads. Keep [DEV P0 AUDIT · DO NOT MERGE/CLOSE] Living correctness and real-hardware test ledger · master #61 #75 open and code-free.c7880a24/4 CI success. Started AUD-006 with fix(md): terminal failure provenance for post-integration exceptions (AUD-006) #81, a narrowly scoped CPU-only red-then-fix PR for post-integrator finalization errors: lost or prematurely completed status on final state evaluation/output/summary failure, terminal failed/cancelled manifest with retained raw frames. Current-head CI pending; do not count as verified or merged. AUD-007 next. Permanent tracker remains open and code-free.0d71f0awith fully green main CI; fix(xdatcar): preserve PBC provenance and block unverified bulk analysis (AUD-002) #77 merged asc7880a2after fixed regressions and green PR CI. Post-fix(xdatcar): preserve PBC provenance and block unverified bulk analysis (AUD-002) #77 main lint/docs/build green; main tests in progress at writing. Updated original AUD-001/002/003 dispositions, noted historical-data implications and next AUD-006/007 CPU fault/resume campaign. No real GPU/physical validation claimed; living PR stays open with no code changes.47fa28f; fix(analysis): refuse non-integral md.csv step values instead of truncating (AUD-001) #76 (step integrity), fix(opt): report a crashed optimization as failed, not non-converged (AUD-003) #78 (optimizer outcome) and test(md): known-answer tests for the stress -> pressure conversion (S-02) #79 (stress→pressure known-answer tests) merged with green main CI. Implemented fix(xdatcar): preserve PBC provenance and block unverified bulk analysis (AUD-002) #77 PBC provenance and fix(batch): preserve failed and non-converged optimization outcomes #80 Batch status fixes on separate Draft PRs; their tests/CI remain pending independent acceptance at this revision. Evidence, historical scientific-data caveats, and unresolved true-backend validation remain explicit. Updated the confirmed-defect status without ticking untouched file boxes.Rev 8 — 2026-11-06/07 · local full test campaign, H-01/H-02 repaired, NEP regression coverage
R8.1 Environment and baseline (per section 4.1 of the #61 acceptance matrix)
Core suite, same command in both trees:
3d6ca2eaNew skips explained: exactly one,
test_nep_real_cpu.py, which skips in.venv-devbecausecalorineis deliberately not installed there. It wasexecuted in
.venv-nep: 1 passed. No xfail was added anywhere.ruff check+ruff format --check(mliport, tests, scripts, validation):clean.
scripts/check_repository_hygiene.py: pass.scripts/generate_docs.py --check: up to date.mkdocs build(en + zh): OK.uv build mliport: wheel + sdist both containcalculators/nep_calc.pyandgpumd/*.R8.2 H-01 — GRACE directory-artifact identity: reproduced and fixed (#87)
Confirmed with the unmodified historical record
validation-work/grace/t5/t5_saddle__t5h_saddle_hessian__grace.json:The physics criteria all passed; only the hash scheme differed. Fix: the
harness hashes the local artifact with mliport's own algorithm
(
common.artifact_sha256, proven equal tomliport.model_record.hash_model_pathfor a file and a directory by a newtest), compares like-for-like, and records
manifest_model_sha256separately.resolve_profile's file-by-filesecondary_hashesverification is unchanged,and a genuinely different artifact still fails. No threshold relaxed.
R8.3 H-02 —
--tiers t3could never run: reproduced and fixed (#87)run_suite.pylaunchedomat_eval.pywithout its required--subset.--subsetis now forwarded and the tier refuses to start without it with anactionable message. Two red→green tests cover forwarding and refusal.
R8.4 Two additional defects found this round (fixed in #88)
CUDA_VISIBLE_DEVICES; the leased GPU UUID was recorded in provenance but not enforced, so a queued job could execute on a different GPU than its leasegpumd/runner.py::_execute_processpassed onlyself.envactual_device_uuid==nvidia-smirun.inprovenance recordedthermostat: nullwhilethermostat_mapping.thermostatwasLANGEVINout-native-nvt/manifest.jsonthermostatnow set from the mapping;test_gpumd_input.pycovers itR8.5 Per-file ledger progress
The 113-file ledger above is not bulk-ticked. This revision adds function-level
evidence for:
mliport/calculators/factory.py,backend_selection.py,config/{schema,defaults,resolver,incar}.py,engine.py,api.py,cli.py,model_record.py,doctor.py,queue.py,tui/{config_screen,run_screen}.py,install/{cli,plan,compatibility}.py— each asserted by
test_nep_config.py(49 tests) to expose the same backendset and the same runtime contract, so a future backend cannot be added to one
entry point only.
mliport/runners/{base,md,optimization,singlepoint}.py— unchanged; NEP-ASEreuses them (real CPU sp/opt/nvt/nve/neb runs recorded in [DEV MASTER · DO NOT MERGE/CLOSE] MLIP validation roadmap (#75) + confsearch living spec #61).
validation/science/scripts/{common,engines,neb_suite,run_suite}.py— H-01/H-02.Still not function-by-function signed off: the analysis package, confsearch,
writers, install/inventory, jobs/queue_daemon, tui screens beyond the config
form. No claim is made for them.
R8.6 Real-backend re-verification on the modified tree
mace_omatt1+t2grace_omatt1+t2No old evidence file was overwritten; the new records live in disposable
directories outside the repository.
R8.7 Still open — unchanged owner decisions
representative on checkpoint restore; 3/21 frames differ by up to ~0.19 Å in
the synthetic fixture,
xfail(strict=True)still present. Needs a schemarevision + legacy-checkpoint policy. Not fixed, not claimed fixed.
batch/confsearchthrough the ASE runtime: implemented, not run.unverified and documented as such.
R8.8 DATA IMPACT
None. No stored result was modified. Historical GRACE saddle records written as
failby H-01 are misclassified, not wrong physics; they must be re-runwith the corrected harness before being cited. No scientific record
invalidated, none rewritten.
Revision log entry
0 failed, +1 explained skip), H-01 and H-02 reproduced and fixed under fix(validation): compare model artifacts like-for-like (H-01) and forward t3 --subset (H-02) #87,
two further defects found and fixed under feat(nep): dual-runtime NEP backend (Calorine ASE + native GPUMD) #88 (GPU lease not enforced on the
native child; NVT thermostat provenance null), MACE/GRACE real t1+t2
re-verified bit-identically with no regression, DPA/UMA remain blocked,
AUD-007 still an open owner decision (test(neb,confsearch): AUD-007 — pin what checkpoint resume really preserves #82/fix(confsearch): fail closed on a damaged checkpoint and keep the minima mask (AUD-007) #83 Draft). Nothing merged; tracker
stays open and code-free.