Function build_linux_sandbox_command

tutorials/14_bash_engine_deep_dive.py:296–357

构建 Linux 命名空间隔离命令 — 源码 sandbox.rs:211-262 真正的隔离是靠 Linux 的 unshare 命令实现的。 unshare 创建新的 namespace（命名空间），让进程运行在 一个"假的"隔离环境中，类似轻量级容器。 各 flag 的含义: --user 创建新的用户命名空间（进程觉得自己是 root，但实际没有特权） --map-root-user 将容器内的 root 映射到宿主机当前用户 --mount 创建新的挂载命名空间（看不到宿主的挂载点）

(
    command: str,
    cwd: Path,
    status: SandboxStatus
)

def build_linux_sandbox_command(
    command: str,
    cwd: Path,
    status: SandboxStatus
) -> Optional[LinuxSandboxCommand]:
    """构建 Linux 命名空间隔离命令 — 源码 sandbox.rs:211-262

    真正的隔离是靠 Linux 的 unshare 命令实现的。
    unshare 创建新的 namespace（命名空间），让进程运行在
    一个"假的"隔离环境中，类似轻量级容器。

    各 flag 的含义:
    --user          创建新的用户命名空间（进程觉得自己是 root，但实际没有特权）
    --map-root-user 将容器内的 root 映射到宿主机当前用户
    --mount         创建新的挂载命名空间（看不到宿主的挂载点）
    --ipc           创建新的 IPC 命名空间（隔离共享内存、信号量）
    --pid           创建新的 PID 命名空间（看不到宿主的进程）
    --uts           创建新的 UTS 命名空间（可以有不同的主机名）
    --fork          fork 后在新 namespace 中执行
    --net           创建新的网络命名空间（完全隔离网络，可选）
    """
    # 不是 Linux、没启用、或者命名空间和网络都没激活 → 不用沙箱
    if sys.platform != "linux":
        return None  # macOS 用 seatbelt (sandbox-exec)，这里不覆盖
    if not status.enabled:
        return None
    if not status.namespace_active and not status.network_active:
        return None

    args = [
        "--user",          # 用户命名空间
        "--map-root-user", # root 映射
        "--mount",         # 挂载命名空间
        "--ipc",           # IPC 命名空间
        "--pid",           # PID 命名空间
        "--uts",           # UTS 命名空间
        "--fork",          # fork 执行
    ]
    if status.network_active:
        args.append("--net")  # 网络命名空间（完全断网）

    args.extend(["sh", "-lc", command])

    # 环境变量——重定向 HOME 和 TMPDIR 到沙箱目录
    sandbox_home = str(cwd / ".sandbox-home")
    sandbox_tmp = str(cwd / ".sandbox-tmp")

    env = {
        "HOME": sandbox_home,
        "TMPDIR": sandbox_tmp,
        "CLAWD_SANDBOX_FILESYSTEM_MODE": status.filesystem_mode.value,
        "CLAWD_SANDBOX_ALLOWED_MOUNTS": ":".join(status.allowed_mounts),
    }
    # 保留 PATH
    if "PATH" in os.environ:
        env["PATH"] = os.environ["PATH"]

    return LinuxSandboxCommand(