跳转到内容

稳定根

稳定根是仓库根部那些长期公开的包。它们定义了 Plumego 的默认学习路径,也承接 v1 兼容性承诺中最核心的部分。

从 `specs/repo.yaml` 与 `specs/task-routing.yaml` 同步

稳定根清单

9 稳定根

  • contract
  • core
  • router
  • middleware
  • security
  • store
  • health
  • log
  • metrics

从 `specs/repo.yaml` 与 `specs/task-routing.yaml` 同步

默认归类意图

Change kernel, lifecycle, route structure, transport contracts, transport middleware, auth primitives, or storage primitives.

不鼓励的新根目录

  • ai
  • tenant
  • net
  • pubsub
  • rest
  • validator
  • utils
  • frontend

这些事实块来自仓库 machine-readable specs,而不是 docs 中手工复制的列表。

  • 应用内核与生命周期
  • 路由结构与匹配原语
  • transport contract 与响应辅助
  • transport-only 中间件
  • 安全原语与基础存储抽象
  • 产品特定功能逻辑
  • tenant-aware 策略分支
  • 协议家族目录
  • 前端、AI、数据拓扑或网关等可选能力

如果某个改动会迫使稳定根学习扩展层语义,就应该把行为移动到对应的 x/* 家族。