商业化能力，以插件接入
saas是一个独立仓库、独立发布的通用商业化组件：套餐、订阅、权益、配额、用量计量与账单。在 uuos 中它以产品插件 ai.uuos.saas的形态注册——商业化逻辑与执行引擎彻底解耦，但配额检查恰好卡在每次运行之前。
想脱离 uuos 单独使用？见 产品族 · saas
它提供什么
套餐与订阅
定义计划、档位与计费周期，管理订阅的创建、变更与取消——商业模型改动不碰业务代码。
权益与配额
按计划声明权益；任何昂贵操作执行前先过 CheckQuota，超限在动作发生前被拦下，而不是月底才发现。
用量计量
幂等的用量事件账本：同一事件重复上报不会重复计费，按周期汇总出准确的消耗视图。
账单
周期账单与超额结算，支付网关接入建设中——先把「算得准」做扎实，再接「收得到」。
宿主可见的全部契约：CheckQuota · RecordUsage · GetUsageSummary · GetSubscription · Routes
怎么集成到 uuos
- 01
配置开启
uuos 配置文件里打开 SaaS 段（或 Helm values 的 productPlugins.saas），声明数据库与默认配额。
- 02
启动即注册
uuos 启动时构造 saas 模块，作为产品插件 ai.uuos.saas 注册进 Registry：API 挂载 /v1/saas，导航与菜单自动出现。
- 03
适配器接线
宿主适配器把 uuos 的租户身份转成 saas 的中立 Scope，把执行引擎的配额检查与用量上报接到 saas 的 Module 接口——saas 本身一行 uuos 代码都不 import。
# uuos-api.yaml —— 打开 SaaS 插件
SaaS:
Enabled: true
DSN: "postgres://…"
DefaultQuota: 100
# Helm 部署等价配置
productPlugins:
saas:
enabled: true
defaultQuota: 100集成后你得到什么
运行前配额拦截
执行引擎在每次工作流运行前调用 CheckQuota：超出套餐的运行直接被拒，成本止损发生在损失之前。
用量自动入账
运行产生的 token 与调用量以幂等事件流入用量账本，无需在工作流里写任何计量代码。
管理界面开箱即用
「用量与账单」「套餐与配额」两组菜单出现在 uuos 一级导航，按 capability 控制可见性。
数据边界清晰
所有数据落在独立命名空间（g_saas_*），迁移脚本由 saas 自己维护，与核心表零外键。
| 插件 ID | ai.uuos.saas |
| API 挂载 | /v1/saas（租户鉴权之后） |
| 能力声明 | saas.subscription.read · saas.usage.read |
| 导航菜单 | 用量与账单 · 套餐与配额 |
组件状态：即将开源，支付网关接入建设中——状态如实标注，同集成页口径。