> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 系统架构

> AiOS 的双层架构、核心组件与数据流。

# 系统架构

AiOS 采用平台与交付、Agent 自动化访问并行协作的分层架构：

* 平台与交付：负责运行时基础设施、环境模型与应用交付
* Agent 与 CLI：负责自动化访问、审批链与执行语义

本页描述的是 **runtime topology view**，也就是系统在运行时的接入、控制与执行关系。
它不是代码依赖与实现分层的唯一说明；代码层次请以 [分层架构设计](/platform/architecture/layered-architecture) 的 **code-dependency view** 为准。

## 架构分层

### 控制层（Control Layer）

* 配置中心：统一管理环境、密钥与策略
* 调度中心：分配集群资源与 Agent 执行资源
* 观测中心：汇总日志、指标、事件

### 执行层（Execution Layer）

* k3s 集群：承载 AI 应用和服务
* Agent Runtime：承载 Codex / Claude / opencode 等运行实例

### 接入层（Access Layer）

* 未来 CLI：开发者自动化入口
* Web UI：可视化运维与任务管理入口
* API（可选）：对外系统集成入口

## 关键数据流

1. 开发者通过 Web/API，以及未来 CLI/UI，提交部署或 Agent 任务
2. 控制层进行策略校验和调度
3. 执行层运行任务并输出日志/结果
4. 观测中心收集状态并回传到 Web/API，以及未来 CLI/UI

## 如何与代码分层一起阅读

* `Access / Control / Execution` 回答的是“系统在运行时由谁接入、谁决策、谁执行”。
* `Interface / Usecase / Domain / Infrastructure` 回答的是“代码应该如何依赖、如何切分职责”。
* 这两个视角互相补充，但不能互相替代。

## 当前运行模式说明

当前仓库中的 `cmd/aios` 既承担 bootstrap / 本地开发验证入口，也承担 PostgreSQL 接线后的持久化控制面启动入口。

* `bootstrap`：允许无 PostgreSQL 启动，但应理解为 bring-up / 验证路径，而不是完整持久化能力集
* `persistent`：要求 PostgreSQL，并启用当前需要持久化任务状态的控制面能力

对于依赖持久化任务读取的控制台读接口，不应把 bootstrap 误读为“只是数据为空”；它们当前属于显式的 persistent-only surface。

## 规划中的 CLI 参考命令（尚未实现）

当前仓库尚未交付这些命令；它们只用于说明未来运行态入口会如何消费同一组平台状态与诊断能力。

```bash theme={null}
aios status
aios infra cluster status
aios agent status
aios diagnose export --output ./aios-diagnose.tar.gz
```

## 相关页面

* [平台总览](/platform/index)
* [应用交付总览](/platform/application-delivery)
* [分层架构设计](/platform/architecture/layered-architecture)
* [配置参考](/platform/config-reference)