参考

页面	内容
命令行	analyze / export / plan / missing 的参数、输出与退出码
契约 1.0.0	报告、信封、元数据与地图数据集的正式字段定义
错误码与诊断	输入级错误、分析诊断、元数据错误、桌面命令错误
术语表	观测、评估、证据等级、定位精度等术语

稳定的东西

• 字段名、枚举值、单位与错误码都是契约的一部分，变更必须升级版本；
• 界面只依赖代码与枚举，不解析自然语言消息；
• 报告中的未知用 null + 原因表达，合法零保留 0。

契约的 JSON Schema 在仓库 schemas/，夹具在 fixtures/contract/；两者与 Rust 类型、 前端生成类型一起构成契约的四份载体。