TauriTavern 的数据存储位置

本节内容由 Agent 以分析源码的方式辅助完成。

TauriTavern 有两种运行模式，数据目录的位置不同：

• 标准模式（默认安装包）：数据保存在操作系统的应用数据目录下。
• 便携模式：在程序所在目录放置 portable.flag 文件后启动（或设置环境变量 TAURITAVERN_RUNTIME_MODE=portable），数据保存在程序目录下的 data 文件夹。

各系统的默认存储位置与进入方法

• Windows
  • 默认位置：%APPDATA%\com.tauritavern.client\data（即 C:\Users\用户名\AppData\Roaming\com.tauritavern.client\data）
  • 进入方法：按下快捷键「win+R」，输入 %APPDATA%\com.tauritavern.client\data 后回车
• macOS
  • 默认位置：~/Library/Application Support/com.tauritavern.client/data
  • 进入方法：在访达中按下「Cmd+Shift+G」，输入上述路径后回车
• Linux
  • 默认位置：$XDG_DATA_HOME/com.tauritavern.client/data（未设置时通常为 ~/.local/share/com.tauritavern.client/data）
  • 进入方法：在文件管理器中按下「Ctrl+L」，输入上述路径后回车
• Android
  • 默认位置：应用外部数据目录 /storage/emulated/0/Android/data/com.tauritavern.client/ 下（位于 Android 应用私有区域，部分文件管理器需要开启“显示 Android/data 目录”才能看到）
  • 进入方法：无法从设置页直接查看或修改，只能通过应用内功能访问
• iOS
  • 默认位置：应用沙盒目录，用户无法直接访问
  • 进入方法：只能通过应用内功能访问，例如「数据迁移」的导出功能

%APPDATA% 会自动指向当前用户的 C:\Users\用户名\AppData\Roaming 目录。

如何确认当前实际位置

在桌面端打开「用户设置 → TauriTavern 设置 → 系统 → 数据目录」，可以查看当前实际使用的数据目录路径，并点击「选择」修改位置（修改时应用会把旧数据自动迁移到新位置）。如果你不确定自己使用的是哪种模式，以这里显示的路径为准。

详情请查看修改数据存储位置

数据目录同级的内容

在 data 文件夹旁边还有几个由程序管理的目录和文件：

• logs：Rust 后端日志目录，排查文件、网络或系统调用问题时用得上（也可以在设置页的「开发 → 后端日志」中查看）。
• .data-archive/imports 与 .data-archive/exports：「数据迁移」功能导入、导出归档包时的暂存位置。
• tauritavern-runtime.json：运行时配置文件，记录自定义的数据目录位置与迁移状态。一般不需要手动修改，删除后程序会回到默认数据目录。