boxsh：受限 POSIX shell 与并发 JSON RPC 模式

在 AI 代理、构建系统或编排层等场景中，通常需要一个既能执行底层命令，又能提供严格资源控制和隔离的执行环境。传统的 shell 环境往往在安全隔离和可控性方面存在不足。boxsh 项目应运而生，它是一个受限的 POSIX shell，旨在成为可编程的执行底层。

核心内容

boxsh 基于 dash 0.5.12 构建，其核心特性是支持并发的 JSON 行 RPC 模式。这意味着外部程序可以通过简单的 JSON 协议与 boxsh 进行通信并驱动其执行命令。同时，boxsh 内置了 Linux 命名空间隔离机制，为执行环境提供了基础的沙箱能力。

该项目设计了几个关键的使用场景。首先是作为 AI 代理的命令沙箱，它可以为 AI 代理提供一个能够执行任意 shell 命令的工作环境，同时严格控制其可见和可修改的内容，例如仅挂载所需目录、阻止外发网络、隔离 PID 树。

其次是零成本目录分叉功能。该功能可以将任何目录覆盖为写时复制（Copy-on-Write）工作区。代理可以在其中自由读写，在会话结束时，系统会检查上层差异，从而决定提交或丢弃更改。这一过程无需依赖 git 索引，适用于任意目录。

此外，boxsh 支持会话检查点与分支。用户可以冻结当前会话的上层状态，并在其上叠加新的覆盖层，从而实现从同一点向不同方向分支执行，并比较结果。也可以将上层状态归档，以便长期存储。

在并行处理方面，boxsh 支持并行隔离工作者模式。多个工作者可以共享一个大型的只读基础（如 node_modules 目录树、Python venv、编译后的 sysroot），同时每个工作者拥有自己独立的可写上层，从而并发运行且互不干扰。

最后，该工具可用于部署或迁移演练。用户可以在覆盖层上运行诸如 make install、数据库迁移或软件包升级等操作，然后精确检查上层文件系统的变化，再决定是否将更改真正应用到基础系统中。

价值与影响

boxsh 通过将受限的 POSIX shell 能力与 JSON RPC 协议、Linux 命名空间隔离以及写时复制文件系统技术相结合，为需要可控、可隔离执行环境的场景提供了一个轻量级且灵活的解决方案。它降低了为 AI 代理等应用构建安全沙箱的复杂度，并在构建系统、持续集成和运维编排等领域展示了其简化工作流、提升安全性与可复现性的潜力。

---

来源：黑洞资源笔记