OpenDAL 新增功能：列出未永久删除的已删除对象

在对象存储系统中，对象删除操作往往不是立即永久删除，而是会保留一段时间以便恢复。OpenDAL 项目近期正在讨论一个重要的功能增强：如何有效地列出这些已被标记删除但尚未永久移除的对象。

背景与需求

现代对象存储服务如 S3 提供了版本控制功能，当启用版本控制时，简单的 DELETE 操作并不会真正删除对象，而是插入一个删除标记(delete marker)作为当前版本。这意味着用户仍然可以通过指定版本号来恢复被删除的对象。

类似地，Azure Blob 存储提供了软删除(Soft Delete)功能，即使在不启用版本控制的情况下，也能保留已删除的对象一段时间。这些特性为数据恢复提供了保障，但也带来了管理上的复杂性。

当前实现与局限

目前 OpenDAL 的 List 操作可以列出活跃对象，通过 version(true) 参数可以列出包括非当前版本在内的所有对象版本。然而，在 S3 的实现中发现一个问题：当执行简单 DELETE 时产生的删除标记(delete marker)并不会出现在返回结果中，因为这些标记被放在单独的 DeleteMarker 容器中，而非 Version 容器。

功能设计方案

经过社区讨论，决定将列出已删除对象的功能设计为一个正交于版本列表的功能。这意味着用户可以灵活组合不同的参数来获取所需的对象列表：

1. 仅列出活跃文件：list_with(path)
2. 列出活跃文件及非当前版本：list_with(path).version(true)
3. 列出活跃文件及已删除文件：list_with(path).deleted(true)
4. 列出所有文件(活跃、非当前版本、已删除)：list_with(path).version(true).deleted(true)

这种设计不仅解决了 S3 版本控制场景下的需求，也能兼容其他存储服务如 Azure Blob 的软删除特性，为不同后端提供一致的接口体验。

技术实现考量

在实际实现中需要考虑以下几点：

1. 不同存储后端的差异处理：S3 使用删除标记，Azure 使用软删除，需要统一抽象
2. 性能影响：列出更多对象可能增加请求延迟和带宽消耗
3. 权限控制：确保用户有足够的权限访问已删除对象
4. 结果过滤：如何高效地从大量结果中筛选出用户真正需要的对象

总结

OpenDAL 新增的列出已删除对象功能将大大增强数据恢复和管理能力。通过正交的参数设计，既保持了接口的简洁性，又提供了足够的灵活性来满足不同场景下的需求。这一改进将使 OpenDAL 在各种对象存储服务上的行为更加一致和可预测，为开发者提供更强大的数据管理工具。