Skip to main content
VFS 沙箱完全在本地运行,使用内存中的虚拟文件系统。无需云服务、Docker 或外部依赖——非常适合开发和测试。 它使用 node-vfs-polyfill,该 polyfill 实现了即将推出的 Node.js VFS 功能 (nodejs/node#61478)。

设置

无需身份验证。

与 deepagents 一起使用

独立使用

配置

工作原理

VFS 采用混合方法以实现最大兼容性:
  1. 文件存储:文件使用虚拟文件系统存储在内存中
  2. 命令执行:执行命令时,文件同步到临时目录,命令运行,然后更改同步回 VFS
  3. 回退模式:如果 node-vfs-polyfill 不可用,则回退到使用临时目录进行存储和执行
这提供了内存存储的好处(隔离、速度),同时保持完整的 shell 命令执行支持。

文件操作

工厂函数

错误处理

错误代码

何时使用 VFS

最适合:
  • 本地开发和测试
  • 没有 Docker 的 CI/CD 流水线
  • 无需云设置的快速原型设计
  • 外部服务不可用的环境
不太适合:
  • 需要真正容器隔离的生产工作负载
  • 跨会话的持久存储
  • 重计算任务(无资源限制)

未来:原生 Node.js VFS

此包使用 node-vfs-polyfill,该 polyfill 实现了正在 nodejs/node#61478 中开发的即将推出的 Node.js VFS 功能。当官方的 node:vfs 模块在 Node.js 中发布时,此包将更新为使用原生实现。