当前 wiki 验收清单

源码范围：LMDZ.COMMON-6.3\LMDZ.COMMON，仅覆盖 Mars run 会经过或必须保持接口兼容的 COMMON 路径。

验收原则

当前 wiki 的目标是让读者能沿 Mars 运行链复现和定位问题：

编译命令 -> arch/env/path -> FCM source groups -> 可执行文件名
        -> run.def/start 文件 -> gcm/newstart/testphys1d
        -> 动力初始化/时间推进 -> 物理接口
        -> restart/history/getin/I/O -> Mars 工具链

因此页面数量只作为覆盖密度参考。真正的验收依据是：主流程是否串起来、关键模块是否能定位、Mars 不经过的路径是否被排除、剩余待确认项是否被归入运行、外部库、设计意图或物理/数值问题。

当前结论

结论：当前 wiki 已满足主要阅读和定位需求。

原因：

主流程、构建配置、Mars/COMMON 映射、start/restart/archive 边界、串并行动力骨架、物理接口骨架和小工具组页已经可用。
构建配置闭环已完成：源码路径、IOIPSL、arch/env、deftank 运行环境、target 输出命名都能互相追踪。
history/XIOS/getin 输出与配置读取职责边界已经补齐，能区分动力 history、Mars physics diagfi/stats、XIOS helper 和 getin/getin_p。
主题页和索引页已能串起主要路径；范围外条目属于非 Mars 路径或当前源码已删除内容，剩余 待确认 属于运行验证、配置样例、外部库、设计意图或物理/数值解释。

功能面验收

功能面	当前状态	已有覆盖	剩余影响
Mars 范围边界	`已覆盖`	mars-common-map, common-mars-usage-map, source-coverage-matrix	Venus/Titan/evolution 已列为范围外，不应再作为当前 wiki 缺口。
主流程入口	`已覆盖`	common-gcm-mars-run-entry, dynamics-time-integration, dyn3d/gcm, dyn3dpar/gcm	主链已能追踪；剩余是具体生产入口和运行脚本验证。
构建配置	`已覆盖`	build-and-arch, makelmdz-fcm-mars-paths, ioipsl-build-mars-contract, arch-env-mars-run, makelmdz-target-output-naming	剩余是平台实测验证，不是 wiki 结构缺口。
动力核心	`已覆盖`	dynamics-time-integration, transport-advection, `dyn3d`/`dyn3d_common` 索引、infotrac、vlsplt、vlsplt_p、ppm3d、advn、COMMON `gcm/conf_gcm` 与 MARS `phymars/nogcm` 边界、caldyn/advtrac/integrd/dissip/friction/addfi/qminimum/top_bound 等组页	主时间推进、tracer contract、串并行 Van Leer、PPM、advn 和 Prather/历史格式边界已完成；剩余影响是配置样例和数值/设计意图确认。
并行版本	`已覆盖`	serial-parallel-dynamics, dyn3dpar/index, dyn3dpar/gcm, guide_p_mod, parallel_lmdz, mod_hallo, bands, times, vlsplt_p, parallel advection/diagnostic pages	剩余影响是 `Bands_*prc.dat`、MPI/OMP 线程数等运行样例验证，不是 wiki 缺页。
物理接口	`已覆盖`	dynphys-interface, dynphy_lonlat/index, calfis, calfis_p, mod_interface_dyn_phys, inigeomphy_mod, phy_common/index, mod_phys_lmdz_mpi_transfert, mod_phys_lmdz_transfert_para, mod_phys_lmdz_omp_transfert	剩余影响是 Mars physics 实际使用、外部 physics 包或本地 patch 的运行侧确认。
start/restart/archive	`已覆盖`	restart-io, mars-start-restart-archive-boundary, dynredem-restart, mars-utility-common-state-consumers	已与 history/getin/XIOS 边界衔接。
history/XIOS/getin/I/O	`已覆盖`	restart-io, history-xios-getin-boundary, history-output-serial-parallel, inithist-serial-parallel, write-field-xios, ioipsl-getin-system, netcdf95-wrappers	Mars physics 具体字段清单仍属 MARS physics wiki 深度内容。
小工具/数值辅助函数	`已覆盖`	misc、filtrez、插值、样条、数值 helper、坐标 helper、FFT/filter helper 已按组页覆盖	个别 helper 深度页可后置，不阻断当前 wiki 使用。
索引和查找	`已覆盖`	file-index, symbol-index, source-coverage-matrix, pending-confirmation-triage, mars-common-map, common-mars-usage-map	后续新增运行证据或维护者确认后，需要同步更新符号索引和待确认分类页。

最小完成条件

当前 wiki 已经满足以下最小条件：

已完成 history/XIOS/getin 输出和配置读取职责边界页。
入口页、file-index、coverage matrix 能从每个功能面跳到已覆盖。
非 Mars 路径仍列为范围外，不因页面数量目标重新打开。
主题页已汇总主要功能面；剩余 待确认 已集中到 pending-confirmation-triage。

可后置项目

这些项目可以提高完整度，但不应阻止当前 wiki 使用：

单个短小 helper 的逐文件页，已有组页覆盖时可后置。
非 Mars 路径：Venus/Titan newstart/archive/restart、evolution/PEM。
需要真实运行样例、外部库行为或维护者设计意图的 待确认 项。
平台专有 scheduler 指令细节，源码无法完全证明，需要真实集群文档或运行环境确认。

主题页维护建议

若要继续推进主题页，优先级不按文件大小，而按是否补齐功能面：

优先级	页面/主题	理由
H1	themes/restart-io.md	已完成；整合 restart/history/I/O 细节页。
H2	themes/dynamics-time-integration.md	已完成；把 `gcm/conf_gcm/leapfrog` 细节页整合成主时间推进读法。
H3	themes/serial-parallel-dynamics.md	已完成；把串并行页面合并成一条对照阅读路径。
H4	reference/symbol-index.md	已完成；改善入口、模块、例程、配置键和 I/O 文件反查效率。
H5	themes/transport-advection.md	已完成；整合 tracer 初始化、`advtrac` 调度、Van Leer、PPM、advn、Prather 和串并行可达性边界。

疑点检查

当前剩余待确认项见 pending-confirmation-triage。本页不再把已完成的主题页或覆盖记录当作待确认来源；剩余问题按运行验证、Mars 配置、外部库/API、设计意图和物理/数值解释分类。

复验流程

每次声称“当前 wiki 可用”前，按以下顺序检查：

从 index 的阅读路径进入，确认主流程、构建、I/O、映射表都能到达。
从 source-coverage-matrix 查看是否还存在未覆盖的功能面。
从 pending-confirmation-triage 查看剩余待确认项是否仍属于运行/外部/设计意图类。
从 file-index 随机反查 makelmdz_fcm、gcm.F90、calfis.F、dynredem*、getin、write_field 等关键范围。
抽查覆盖状态：不能出现已覆盖但无页面支撑的范围；不能把非 Mars 范围重新算作缺口。