咱这儿的Runner入口，可不是随便哪个入口。

你懂的，它可得处理不少事儿。Neng力检测、模式回退、沙箱管理… 咱们就说说这几个关键点，顺便聊聊为什么有时候会遇到“为什么百度不收录”这种问题，哈哈。

src/runner.ts，这个家伙就是个大管家。它负责把整个沙箱执行流程给统筹起来。别kan它kan起来简单，里面可是有不少逻辑呢。

async function resolveEffectiveMode => Promise<OsSandboxFallbackDecision>;}): Promise<SandboxMode | null> {  // . danger-full-access 直接返回  if  {    return 'danger-full-access';  }  // . 检查 OS 沙箱Neng力  const capability = checkOsSandboxCapability;  if  {    return options.requestedMode;  // OS 沙箱可用，用请求的模式  }  // . OS 沙箱不可用，没回调 → 抛错  if  {    throw new Error`,    );  }  // . 问回调  const decision = await options.onOsSandboxUnavailable;  // . 回调想回退但配置不允许 → 抛错  if  {    throw new Error`,    );  }  // . 返回Zui终决策  return decision === 'abort' ? null : 'danger-full-access';}

你kan这代码，是不是挺清晰？resolveEffectiveMode这个函数，就是核心。它会根据不同的情况，决定Zui终使用哪个模式。

咱们得先知道操作系统是不是支持沙箱。checkOsSandboxCapability这个函数就负责这部分工作。它会检查当前平台是否支持指定的沙箱模式。

function checkOsSandboxCapability: OsSandboxCapability {  if  {    return { ...checkSeatbeltCapability, platform: process.platform };  }  return {    available: false,    platform: process.platform,    reason: `OS sandbox is not implemented on ${process.platform} for mode "${mode}".`,  };}

目前啊，只支持 macOS 的 Seatbelt 沙箱。其他平台嘛… 就得乖乖地返回 `available: false` 了。

export async function runSandboxedCommand { // . 确保执行根目录存在 const executionRoot = path.resolve; if ) { fs.mkdirSync; } // . 决定实际执行模式 const effectiveMode = await resolveEffectiveMode; // . abort → 返回退出码 if { return { exitCode: , effectiveMode: options.mode }; } // . danger-full-access → 直接 spawn if { const exitCode = options.commandSpec.kind === 'exec' ? await spawnAndWait : await spawnShellUnsafe; return { exitCode, effectiveMode }; } // . OS 沙箱模式 → Seatbelt const exitCode = await runWithOsSandbox; return { exitCode, effectiveMode };}

你kan啊，先要确保执行的目录存在吗？然后根据resolveEffectiveMode的结果来决定怎么跑。Ru果effectiveMode是`null`，那直接返回退出码了。

export async function runWithOsSandbox { switch { case 'darwin': { const spec = buildSeatbeltSpawnSpec; return spawnAndWait; } default:{ return Promise.reject).}; }

请求：workspace-writeOS 沙箱可用 → Seatbelt 执行effectiveMode = workspace-write 请求：workspace-writeOS 沙箱不可用 → 问回调回调返回 danger-fullaccess → 直接 spawneffectiveMode = dangerfull_accessdangerousFallbackUsed = true 请求：workspace-writeOS 沙箱不可用 → 问回调回调返回 abort → 不执行exitCode =

Ru果Neng用沙箱的话，那就直接用沙箱

Ru果不Neng用沙箱呢？那咱就问一下用户怎么处理

用户说“回退”的话，那就直接跑

用户说“放弃”的话，那就啥也不干

runSandboxedCommand总入口，负责决策和执行

resolveEffectiveMode决定Zui终运行模式

checkOsSandboxCapability检查沙箱是否可用

runWithOsSandbox在 macOS 上使用 Seatbelt 沙箱

命令规格 + 沙箱配置

退出码 + 实际运行模式

你觉得怎么样？咱这儿的技术分享就先到这儿吧。希望对你有帮助！ Ru果你觉得有什么地方不够清楚的地方Ke以尽管提出来哦！