同一小程序能力在不同宿主和运行框架中应如何建立兼容契约

# 核心结论

同一小程序能力要在不同宿主和运行框架中稳定工作，核心不是追求源码和表现完全一致，而是先定义平台无关的业务契约，再通过适配层实现各端差异。契约应明确输入、成功结果、失败类型、取消语义、超时规则和降级行为；构建期能够确定的差异可通过配置或条件编译处理，只有运行时才能确定的能力则通过能力检测处理。平台确实不具备的能力，应明确隐藏、降级或终止流程，不能伪造成功结果。

# 底层机制

半编译半运行框架通常在构建阶段转换模板、样式、组件和部分接口，同时保留一层运行时，用于协调生命周期、事件和组件模型。它可以复用大量代码，但转换器不能自动消除宿主之间的真实差异。偏运行时的方案依赖统一抽象层，动态性较好，却可能增加包体、启