ObjectOS参考
运行时能力
ObjectOS 能从 ObjectStack 框架包加载的能力。
运行时能力
ObjectOS 为每个项目加载一个基础运行时,然后安装应用 artifact 声明的可选能力。
基础运行时
基础项目内核包含：
- ObjectKernel 生命周期与服务注册;
- ObjectQL 数据引擎;
- 已配置的数据驱动;
- 元数据服务;
- 应用 artifact 注册;
- 当配置了
OS_AUTH_SECRET时启用认证; - 用于 RBAC、行级安全和字段安全的 security plugin;
- i18n 服务。
可选能力
Artifact 可在其 requires 列表中声明能力。当镜像中存在匹配的框架包时,ObjectOS 会加载它们。
| 能力 | 包 | 用途 |
|---|---|---|
automation | @objectstack/service-automation | 流程/DAG 执行与自动化节点 |
ai | @objectstack/service-ai | LLM 适配器、对话、工具、SSE 路由 |
analytics | @objectstack/service-analytics | Cube、分析查询、报表数据 |
audit | @objectstack/plugin-audit | 审计日志对象与审计轨迹 |
cache | @objectstack/service-cache | 缓存抽象与适配器 |
storage | @objectstack/service-storage | 文件/对象存储服务 |
queue | @objectstack/service-queue | 队列抽象与 worker |
job | @objectstack/service-job | 调度/后台作业 |
realtime | @objectstack/service-realtime | WebSocket 与 pub/sub 实时 |
feed | @objectstack/service-feed | 评论、反应、订阅、动态信息流 |
settings | @objectstack/service-settings | Settings manifest 与 K/V 解析器 |
如果请求了某能力但镜像未包含该包,ObjectOS 会记录警告并继续运行,该能力被禁用。这是有意为之 —— 它使运行时在开发期间即使缺少某个可选包也能启动 —— 但在生产中这是真实风险：
- 加载到不含
@objectstack/plugin-audit镜像的、要求审计的应用,会干净地启动而不写任何审计日志。合规证据会在无任何错误的情况下缺失。 - 加载到不含
@objectstack/service-job镜像的、依赖作业的应用,会干净地启动而静默地从不运行调度工作。
生产清单：
- 将能力警告视为部署失败。在启动日志中 grep
capability not loaded（或你的等价信息）,任何出现都使 readiness probe / rollout 失败。 - 将运行时镜像固定为包含 artifact
requires中声明的每个包的镜像。 - 发布 artifact 时,附带文档化其
requires列表,以便运维核对匹配镜像。
API 表面
ObjectOS 通常暴露：
- 生成的 REST API;
/api/v1/auth/*下的认证端点;- 元数据与 i18n 端点;
- 启用能力的服务端点。
GraphQL 与 OData 是框架级能力,仅当部署的运行时包包含并启用时方可文档化为受支持。