Alist挂载阿里云盘OpenAPI时的目录显示问题解析

问题背景

在使用Alist挂载阿里云盘OpenAPI时，许多用户遇到了无法在根目录下同时显示资源库和备份盘内容的问题。这是由于阿里云盘6.0版本更新后，虽然用户界面将资源库和备份盘合并显示，但其OpenAPI仍然保持了原有的区分机制。

技术原理分析

阿里云盘的API设计保留了两种不同的存储空间类型：

1. 资源库：对应云盘的非备份文件内容
2. 备份盘：对应云盘的备份文件

这种设计在API层面是固定的，即使客户端界面已经合并显示，底层API仍然需要明确指定访问哪种类型的存储空间。

解决方案详解

1. 通过Alist配置调整

在Alist v3.25.1及以上版本中，添加阿里云盘驱动时可以进行以下设置：

• 默认类型：

  • 有达人等级用户：默认展示非备份文件内容
  • 无达人等级用户：默认展示备份文件内容

• 资源库：仅显示非备份文件内容

• 备份盘：仅显示备份文件内容

操作步骤：

1. 在Alist管理界面选择"资源库"类型
2. 保存设置后返回网盘页面
3. 点击右下角选项，选择顶部刷新按钮

2. 获取Refresh Token时的注意事项

在手机扫码获取Refresh Token时，有一个关键步骤：

• 在授权界面取消勾选"备份盘"选项
• 这样获取的Token将默认访问资源库内容

3. 文件管理建议

根据实际需求选择文件存放位置：

• 常规文件：存放在资源库（即非备份文件夹）
• 需要备份的文件：存放在备份文件夹

常见误区澄清

1. 关于根目录显示：API设计决定了无法在一个视图中同时显示资源库和备份盘内容，这不是Alist的限制，而是阿里云盘API的固有特性。

2. 缓存问题：修改云盘类型后，务必进行完整刷新，否则可能看到的是之前的缓存内容。

3. 备份文件夹：这是系统自动生成的，用户无法删除，但可以选择不使用它。

最佳实践建议

1. 对于影视资源等常规文件，建议存放在资源库中
2. 使用Alist时明确设置需要的存储类型
3. 获取Token时注意授权范围
4. 修改设置后确保完全刷新页面

通过以上方法，用户可以有效地管理阿里云盘中的文件，并根据需要访问不同存储区域的内容。理解阿里云盘API的这种设计特点，有助于更合理地规划文件存储位置和使用方式。