ga
Stable library roots
Public package surface carries the v1 stable-root compatibility promise.
模块: contract, core, router, middleware, security, store, health, log, metrics
发布策略
Plumego v1 覆盖当前仓库中的已检入模块，但不同区域承载的兼容性承诺并不相同。这一页的作用，就是避免读者把“已经检入仓库”“出现在事实卡片里”或“被参考应用提到”误读成一刀切的稳定性承诺。
同步支持矩阵
Section titled “同步支持矩阵”从 `README.md` 的 v1 支持矩阵同步
6 同步条目
supported reference
Canonical reference app
Kept aligned with the canonical bootstrap and stable-root usage, but not treated as a reusable extension catalog.
模块: reference/standard-service
supported tool
CLI
Supported as a command-line tool, not as a Go import surface; command behavior and generated output must stay aligned with canonical docs.
模块: cmd/plumego
beta
Beta extension families
API surface frozen between minor release refs; promoted after two consecutive tagged refs with no exported API changes and owner sign-off.
模块: x/gateway, x/observability, x/rest, x/websocket, x/tenant, x/frontend, x/messaging
experimental
App-facing extension families
Included in repo quality gates and release scope, but API/config compatibility is not frozen.
模块: x/fileapi, x/openapi, x/resilience, x/rpc, x/data, x/ai, x/validate
experimental
Subordinate extension primitives
Maintained and tested, but discovery should start from the owning family entrypoint and compatibility is not frozen.
模块: x/ai/distributed, x/ai/filter, x/ai/instrumentation, x/ai/llmcache, x/ai/marketplace, x/ai/metrics, x/ai/multimodal, x/ai/orchestration, x/ai/prompt, x/ai/provider, x/ai/resilience, x/ai/semanticcache, x/ai/semanticcache/cachemanager, x/ai/semanticcache/embedding, x/ai/semanticcache/vectorstore, x/ai/session, x/ai/sse, x/ai/streaming, x/ai/tokenizer, x/ai/tool, x/data/cache, x/data/file, x/data/idempotency, x/data/kvengine, x/data/migrate, x/data/pgx, x/data/rw, x/data/sharding, x/data/sqlx, x/gateway/cache, x/gateway/discovery, x/gateway/ipc, x/gateway/protocol, x/gateway/protocolmw, x/gateway/transform, x/messaging/mq, x/messaging/pubsub, x/messaging/scheduler, x/messaging/webhook, x/observability/dbinsights, x/observability/devtools, x/observability/featuremetrics, x/observability/ops, x/observability/recordbuffer, x/observability/testlog, x/observability/testmetrics, x/observability/tracer, x/observability/windowmetrics, x/rpc/client, x/rpc/gateway, x/rpc/server
1 稳定根 长期公开表面
2 参考应用 可复制的受支持示例
3 CLI/脚手架 按当前 API 验证生成代码
4 主 x/* 家族 用应用本地适配器隔离
5 下级 x/* 采用前检查 module.yaml
1
默认路径
长期公开表面
2
服务形态
可复制的受支持示例
3
工作流表面
按当前 API 验证生成代码
4
可选能力
用应用本地适配器隔离
5
窄范围细节
采用前检查 module.yaml
| 表面 | 采用姿态 | 兼容性读法 |
|---|---|---|
| 稳定根 | 默认路径 | 可作为长期公开表面读取，但仍受各自 module.yaml 约束 |
reference/standard-service | 受支持参考 | 可以复制服务形态，不要当作仓库归属规则 |
| CLI 和脚手架 | 受支持工作流表面 | 适合生成和示例；生成代码仍要按当前 API 验证 |
面向应用的 x/* 家族 | 可选扩展 | 能力匹配时使用；生产路径建议用应用本地适配器隔离 |
下级 x/* 原语 | 窄范围扩展细节 | 先从主家族进入；采用前检查本地包契约 |
发布姿态判断表
Section titled “发布姿态判断表”| 问题 | 更强信号 | 较弱信号 |
|---|---|---|
| 是否属于默认路径？ | 被 reference/standard-service 使用 | 只是存在于仓库中 |
| API 是否可能保持收敛？ | 稳定根加 module.yaml 范围约束 | 实验性状态的宽能力家族 |
| 示例能否直接复制？ | 示例使用当前公开符号和稳定根 | 示例跨越实验性扩展边界 |
| 生产代码是否应该直接依赖？ | 稳定根稳定性承诺 | 没有应用本地适配器的实验性 x/* API |
这些信号出现时放慢
Section titled “这些信号出现时放慢”| 信号 | 更安全的默认假设 |
|---|---|
包位于 x/* 下 | 把它当作扩展表面并检查成熟度 |
没有出现在 reference/standard-service | 它不是最小规范路径的一部分 |
| 工作是能力型、拓扑较重、租户相关或协议相关 | 从所属扩展家族开始 |
| guide 或 scaffold 提到了它 | 这个提及解释用法，不会提高兼容性姿态 |
为什么要单独写这一页
Section titled “为什么要单独写这一页”Plumego 把发布姿态写清楚，是为了避免文档、脚手架和扩展工作无意中夸大兼容性承诺。它的目的不是让仓库显得摇摆不定，而是把稳定路径收得足够窄，让读者知道哪些东西可以更放心地继承。