Agent 操作层 agentic-os-org/ANOLISA

Agentic Nexus Operating Layer & Interface System Architecture

面向 AI 智能体的系统软件栈。

中文版 · 官网 ·快速开始 · 用户指南 ·参与贡献

ANOLISA 是一套多组件系统软件栈，面向 AI 智能体负载。 它构建在现有操作系统内核与基础设施之上，为智能体应用、框架和平台提供上下文管理、技能交付、工作区恢复、安全与可观测能力。
用户可以在原生终端里执行任务，Shell 体验一如既往，还能为智能体的运行环境开启系统级优化。开发者可以借助 AW 的开放架构，把自己针对智能体负载优化的系统软件集成进 ANOLISA，从而扩展这套软件栈。

ANOLISA 与 Agentic OS 的区别： Agentic OS 指一类为 AI 智能体负载设计的操作系统。我们的社区以中立、开放的方式探索这个方向；ANOLISA 是我们设计的 Agentic OS 架构中的核心系统软件栈。

1. 快速开始

ANOLISA 提供三种上手方式：用预装镜像体验 Agentic OS 的完整能力；在现有操作系统上安装这套系统软件栈，把它扩展成 Agentic OS；或者接入已有的智能体应用、框架或 harness，开启可配置的系统级优化。

1.1 从镜像开始

在开箱即用的预装系统环境里，你可以在 cosh 中使用熟悉的 Shell 工作流，用自然语言调用系统工具和技能。安装并配置好相关组件后，你还能使用智能体语义层的能力，例如上下文压缩、工作区快照与恢复、安全、可观测性。容器基础镜像为构建你自己的智能体运行时环境提供起点。

镜像与云服务目录列出可用镜像、预装软件、下载或拉取地址，以及云服务入口。厂商和社区贡献者可以向目录添加镜像或云服务条目及使用说明。

智能体平台和智能体运行时基础设施的开发者，可以在智能体、沙箱或业务镜像中预装 ANOLISA 包。参见基础镜像目录和包安装指南。

1.2 把现有操作系统转换为 Agentic OS

如果你已经在运行受支持的 Linux 系统，可以安装 ANOLISA 的系统软件栈，为智能体工作负载增加运行时能力。你可以安装 cosh、OS Skills 和所需的 Agent Semantic Layer 组件，用 cosh 作为终端入口，并配置模型访问和相关服务。

先阅读安装指南确认平台要求，然后安装软件包并配置服务。按照 cosh 首次使用指南开始使用终端。

1.3 为现有智能体启用 ANOLISA

如果你想继续使用现有的智能体应用、框架或 harness，可以通过适配器和插件，在其运行时环境中启用 ANOLISA 的无头系统能力。你可以继续使用智能体的界面、模型账号和工作流。

当前可用的工作流，参见安装与适配器集成。

2. 为什么选择 ANOLISA？

ANOLISA 是一套系统软件栈，增强智能体应用、框架和 harness，而不替换它们。

智能体规划任务、调用工具时，也需要运行时环境提供上下文管理、技能发现、动作约束和执行记录。ANOLISA 从以下几方面改善智能体的工作环境：

- 为有用信息保留上下文。 工具输出压缩会缩短冗长的结果。持久记忆让智能体跨会话检索并复用信息，减少重复读取。
- 为任务找到系统技能。 智能体可以查阅 OS 指令，发现并读取任务所需的技能。
- 约束动作并恢复工作区变更。 安全策略和底层隔离机制会约束智能体行为。工作区快照让用户查看文件改动，需要时回滚。
- 了解任务如何运行。 你可以查看智能体的模型调用和工具调用、执行轨迹、token 用量，排查任务失败原因，分析运行时开销。

欢迎 操作系统厂商和发行版社区 采用并参与开发 ANOLISA，把它集成进现有发行版，或从一开始就纳入自己的智能体操作系统架构。

企业智能体治理平台开发者 和 沙箱服务商 也可以在运行时环境中预装 ANOLISA，为托管的智能体工作负载提供上下文管理、安全和可观测性。

3. 示例

可观测性：观察智能体运行查看模型调用和工具调用、执行轨迹、token 用量。复现指南

