文档状态严格区分以下层级:
| 状态 | 含义 |
|---|---|
| 已源码核验、未联调 | 当前前端调用、服务端入口和必要责任端证据已闭合;未宣称真实环境验证 |
| 已联调验证 | 另有受控真实交互记录;不由构建或静态检查推导 |
| 存在关键缺口 | 缺少会影响调用决定的证据,不能作为完整接口契约发布 |
每张操作页在页首以一行验证状态注明适用基线(日期基线)与已知缺口;未执行的联调/测试不在场景页展开。字段级契约事实的证据链在清单层:每页 provenance 头记录数据源与拉取日期,verify-api-inventory 在提交前比对场景页端点行与清单层,漂移时拉生产 api-docs 重生成(生成类提交、不手改生成物)。静态检查和站点构建只验证文档结构,不验证接口行为。
本公共约定依据 2026-09-11 的机构场景调研基线整理;具体操作须在编写时重新核对相关源码是否漂移。
状态与证据口径来自本手册编写前的调研规划(事实与证据、示例与读者可见状态、复核与发布等章节,依据 Web 端与中心服务实现归纳 2026-09)。规划资产不替代操作页的当前源码复核。