为什么先讲类型？

你有没有遇到过这种情况：三个人讨论一个功能，说着说着发现每个人嘴里的"命令"指的不是同一回事？

类型程序就是来统一语言的。 说到在这个包里，

• SandboxMode 只能是三种字符串之一，不会出现拼写错误
• CommandRiskLevel 只能是 L0~L4。不会冒出 L5
• SandboxCommandInput 明确区分了"shell 命令"和"结构化 exec"两种输入方式

先理解类型，后面看代码就不会迷路。

类型文件结构

所有类型定义都在 src/types/ 目录下由 index.ts 统一导出：

src/types/
├── index.ts ← 统一导出入口
├── sandbox.ts ← 沙箱模式 & 执行面
├── policy.ts ← 风险等级 & 操作意图
├── approval.ts ← 审批策略 & 审批决策
├── command.ts ← 命令输入/输出
├── config.ts ← 配置对象
├── audit.ts ← 审计事件 & Run 上下文
├── proxy.ts ← 代理相关
├── executor.ts ← 执行器 IO 回调
├── runner.ts ← Runner 相关
├── seatbelt.ts ← macOS Seatbelt
├── file-patch.ts ← 文件 Patch
└── worktree.ts ← Git Worktree

sandbox.ts——沙箱模式 & 執行面

SandboxMode

export type SandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access';不过，

这就是三种沙箱模式：