delta-box/deltabox-lite

Lightweight, agent-native sandboxing with diff, commit and abort

它解决了什么问题

AI 编码代理需要在项目中执行命令,而无需担心进行意外更改。deltabox-lite 通过提供一个受限的文件系统视图解决了这个问题,在该视图中,每次修改在最终确定之前都可以进行审查、提交或中止。这赋予了代理完全的执行自由,同时保持了人类对所接受内容的精确控制。

工作原理

Deltabox 使用原生操作系统隔离:Linux 结合了 Sandlock/Landlock/seccomp 和 FUSE 文件系统 (DeltaFS),macOS 使用带有 APFS 克隆和 FSEvents 的 Seatbelt,Windows 使用带有 WinFsp 文件系统路由的进程安全 (MXC)。会话是持久的但无需服务——不需要全局守护进程。它支持三种文件系统模式:

  • cbcow-through (默认):更改立即出现,提交是一个 O(1) 的接受步骤。
  • cbcow-private: 在私有的写时复制树上运行相同的引擎;只有被触及的路径会在提交时发布。
  • copy-private: 带有私有工作树的兼容性回退。

命令在会话内运行,您可以在提交或中止之前进行 diff。线性检查点链支持回滚。策略可以限制文件系统访问、网络目标和资源限制。该工具通过插件与 Pi 编码代理和 DeepSeek Harness 集成,并提供命令行界面以及原生 Node API。

适用人群

使用 AI 编码代理并希望在项目内安全运行代理命令的开发人员和团队。它专为希望精确审查代理更改内容并有选择地保留或丢弃这些更改的用户而设计,特别是在基于终端的工作流中。无论是普通用户还是高级用户,都可以从用于一次性事务的简单 run 命令以及用于多步工作的更强大的持久会话模式中受益。

亮点

  • 每个操作系统的原生隔离(无需容器)
  • 带有自动助手的无服务持久会话
  • 三种文件系统模式:cbcow-through, cbcow-private, copy-private
  • 带有二进制和大文件标记的统一 diff/commit/abort
  • 针对任务或工具适配器的审查范围保存点
  • 用于 Pi 和其他代理的可选 JSON-RPC 适配器协议
  • 策略优先设计:拒绝秘密路径、网络允许/审计、可写限制
  • 通过 npm、Homebrew、安装脚本或预构建二进制文件安装

相关

  • 项目
  • 项目
  • 项目
  • 项目