上下文压缩：查看工具输出压缩试用 Tokenless，查看工具输出压缩和 token 用量变化。复现指南

安全：检测技能文件改动用 Qoder 检查技能文件改动，查看重新扫描结果。复现指南

4. 组件

ANOLISA 的组件分为用户入口层、AW 统一栈层和智能体语义层。各层职责见术语表。

4.1 用户入口层

| 组件 | 新增能力 |
| cosh (cosh-ng) | AI 原生终端，保留你熟悉的 Shell 体验，让你用自然语言调用工具和技能来完成任务。 |
| OS Skills | 面向 AI 智能体的操作系统手册，覆盖系统管理、监控、安全、DevOps 自动化等。 |

4.2 AW 统一栈层

| 组件 | 新增能力 |
| AW | 统一架构，把智能体框架与可扩展的 AI 原生系统软件连接起来。 |

4.3 智能体语义层

| 组件 | 新增能力 |
| Tokenless | 压缩工具输出、简化工具 schema、重写命令，以此降低 AI 智能体的 token 消耗。 |
| Agent Memory | 存储持久记忆，智能体可在后续会话中检索并复用。 |
| SkillFS | 把技能组织成稳定的文件系统视图，供智能体按需发现和读取。 |
| Workspace Checkpoint (ws-ckpt) | 创建智能体工作区快照，让你对比文件差异，需要时回滚改动。 |
| Agent Security Core | 面向 AI 智能体的操作系统级安全内核。 |
| AgentSight | 通过轨迹、LLM 调用和 token 用量观察智能体执行过程。 |

ANOLISA CLI 负责组件安装与生命周期管理。ktuner 检查 Linux 内核参数，给出调优建议，还能应用或回滚内核参数改动。各组件支持哪些平台，见安装。

5. 开放架构

在 ANOLISA 的 AW 统一栈层里，AW 把智能体与支撑它们的系统软件连接起来。开发者可以为 AW 尚未支持的智能体编写适配器，也可以开发针对智能体负载优化的系统软件，再通过 Provider 协议把能力暴露给 ANOLISA。原有的智能体应用或框架继续管理自己的模型、界面和权限。

AW 目前集成了命令安全检查与工具内容优化，还能通过可选配置关联 AgentSight 的执行记录。底层资源和隔离机制由现有操作系统、内核和沙箱提供。ANOLISA 面向这样的环境包括 AI PC 和云桌面、智能体应用与框架、智能体平台，以及智能体运行时基础设施。

5.1 配置与执行示例

这个示例在同一份配置里同时启用安全检查与上下文优化。运行前，请按 AW 安装 安装 Linux 预览版 aw-all-in-one，并设置 AW_PREFIX 和 PATH。然后按 安全后端设置 启动 sec-core。CI 包要求 Linux x86_64 系统，glibc 2.39 或更高版本。你还需要 Qoder CLI 1.1.64 或更高版本，并已安装、已登录。

用平时运行 Qoder 的用户执行以下命令，新建 anolisa.yaml 并启动智能体。下面的 socket 路径连接安全指南里的本地试用后端。如果要连接另一个已有的安全后端，把 AW_SEC_SOCKET 设为该服务实际的 socket 路径。

export AW_HOME="$HOME/aw"
export AW_SEC_SOCKET=/run/aw-preview-sec/daemon.sock
install -d -m 700 "$AW_HOME" "$AW_HOME/workspace"
aw config init --prefix "$AW_PREFIX" \
--config "$AW_HOME/anolisa.yaml" --state-dir "$AW_HOME/anolisa-state" \
--qoder "$(command -v qodercli)" \
--provider sec-core+tokenless --socket "$AW_SEC_SOCKET"
aw validate --config "$AW_HOME/anolisa.yaml"
cd "$AW_HOME/workspace"
aw run --config "$AW_HOME/anolisa.yaml" --agent qoder

对配置覆盖的工具调用，sec-core 会在工具执行前做安全检查。工具执行成功后，Tokenless 会尝试压缩支持的文本结果。智能体调用过工具后，另开一个终端，把 PATH 和 AW_HOME 设成与启动智能体的终端一致，再执行以下命令查看执行记录：

