Skip to content

兼容性姿态

Nimi 公开文档的兼容与迁移姿态参考。

姿态总结

性质
姿态名no_legacy_hard_cut
Pre-launch
软兼容 shim
时间分层禁(分层是本体性的:core / extended / custom)
Strict-only 协议版本
合同违反 fail-close
重试救援合同失败

给读者的实操含义

情况预期行为
某页被移除优先于过时页
类型化合同失败露类型化错误、静默回退
重试发生只为 transport / auth 刷新、永不救援合同
旧路由存在要么作为 admitted 公开真相保留、要么硬移除;作为隐藏兼容保留
新功能上线带完整合同设计交付、作为以后补全的 MVP 子集

禁用兼容形状

方法学的 forbidden_shortcuts 目录列公开文档与实现拒的模式:

Key拒绝模式
legacy_alias用软别名让旧语义存活
compat_shim把 owner-cut gap 藏在临时兼容代码后
dual_read没显式准入的两条并行真相读路径
dual_write没显式准入的两条并行真相写路径
mvp_subset_contract把规范化合同真相切成临时最小子集
time_phased_layering用时间切片(v1/v2/v3)替代语义分层
placeholder_success缺必需真相时伪造成功或闭合
happy_path_only_closure只闭 happy path 就声称闭合
app_local_shadow_truthApp 局部便利状态变成隐藏规范化真相
silent_owner_cut_reopen在下游执行 wave 内重开 owner 域真相

Pre-Launch 公开声明约束

公开文档当前不发布以下类别:

声明类姿态
安装命令(curl / npm / pnpm / brew / apt / yarn)在 admitted 分发证据前扣下
下载链在 admitted 分发证据前扣下
发布状态 / 发布承诺在 admitted 发布证据前扣下
具体 Provider 名 / Model 名在 admitted 目录证据前扣下
Provider 可用性矩阵在 admitted 目录证据前扣下
Defined-but-not-shipped 面的「现在可用」/「GA」/「稳定」声明

完整禁用公开文档声明列表带检测模式见 禁用主张

合同演化路径

defined-but-not-shipped 面怎么毕业到公开面:

  1. 在合适的权威域下准入 kernel 合同(P-PROTO-* / K-* / S-* / D-* / R-*)。
  2. 实现在 owner 域下落地。
  3. 准入目录证据(给 Provider / Model)。
  4. 准入分发 / 发布证据(给安装 / 下载)。
  5. 公开文档页更新反映可用性。

文档页无法预宣告合同演化没到的阶段。

来源

Nimi AI open world platform documentation.