Unstorage v1.15.0 版本发布：增强键遍历与性能优化

Unstorage 是一个通用的键值存储抽象层，它为开发者提供了统一的 API 来操作各种后端存储系统。通过 Unstorage，开发者可以轻松地在内存、文件系统、Redis、CDN KV 等不同存储方案之间切换，而无需重写业务逻辑。

键遍历深度控制

本次 v1.15.0 版本最重要的增强之一是引入了 maxDepth 参数支持。这个功能特别适用于需要分层存储数据的场景，比如文件系统驱动。

在文件系统存储中，目录结构天然具有层级关系。以前，当调用 getKeys() 方法获取所有键时，会递归遍历所有子目录，这在某些情况下会导致性能问题。现在，开发者可以通过 maxDepth 参数精确控制遍历的深度：

// 只获取第一层级的键
const topLevelKeys = await storage.getKeys({ maxDepth: 1 })

// 获取两级深度的键
const twoLevelKeys = await storage.getKeys({ maxDepth: 2 })

值得注意的是，文件系统驱动（fs 和 fs-lite）已经原生支持这一特性，这意味着在这些驱动上使用 maxDepth 时可以获得最佳性能。

驱动标志系统

另一个重要改进是新增了 flags 键到驱动接口中。这是一个元数据系统，允许驱动声明其支持的特性。例如，驱动可以通过设置 flags.nativeMaxDepth 为 true 来表明它原生支持 maxDepth 参数。

这种设计使得 Unstorage 能够智能地选择最优的实现路径。当检测到驱动原生支持某个特性时，框架会直接使用驱动提供的实现，否则会使用兼容层来处理。

性能优化

性能方面，本次更新做了两处重要改进：

1. 当驱动原生支持 maxDepth 时，跳过额外的过滤步骤，直接使用驱动提供的实现，减少了不必要的计算开销。

2. 升级了文件系统监视依赖 chokidar 到 v4 版本，这带来了更好的性能和更少的内存占用。

其他改进

• 修复了 prefixStorage 包装器中快捷别名方法的问题，确保所有方法都能正确工作
• 改进了文件系统驱动的选项处理逻辑，使其更加健壮
• 测试套件现在会在每个测试后自动清理存储状态，避免了测试间的相互干扰

总结

Unstorage v1.15.0 通过引入键遍历深度控制和驱动标志系统，为开发者提供了更精细的控制能力和更好的性能。特别是对于需要处理大量分层数据的应用场景，这些改进可以显著提升效率。文件系统驱动的原生深度支持和 chokidar 的升级也进一步巩固了 Unstorage 作为存储抽象层的可靠性。