aw status --config "$AW_HOME/anolisa.yaml"
aw inspect --config "$AW_HOME/anolisa.yaml" --json

退出智能体后，执行 aw stop --config "$AW_HOME/anolisa.yaml" 停止本地 AW 服务。然后按你启动安全后端的方式，用对应命令停止它。其他智能体集成、规则配置和可观测性集成，见 AW 用户指南。

5.2 开发与扩展

按你要构建的集成选一份指南：

- 智能体与框架集成 — 了解如何把 AW 接入智能体应用或框架的原生执行流程。
- 服务商开发与协议 — 了解如何通过 Provider 协议把你的系统软件暴露给 ANOLISA。
- SDK 指南 — 学习如何在应用代码中调用组件能力。

6. 文档与开发

| 目标 | 从这里开始 |
| 安装、配置和使用组件 | 用户指南 · 安装 · 故障排查 |
| 在应用中嵌入组件能力 | SDK 指南 |
| 把智能体或框架接入 AW | AW 集成 |
| 开发和分发 AW 服务商 | 服务商开发与协议 · 服务商实现 |
| 为 ANOLISA 做贡献 | 贡献指南 · 组件章节 |

7. 仓库结构

仓库包含运行时组件、分发工具、评测工具，以及保留的旧版实现。组件源码迁移到其他目录后，其命令、包名和发布标签保持不变。

| 目录 | 内容 |
| src/ | 运行时组件，包括 AW、cosh-ng，以及提供可观测性、安全、记忆和沙箱能力的组件。每个组件保留自己的构建和测试入口。 |
| providers/ | AW 服务商协作空间。每个服务商实现都有自己的工作区、示例和契约测试。 |
| distribution/ | 分发工具与镜像。anolisa/ 负责安装命令行、组件清单和打包资源；docker/ 定义集成后的 ANOLISA 镜像。 |
| benchmark/ | 跨组件评测运行器：ClawEval、SWE 和 Terminal Bench。组件专属的基准测试留在各自组件内。 |
| deprecated/ | 保留的旧版实现及其归档文档。 |
| scripts/ | 仓库级构建、打包和校验脚本。 |
| tests/ | 仓库级回归检查和测试编排。组件测试仍留在各组件本地。 |
| contribute/ | 组件贡献指南，由仓库根目录的贡献指南链接。 |
| docs/ | 用户与开发者指南、源码构建说明，以及共享文档资源。 |
| specs/ | 贡献规范、组件接入和文档规则。 |
| website/ | 公开网站源码与生成器。生成产物不作为第二份文档来源。 |
| .github/ | CI、发布工作流、组件路由元数据和归属信息。 |
改动文件之前，先读 AGENTS.md，了解仓库规则、组件位置和构建/测试命令；如果组件自带作用域内的 AGENTS.md，也要一并读。贡献流程见 CONTRIBUTING.md。移动源码时，要同步更新 .github/components.json，以及构建、发布、归属配置和文档入口用到的路径。组件的命令、包名和发布标签保持不变。

8. 社区

用钉钉扫码加入 ANOLISA 社区。

- 遇到问题，或希望项目支持新的智能体用例，请提交 issue。
- 提交 pull request 之前，先读 CONTRIBUTING.md。
- 漏洞请通过安全策略上报。

9. 许可证

ANOLISA 基于 Apache License 2.0 发布。

10. 更多资源

用户指南 ·故障排查 ·从源码构建 ·更新日志 ·面向智能体

Agent Security Core 的安全参考： AARM 注册条目（Aligned） · OWASP Agentic Top 10 控制项映射。

Blaze 已迁到独立仓库 blaze-rs。

11. 术语表

| 术语 | 含义 |
| ANOLISA | 面向 AI 智能体负载的多组件系统软件栈。 |
| Agentic OS | 为 AI 智能体负载设计的一类操作系统。 |
| User Entrypoint Layer | cosh 为用户提供终端交互；OS Skills 为智能体提供 OS 指令。 |
| AW Unified Stack Layer | AW 向上连接智能体应用与框架，向下连接可扩展的系统软件。 |
| Agent Semantic Layer | 提供上下文管理、记忆、技能下发、工作区恢复、安全和可观测性的组件。 |