项目地址: https://github.com/openxlings/xlings

注: 目前 linux 体验比较好, windows/macos 上逐渐适配中

使用者: MCPP · 即将推出的 Luban Linux

为什么选 xlings?

vs 其他工具

快速开始

安装

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.ps1 | iex

让你的 AI Agent 帮你装

把以下内容复制给你的 AI agent(Claude / Codex / OpenCode 等):

帮我安装 xlings 包管理器。
- Linux/macOS: curl -fsSL https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.sh | bash
- Windows: irm https://raw.githubusercontent.com/openxlings/xlings/main/tools/other/quick_install.ps1 | iex
项目地址: https://github.com/openxlings/xlings

试一试多版本

xlings install gcc@16 node@24 cmake
xlings use gcc@16        # 切换当前版本
gcc --version            # gcc 16.x

核心概念

特性

1. 📦 通用包管理基础设施 — 二进制/脚本/配置/子操作系统（SubOS）/教程，统统是 xpkg
2. 🔀 多版本共存 — 同一工具 N 个版本并存；版本视图 + 引用计数（N 个环境 ≈ 1 份存储）
3. 🏗️ 三级子操作系统（SubOS）隔离 — shell（环境切换）/ 文件系统（bwrap/proot，无需 root）/ 镜像（ext4，需 root）
4. 🌐 去中心化包索引 — 官方 + 第三方 + 自建仓库；资源服务器做二进制镜像分发
5. 🤖 JSON 事件接口 — xlings interface（NDJSON 协议）面向 AI Agent、CI 和第三方工具

场景

🛠 工具链 — 多版本免 sudo

xlings install gcc@16 gcc@11 cmake node@24
xlings use gcc@16        # 即时切换
xlings use gcc@11        # 切回 11, 互不干扰

📦 项目 — 无感进入项目级子操作系统（SubOS）

当你进入包含 .xlings.json 的项目目录时，xlings 自动透明地激活项目级子操作系统（SubOS） — 你和团队在隔离环境中工作而无需任何手动操作。所有依赖都在项目自己的子操作系统（SubOS）中。

{
  "workspace": {
    "xmake": "3.0.7",
    "gcc": { "linux": "16.1.0" },
    "llvm": { "macosx": "20.1.7" }
  }
}

cd my-project/           # 自动进入项目 SubOS
xlings install           # 依赖装进项目级隔离环境
xmake build              # 一切正常运作, 与宿主机隔离

克隆 → cd → 构建。团队和 CI 环境完全一致，无需手动激活。

🤖 智能体 — 智能体运行在自己的轻量级世界中

xlings 让你把智能体（codex / claude / opencode 等）在 SubOS 内部运行 — agent 在隔离环境中拥有完全权限，宿主机完全安全。

为什么这很重要：

• 🔓 Agent 在 SubOS 内拥有更大权限 — 装包、改文件、跑任意代码 — 不会伤害宿主机
• 🔁 同一个 agent 工具，一台机器上多个实例 — 每个 SubOS 有独立配置（正常情况下 codex/claude 一个账号只能跑一份）
• ⚡ 轻量级 — 不是重型 VM 或容器，仅命名空间隔离

在 SubOS 中运行 Agent：

# 创建 SubOS(从 base 环境 fork,或自己从零配置)
xlings subos new claude-workspace --from subos:dev-env@latest

# 进入 SubOS — Agent 在这里面运行,拥有完全控制权
xlings subos use claude-workspace --sandbox
# → 现在你在 agent 的世界里
# → 在这里启动 claude / codex / opencode
# → 它们可以自由安装、修改、实验 — 宿主机不受影响

# 同一台机器上运行多个隔离的 agent 实例
xlings subos new claude-workspace-1 --from subos:dev-env@latest
xlings subos new claude-workspace-2 --from subos:dev-env@latest
xlings subos new codex-workspace --from subos:dev-env@latest

一次性任务也可以用 --cmd：

xlings subos use claude-workspace --sandbox --cmd "python analyze.py"

无需 root，无守护进程，无镜像膨胀。每个智能体(Agent)拥有自己的世界。

子操作系统(SubOS)详解

三级隔离

关键能力

• 从基础分支 — xlings subos new <name> --from <local|subos:pkg@ver>（共享存储下0秒）
• 非交互执行 —xlings subos use <name> --cmd "<command>"退出码透传
• 沙箱模式 — --sandbox 标志;bwrap 优先 (setuid, xim 自管理), proot 兜底
• 存储模式 — --storage shared|tmpfs|image, fork 时选择
• 项目级子操作系统 (SubOS) — .xlings.json 中声明, 进入项目目录即自动透明激活
• Keeper (可选) — --keep 保持挂载命名空间 (mount namespace) 活跃, 高频执行 (exec) 优化;xlings subos stop 释放

包索引生态

graph TD
    subgraph 来源
        S1["🏛️ 官方 - openxlings/xim-pkgindex"]
        S2["🌍 第三方 - 社区仓库"]
        S3["🏠 自建 - 团队 Git / 本地路径"]
    end

    subgraph "资源服务器 (二进制镜像)"
        R1[GLOBAL]
        R2[CN]
        R3[自建 OSS]
    end

    S1 & S2 & S3 -->|"xpkg 包描述"| X[xlings install]
    X -->|"下载二进制"| R1 & R2 & R3

    style X fill:#e8f5e9

一行添加自定义索引:

{
  "index_repos": [
    { "name": "xim", "url": "https://github.com/openxlings/xim-pkgindex.git" },
    { "name": "my-team", "url": "[email protected]:devtools/pkgs.git" }
  ]
}

生态

Agent 集成

Agent 运行在 SubOS 内部

不同于传统的"agent 调用工具"模式，xlings 让 agent 本身运行在 SubOS 里面。agent 拥有一个完整的隔离环境 — 可以装包、写文件、跑服务 — 全都不会影响宿主机。

程序化接口

xlings interface 提供 NDJSON 协议（stdio 通信）— 面向 AI Agent、CI 系统和第三方工具的程序化控制：

xlings interface
# → {"protocol":"1.0","capabilities":[...]}
# ← {"action":"install","target":"subos:py-ds@latest"}
# → {"kind":"progress","phase":"downloading","percent":45,...}
# → {"kind":"data","dataKind":"installed","payload":{...}}

开发 & 测试环境

除了 Agent，SubOS 同样适合开发和测试：

# 不同场景不同环境
xlings subos new rust-nightly --storage shared
xlings subos new legacy-gcc11 --storage shared

# 或使用项目级模式:进入项目目录即自动进入隔离环境
cd my-project/           # 无感进入项目 SubOS

从源码构建

# 1. 安装 xlings(见上方"快速开始")
# 2. 在仓库根目录安装构建依赖:
xlings install           # 读取 .xlings.json → xmake, cmake, ninja, 工具链

# 3. 切换到开发工具链:
xlings use [email protected]    # 确保 xrepo 缓存用 glibc 链接

# 4. 构建:
xmake f -y && xmake build xlings
xmake build xlings_tests && xmake run xlings_tests

.xlings.json 同时驱动 CI 和 release 流水线。

社区

• 项目地址:https://github.com/openxlings/xlings
• 论坛：forum.d2learn.org/category/9/xlings
• QQ群: 167535744 / 1006282943
• 问题:github.com/openxlings/xlings/问题