Pending confirmation triage
页面定位
本页收束 Mars Wiki 中的 待确认 与源码疑点。它不是“未完成页面”清单,而是把已经写入各页的不确定性分级:哪些需要运行验证,哪些需要外部数据或文献,哪些只是源码边界尚未集中复核。
处理原则:
- 能由源码直接确认的内容,不再保留为旧缺页或旧登记占位。
- 不能由源码单独确认的内容,保留
待确认,并说明需要哪类证据。
- 不把推断写成事实;需要运行、构建日志、外部数据版本或维护者判断的内容继续显式标注。
优先级分类
| 等级 |
含义 |
处理方式 |
| P0 |
可能影响数值结果、守恒性、数组索引或 restart 复现 |
优先用最小运行案例或维护者确认。 |
| P1 |
影响物理解释、外部数据版本或诊断可比性 |
需要文献、数据文件版本或实验配置佐证。 |
| P2 |
影响构建、并行行为或工具链复现 |
用 build log、脚本和实际工具运行核验。 |
| P3 |
遗留变量、注释、命名或未使用导入 |
保留在页面内,批量清理时再处理。 |
P0 源码疑点
| 页面 |
疑点 |
需要的证据 |
| co2cloud_mod |
SatIndex 或相邻饱和索引逻辑中疑似使用了容易混淆的数组下标。 |
小列例子复现 CO2 云激活层选择,并与预期饱和剖面对比。 |
| conduction |
热传导系数或层索引边界在高层热层路径中有待确认项。 |
单列热层测试或与原论文/历史版本对比。 |
| vdifc-water-surface-exchange |
水汽地表交换段的 .or. 守卫疑似恒真,可能影响 h2o_ice 注入路径理解。 |
最小水循环配置运行,记录该分支的进入条件与 tendency 输出。 |
| topmons_mod |
qbar_number_pbl 等 PBL 平均量的单位和数浓度解释仍需确认。 |
追踪调用方输入单位,或用诊断输出核对量纲。 |
| writerestart1D_mod |
文本 restart 中 q 实参维度和读取端格式的完全对应关系待确认。 |
testphys1d 写出再读入闭环测试。 |
P1 物理参数和外部数据
| 页面 |
疑点 |
需要的证据 |
| reaction-rates |
热层化学反应速率常数的外部版本来源尚未完全归档。 |
对照 chemthermos_reactionrates.def 的历史来源、JPL/UMIST 或项目文档。 |
| radiation 与辐射相关文件页 |
气溶胶、辐射表或典型光学参数的推荐范围不能仅由源码判断。 |
数据表版本、运行配置和基准实验说明。 |
| dust-cycle / dust-free-evolution-tests |
dustscaling_mode=0 的 10 天 free-dust 试验已给出 dust devil 候选,但长积分稳定性、质量收支闭合和 two-moment 风应力阈值 lifting 仍未确认。 |
长积分输出、尘埃收支诊断,以及针对 doubleq 分支的源码改造设计或维护者确认。 |
| aeropt_mod / aeroptical |
ASCII 光学性质表的具体文件版本、半径范围和波长范围需要与 datadir 实物对应。 |
实际 datadir 文件清单和表头检查。 |
| soilwater 与 soil |
土壤吸附、地下冰和热惯量常数的物理来源需要外部资料补强。 |
对照配置、论文或维护者说明。 |
| simu_MCS |
MCS 分箱文件版本、Ls-sol 换算和观测高度坐标约定需与实际观测产品一致。 |
观测文件元数据和一组已知对比案例。 |
P2 构建和边界契约
P3 遗留注释和局部代码清理
这些条目通常不阻塞 Wiki 交付,但应保留在源文件页中,避免误删历史语义:
已做掉的占位类问题
本轮收尾已把以下“缺页面”类占位转为实际导航或边界说明:
后续处理规则
- 新增
待确认 时必须说明它需要源码、运行、外部数据、构建日志还是维护者判断。
- 仅凭“看起来合理”不得移除
待确认。
- 若运行验证通过,应在对应页面补一句验证证据,并在本页把条目移到“已确认”或删除。
- 若发现真实源码问题,应新建维护任务或 issue,不在 Wiki 中直接修改源码。