项目所在：https://github.com/openxlings/xlings

注曰：今Linux体验颇佳，Windows与macOS渐次相容中。

用者：MCPP·将出Luban Linux

何以择xlings？

较于他器

速始

安设

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辅尔装焉。

将下录之文，录付尔之智械（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. 普适之囊，统理之础。 — binary / script / config / subos / tutorial 统统是 xpkg
2. 并蓄 多版本共存 — 同一工具 N 个版本并存；版本视图 + 引用计数(N 个环境 ≈ 1 份存储)
3. 构建 三级 SubOS 隔离 — shell(env 切换)/ FS(bwrap/proot,无需 root)/ image(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敕尔以Agent（若Codex、Claude、Opencode诸辈）。运行于SubOS（子操作系统）之内——agent（代理）于隔绝之境具全权，宿主机安然无恙。

何以重之：

• 🔓 Agent（代理）在SubOS（子操作系统）内权柄更广——装包、改文、行任意代码——而不伤宿主机
• 🔁 同一agent（代理）之器，一机上可立多例——每SubOS（子操作系统）各有其制（常例下codex/claude（代码之典/克劳德）一账号只行一份）
• ⚡ 轻巧——非重VM（虚拟机器）或容器，仅namespace（命名空间）相隔

于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（超级用户），无daemon（守护进程），无镜像之臃。各智体(Agent)自有其界。

子操作系统(SubOS)详释。

三级隔绝。

关键之能

• 自基分叉(fork) — xlings subos new <name> --from <local|subos:pkg@ver>(共享存储下零秒)
• 非交互执行 —xlings subos use <name> --cmd "<command>"退码透传
• 沙箱之法 — --sandbox 标识：bwrap(布瑞普)为先，具setuid(设用户ID)、xim(自管)之能，proot(普鲁特)为后备
• 存储之法 — --storage shared|tmpfs|image，分叉之际择之
• 项目之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并驱持续集成与发布之流水线。

乡里

• 项目之所在：https://github.com/openxlings/xlings
• 论场：论坛之数字学习机构之第九类之叉灵（forum.d2learn.org/category/9/xlings）
• QQ群一亿六千七百五十三万五千七百四十四除以十亿零六百二十八万二千九百四十三
• 问题：GitHub之openxlings/xlings议题