01
两个 release ref
在连续两个 release ref 之间，不得有任何 exported symbol 变化。
本页：成熟度分层与晋升规则。 完整支持矩阵与 Router 基准测试 →
9 稳定根
7 beta 扩展
7 实验性扩展
v1.1.0 当前版本
四个层级，每个层级都有明确的采用信号。
每行横向阅读：该层级的承诺是什么、应该怎么对待，以及哪些模块属于它。
层级 API 承诺 采用信号 模块
稳定 稳定根
v1 稳定根兼容性承诺，可用于生产。 立即采用——这是所有服务推荐的起点。 coreroutercontractmiddlewaresecuritystorehealthlogmetrics 受支持 受支持参考
与 canonical path 保持同步，作为指南阅读。 以 reference/standard-service 作为起步模板。 reference/standard-servicecmd/plumego beta Beta 扩展
minor 发布 ref 间 API 冻结。 可以采用，但升级前需要查看 release notes。 x/restx/gatewayx/websocketx/observabilityx/tenantx/frontendx/messaging 实验性 实验性扩展
API 可能变化，采用前请评估。 在阅读模块手册和成熟度证据后，有明确理由时再采用。 x/aix/datax/fileapix/openapix/resiliencex/rpcx/validatex/data/cachex/gateway/discoveryx/gateway/ipcx/messaging/mqx/messaging/pubsubx/messaging/schedulerx/messaging/webhookx/observability/devtoolsx/observability/ops 9 个稳定根详情。
这是唯一拥有长期 API 兼容性承诺的模块，也是所有生产服务推荐的起点。
包名 说明 状态
Beta 扩展——ref 间 API 冻结。
七个家族已完成晋级清单：连续两个 tagged release ref 内 API 无变化、有 release-backed 快照、以及负责人签字确认。 可以采用，但升级前需要查看 release notes。
beta
x/rest
CRUD 资源控制器与 REST 规范
owner: platform-apibeta
x/gateway
代理、重写、负载均衡与边缘传输
owner: edgebeta
x/websocket
WebSocket hub 与显式路由注册
owner: realtimebeta
x/observability
Exporter、tracer、collector 与 adapter 接线
owner: observabilitybeta
x/tenant
租户路由、配额执行与 JWT 策略
owner: tenantbeta
x/frontend
静态资产服务、SPA 嵌入与预压缩投递
owner: assetsbeta
x/messaging
异步消息、队列、pubsub 流与入站 Webhook 投递
owner: messaging模块如何晋级
模块不能靠声明变稳定。Beta 晋级要求：连续两个 release ref 内没有 API 变化、有 release-backed 快照，以及负责人书面签字。
02
Release-backed 快照
在两个 ref 分别记录 API 快照，由 CI 自动比对。
03
负责人签字
模块负责人在状态字段变更前书面确认兼容性义务。
machine-readable ledger
证据追踪在 specs 里，而不是散文里
specs/extension-beta-evidence.yaml 记录了每个候选模块的 release ref、快照路径、负责人签字状态和开放阻塞项。