feat: 能力插件元数据与运行时消费闭环

This commit is contained in:
que01 committed 2026-10-12 11:20:43 +08:00
1 parent 076c6124c8
commit bb0709b8cc
26 files changed
+2188 -267

No files matched your search

@@ -0,0 +1,29 @@
# 0024 Capability 产品元数据契约
## Context
Capability 之前只有技术 key 和状态,Admin 难以判断能力是否可选、停用影响和入口配置。插件配置也存在硬编码 `{}` 的问题,且客户端曾要求提交 `capabilityVersion`,容易让服务端版本被错误覆盖。
## Decision
- `capabilityRegistry` 是产品元数据、禁用策略、允许页面、依赖模块、用途绑定和入口导航的唯一来源。`offerings` 是不可移除的核心能力;`inquiry` 核心能力允许停用;`quote-request` 是可选能力。
- 咨询和报价能力只声明 `entryLabel`、`submitHint`、`disabledHint` 三个文本配置字段。服务端按注册表白名单校验,不接受未声明字段。
- Admin 读写契约返回元数据与配置字段声明;更新接口只接受状态和配置,`capabilityVersion` 由服务端按当前注册表派生。
- Runtime Workspace 的 capabilities 与 plugins 输出品牌级配置。已发布快照读取发布时能力记录,草稿变更只进入 Admin 预览,直到重新发布。
## Alternatives
- 在每个行业模板中重复能力元数据:会造成同一能力多份定义。
- 允许客户端提交版本:可能导致品牌记录与平台契约漂移。
- 继续把配置写入硬编码 `{}`:无法支撑可运营入口和提示文案。
## Consequences
- 新增能力时必须同步注册表元数据、配置字段和集成回归。
- 未声明元数据的能力在 Runtime 中只保留技术状态,不会伪装成可配置产品能力。
- 停用 `inquiry` 会阻止对应表单提交;移除 `quote-request` 后报价表单不再可用。
## Migration Plan
1. 旧品牌记录继续保留原 `capabilityVersion`,下一次 Admin 更新由服务端派生为注册表版本。
2. 已存在的能力配置继续进入发布快照;未声明字段需要在下一次保存时按新校验清理。