ARCHITECTURE

技术架构

pnpm 单仓八包，契约自底向上单向依赖；一页看清轻云启怎么搭起来。

分层与依赖

上层只依赖下层，契约是唯一事实源。

接入层 · web / ui / 小程序React 19 建设台与运行时页面 · Taro 小程序 · 交付物静态通道
服务层 · server（Fastify 5）REST + MCP 同进程 · 通道化写路径 · 统一审计与授权过滤
领域层 · runtime / metadata / kernel集合运行时 · 元数据注册表与权限空间 · 内核原语（媒体/脚本/队列）
契约层 · contractsschemas / endpoints / 错误目录 / 技能文档，0.2.0-p55 单一事实源
存储层 · PostgreSQL 18业务数据 · 元数据 · 队列 · 用量账本 · 媒体卷
TypeScriptFastify 5Prisma 7PostgreSQL 18React 19Vitevitestpnpm monorepo
  • 契约驱动开发：任何接口改动先改契约，OpenAPI、类型与技能文档同步生成，测试校验一致性。
  • 通道化写路径：所有元数据变更走统一写通道，继承租户、鉴权与审计，无旁路。
  • AI 网关：sys_ai_model 注册表（模态/归属/档位）＋三层计费闸＋sys_ai_usage 输入输出分计。
  • 任务队列：sys_ai_task 状态机 PENDING → RUNNING → READY / FAILED → DEAD，死信可查。
  • 脚本四道出站闸：域名白名单 → 协议校验 → 内网封锁 → 重定向拦截，全部宿主侧执行。
  • 多副本安全：后台循环与队列消费按多实例设计，加机器即扩容，不引入新组件。