fs-safe

fs-safe 是一个为 Node.js 提供竞态安全、根目录受限的文件系统操作抽象的 TypeScript 库。它通过 capability-style 的 root 句柄，确保所有文件操作（读、写、创建、遍历等）严格限定在指定可信根目录内，抵御路径遍历（包括 ../、符号链接、硬链接别名）及 TOCTOU 重命名竞态攻击。核心基于运行时路径解析与 inode 级校验，支持原子写入、安全归档解压、子路径作用域等扩展能力。适用于需处理用户输入路径的服务端应用，如文件托管服务、CI/CD 工作区管理、插件沙箱、静态站点生成器等对路径安全性要求严格的场景。