NewPipe SAF 存储访问框架常见问题 - DocumentsUI 缺失、路径不可访问
SAF 是什么
Storage Access Framework（SAF）是 Android 4.4+ 引入的文件访问框架。NewPipe 使用 SAF 来选择下载存储目录和管理文件。SAF 与老式的直接文件系统访问（File API）不同，它通过系统文件选择器让用户主动授权访问某个目录。
问题一：选择下载目录时文件选择器不弹
原因可能是系统缺少 DocumentsUI：
DocumentsUI（包名 com.android.documentsui）是负责弹出系统文件选择器的系统组件。某些精简 ROM 移除了它，或某些设备上它被禁用了。
解决方法：
- 在设置 → 应用 → 所有应用 里搜"文件""DocumentsUI""Storage Access"相关应用
- 如果找到了但被禁用，启用它
- 如果完全找不到，从 F-Droid 安装一个替代文件管理器（如 Simple File Manager、Material Files），替代应用也提供 SAF 兼容的文件选择功能
问题二：路径显示"不可访问"
如果设置里的下载存储目录旁边显示红色的"不可访问"提示：
- 之前授权的目录被删除了
- SD 卡被拔出了
- SAF 的授权 token 过期了（罕见但会发生）
解决方法：点击更改按钮，重新选一个目录即可。
问题三：Android 11+ Scoped Storage 限制
Android 11 引入的 Scoped Storage 对存储访问做了更严格的限制。NewPipe 在 Android 11+ 上的下载路径需要特别注意：
- 内部存储的公共目录（如
/Download/NewPipe/）可以正常使用 - 不要把下载目录设在 Android 沙箱以外的位置（如
/data/media/0/直接子目录） - 推荐把目录设在
/内部存储/Download/NewPipe/或/内部存储/视频/NewPipe/
问题四：多用户账户
Android 支持多用户账户。如果切换了账户：
- SAF 授权是按用户隔离的
- 下载目录在新账户下可能不可访问
- 解决：在每个账户下分别设置自己的下载目录
总结
SAF 问题 90% 的情况可以通过"重新选择下载目录"来解决。如果重新选择后仍然不行，大概率是 ROM 缺少 DocumentsUI 组件，安装一个文件管理器替代即可。