04 Data Backup

4. 备份脚本使用说明

SillyDroid 提供 scripts/export-tavern-data.sh 脚本，一键导出 Termux 中安装的 SillyTavern 数据为 ZIP 压缩包，用于迁移到 SillyDroid。

---

脚本位置

scripts/export-tavern-data.sh

项目源码根目录的 scripts/ 文件夹下。

---

使用前提

• 在 Termux 环境中运行（自动检测，非 Termux 环境会终止）
• SillyTavern 已安装在 Termux 中（默认检测 ~/SillyTavern 或 ~/sillytavern）
• 需要 zip 命令（脚本会自动调用 pkg install zip 安装）

---

一键导出

# 在 Termux 中执行
bash export-tavern-data.sh

脚本会自动：

1. 检测 Termux 环境
2. 找到 SillyTavern 安装目录
3. 拷贝 config、data、plugins、public/extensions 四个目录
4. 打包为 sillytavern-termux-backup-YYYYMMDD-HHMMSS.zip
5. 输出文件保存路径

---

指定参数

# 指定输出目录
bash export-tavern-data.sh --output-dir ~/storage/shared/Download

# 指定 SillyTavern 安装路径
bash export-tavern-data.sh --install-root ~/custom-tavern-path

# 同时指定
bash export-tavern-data.sh --install-root ~/SillyTavern --output-dir ~/storage/downloads

参数	说明
--output-dir	ZIP 输出目录，默认尝试 Download 文件夹
--install-root	SillyTavern 安装路径，默认自动检测

---

导出后导入 SillyDroid

1. 将 ZIP 文件从 Termux 传输到手机存储（可通过 ~/storage/shared/ 共享）
2. 打开 SillyDroid → 设置 → 数据 Tab
3. 点击 「导入数据压缩包」
4. 选择导出的 ZIP 文件即可

导入前会弹出覆盖确认，不会直接覆盖现有数据。

---

导出内容说明

目录	内容
config/	配置文件（config.yaml, settings 等）
data/	用户数据（聊天记录、角色、世界书等）
plugins/	插件数据
public/scripts/extensions/	第三方扩展

导出的 ZIP 可直接被 SillyDroid 的「导入数据压缩包」识别。