# AI OS Platform

> Public documentation for AiOS covering onboarding, platform delivery, agent access, operations, and stable references.

## Docs

- [DevBox Lifecycle v0](https://docs.skrmir.com/agent-platform/architecture/devbox-lifecycle/index.md): State model, transition matrix, and execution gating rules for DevBox lifecycle.
- [Probe Architecture v0](https://docs.skrmir.com/agent-platform/architecture/probe-architecture/index.md): Control-plane/data-plane split, Probe internal modules, and bounded authority rules.
- [Channel Integration Page v0](https://docs.skrmir.com/agent-platform/console/channel-integration-page/index.md): Information architecture and form model for channel onboarding, routing, status, and credential-backed configuration.
- [Channel Adapter Contract v0](https://docs.skrmir.com/agent-platform/contracts/channel-adapter-v0/index.md): Canonical adapter boundary for external channels, inbound normalization, outbound actions, and health reporting.
- [Channel Contract v0](https://docs.skrmir.com/agent-platform/contracts/channel-v0/index.md): Canonical contract for ssh_remote and dialog channels.
- [Gateway to Probe Command Contract v0](https://docs.skrmir.com/agent-platform/contracts/gateway-to-probe-command-v0/index.md): Executable v0 command envelope, minimal command set, and current Probe-side validation rules.
- [Probe Capability Contract v0](https://docs.skrmir.com/agent-platform/contracts/probe-capability-v0/index.md): Probe capability schema, compatibility, and validation rules.
- [Probe to Gateway Event Contract v0](https://docs.skrmir.com/agent-platform/contracts/probe-to-gateway-event-v0/index.md): Executable v0 event envelope, minimum event types, and current ingestion rules.
- [Dialog Ecosystem v0](https://docs.skrmir.com/agent-platform/integrations/dialog-ecosystem/index.md): Reuse strategy for dialog multi-channel ecosystem, OpenClaw compatibility, and canonical AIOS ownership boundaries.
- [Telegram Integration v0](https://docs.skrmir.com/agent-platform/integrations/telegram/index.md): Telegram as a dialog target in AIOS, including adapter reuse posture, route binding, and metadata-only operational boundaries.
- [WeChat Integration v0](https://docs.skrmir.com/agent-platform/integrations/wechat/index.md): WeChat as a dialog target in AIOS, including adapter fit, route binding, auth model, and operational boundaries.
- [Audit and Metadata Policy v0](https://docs.skrmir.com/agent-platform/operations/audit-metadata-v0/index.md): Forward-only metadata policy, audit fields, and observability boundaries.
- [Scheduler v0](https://docs.skrmir.com/agent-platform/operations/scheduler-v0/index.md): One-shot, interval, cron scheduling semantics and misfire policy.
- [Self-heal Policy v0](https://docs.skrmir.com/agent-platform/operations/self-heal-v0/index.md): Bounded local recovery rules, retry thresholds, and escalation policy.
- [CLI 方向指南](https://docs.skrmir.com/agent/cli-guide.md): AiOS 未来 CLI 的命令结构方向，以及当前仓库应如何理解 bootstrap/server 入口。
- [常见问题](https://docs.skrmir.com/agent/faq.md): AiOS 中与 Agent、CLI 和自动化接入相关的常见问题与排障建议。
- [Agent 总览](https://docs.skrmir.com/agent/index.md): AiOS 中 Agent、CLI 与 Web 如何共享统一控制面能力、审批链与执行语义。
- [生产环境二次验证与审批](https://docs.skrmir.com/agent/production-approval.md): 定义生产环境变更在 Web、CLI、Agent 中统一使用的 step-up 与 approval 门禁。
- [工具集成](https://docs.skrmir.com/agent/tool-integrations.md): AiOS 中支持的 AI 编码工具、接入步骤与扩展适配建议。
- [完整模式初始化](https://docs.skrmir.com/getting-started/bootstrap-full-mode.md): 生产导向的 bootstrap 路径，覆盖更完整的依赖、治理和正式运行前提。
- [轻量模式初始化](https://docs.skrmir.com/getting-started/bootstrap-light-mode.md): 轻量模式下的 bootstrap 流程：preflight、网络选源、K3s 初始化和默认环境创建。
- [部署第一个应用](https://docs.skrmir.com/getting-started/deploy-first-app.md): 通过 Git 或 Compose 作为输入，完成 AiOS 中的第一次应用交付。
- [第一个 Agent 命令](https://docs.skrmir.com/getting-started/first-agent-command.md): 理解第一条 Agent 或未来 CLI 命令将如何接入统一服务端授权链，以及当前仓库可执行的替代入口。
- [开始使用](https://docs.skrmir.com/getting-started/index.md): AiOS 的统一入门入口，覆盖安装、bootstrap、首次应用交付与首次 Agent 命令。
- [单二进制安装](https://docs.skrmir.com/getting-started/install.md): 通过二进制入口完成 AiOS bootstrap 与本地开发验证的快速开始说明。
- [本地 PostgreSQL 开发环境](https://docs.skrmir.com/getting-started/local-postgres-dev.md): 使用 Docker Compose 启动本地 PostgreSQL，执行 migration，并以外部状态模式启动 AiOS 控制面。
- [AI OS Platform](https://docs.skrmir.com/index.md): AiOS 的公开文档入口，覆盖开始使用、平台与交付、Agent 与 CLI、运维与参考。
- [认证与授权模型](https://docs.skrmir.com/operations/authn-authz.md): AiOS 中 AuthN、AuthZ、Approval 的职责边界、执行链和生产环境安全门禁。
- [运维与安全总览](https://docs.skrmir.com/operations/index.md): AiOS 的安装、运行治理、可观测性、安全模型与运维入口页面。
- [日志架构](https://docs.skrmir.com/operations/logging.md): AiOS 中 logging、audit、observability 的分层与状态外置要求。
- [故障排查](https://docs.skrmir.com/operations/troubleshooting.md): AiOS 中常见启动、部署、Agent 执行与日志关联排障路径。
- [升级指南](https://docs.skrmir.com/operations/upgrade-guide.md): AiOS 从 bootstrap 验证走向正式运行时的升级、扩展与风险控制建议。
- [Web UI 操作手册](https://docs.skrmir.com/operations/web-ui-guide.md): AiOS Web UI 的导航结构、核心操作和协作模式。
- [应用交付总览](https://docs.skrmir.com/platform/application-delivery.md): AiOS 应用输入模型、Compose 导入、部署生命周期与运行交付入口。
- [系统架构](https://docs.skrmir.com/platform/architecture.md): AiOS 的双层架构、核心组件与数据流。
- [分层架构设计](https://docs.skrmir.com/platform/architecture/layered-architecture.md): AiOS 的 Interface / Usecase / Domain / Infrastructure 分层、依赖规则与运行态边界。
- [备份模型](https://docs.skrmir.com/platform/backup-model.md): AiOS 中平台状态、任务、审批、审计和运行产物的备份与恢复模型。
- [轻量模式与完整模式](https://docs.skrmir.com/platform/cluster/light-vs-full-mode.md): AiOS 轻量模式与完整模式在 bootstrap 范围、依赖规模与生产适用性的对比。
- [Compose 支持矩阵](https://docs.skrmir.com/platform/compose-support.md): AiOS 对 Docker Compose 的受限子集支持、告警语义、阻断规则与 strict 模式。
- [配置参考](https://docs.skrmir.com/platform/config-reference.md): AiOS 平台与 Agent 访问相关的关键配置项、默认值与推荐范围。
- [部署指南](https://docs.skrmir.com/platform/deployment-guide.md): AiOS 在本地、单节点与多节点环境的部署建议。
- [部署生命周期](https://docs.skrmir.com/platform/deployment-lifecycle.md): AiOS 中从提交部署到审批、任务执行、验证、回滚与审计闭环的应用部署生命周期。
- [域名与 TLS](https://docs.skrmir.com/platform/domain-and-tls.md): AiOS 中域名暴露、TLS 自动化与 cert-manager/ACME 的职责边界。
- [平台总览](https://docs.skrmir.com/platform/index.md): AiOS 平台能力、运行形态分层、环境模型与架构入口页面。
- [环境模型：Dev/Test/Preview/Prod](https://docs.skrmir.com/platform/projects/environments-dev-test-preview-prod.md): AiOS 默认环境模型、权限边界、审批策略与运行差异。
- [API 参考](https://docs.skrmir.com/reference/api/index.md): AiOS 对外 API 参考入口。
- [CLI 规划参考](https://docs.skrmir.com/reference/cli-reference.md): AiOS 未来 CLI 命令模型的规划参考，以及当前仓库的 bootstrap/server 边界说明。
- [术语表](https://docs.skrmir.com/reference/glossary.md): AiOS 公共文档中的关键术语定义。
- [参考总览](https://docs.skrmir.com/reference/index.md): AiOS 中的命令、配置、API 与稳定规格参考入口。
- [Agent 平台稳定规格](https://docs.skrmir.com/reference/specs/index.md): AiOS Agent 平台的稳定契约、架构与运维规格入口。

## OpenAPI Specs

- [openapi](https://docs.skrmir.com/api-reference/openapi.json)