Spotube 数据缓存与存储位置——哪些数据在本地、哪些会上传

总览表

Spotube 的数据分两类：纯本地和可能上传到外部服务（仅当你主动开启）。

纯本地（永远不会离开你的设备）

可能上传到外部服务（主动开启才会）

Spotube 自身不做任何遥测上传——没有崩溃报告、没有使用统计、没有分析。

各平台路径

Windows

Spotube 数据目录：    %APPDATA%\Spotube\
  ├── preferences        # shared_preferences
  ├── spotube.db         # SQLite 数据库（播放列表、收藏）
  ├── plugins\           # 插件目录
  ├── cache\             # 临时缓存（自动清理）
  └── logs\              # debug log（手动导出）

Spotube 下载目录（默认）：%USERPROFILE%\Music\Spotube Downloads\

macOS

Spotube 数据目录：    ~/Library/Application Support/Spotube/
  ├── preferences
  ├── spotube.db
  ├── plugins/
  ├── cache/
  └── logs/

Spotube 下载目录（默认）：~/Music/Spotube Downloads/

Linux

Spotube 数据目录：    ~/.local/share/spotube/
  ├── preferences
  ├── spotube.db
  ├── plugins/
  ├── cache/
  └── logs/

Spotube 下载目录（默认）：~/Music/Spotube Downloads/

Flatpak（Linux）

Flatpak 沙箱隔离：

Spotube 数据目录：    ~/.var/app/com.github.KRTirtho.Spotube/data/spotube/
Spotube 配置目录：    ~/.var/app/com.github.KRTirtho.Spotube/config/spotube/

Flatpak 默认只能访问 ~/Music、~/Downloads、~/Documents。如果想让 Spotube 扫描其他目录，需要在 Flatpak Override 里放开。

Android

Spotube 数据目录：    /data/data/oss.krtirtho.spotube/
  ├── files/
  │   ├── plugins/
  │   └── downloads/
  ├── databases/spotube.db
  └── cache/

Android 11+ 的 Scoped Storage 限制下，Spotube 可以访问 ~/Music/Spotube Downloads/（系统音乐目录）。

iOS

Spotube 数据目录：    /var/mobile/Containers/Data/Application/<UUID>/Documents/
  ├── plugins/
  ├── downloads/
  └── spotube.db

iOS 沙箱隔离，Spotube 只能访问自己的容器目录。下载的曲目可以在"文件"App → "Spotube" 文件夹里看到和导出。

清理缓存 vs 清空数据

Spotube 设置 → Data Management 有两个按钮：

建议只清缓存，清空数据是"出厂重置"级别的操作。

备份建议

只备份播放列表和收藏

Spotube 没有内置"备份 / 恢复"功能。手动备份：

1. 关掉 Spotube（防止数据库写入中拷贝）
2. 复制 spotube.db 文件到备份位置
3. 复制 preferences 文件（可选，保留主题设置）

恢复：新设备装 Spotube → 关掉 → 把备份文件拷回原位置 → 启动。

全量备份

如果你本地有大量下载的曲目，同时备份下载目录即可。

OAuth token 存储安全

Spotube 用 flutter_secure_storage 包存储 OAuth token：

token 在磁盘上加密存储，明文不会出现在 spotube.db 里。Spotube 进程运行时在内存里解密，退出后即清除。