如何快速备份Tabletop Simulator数据？TTS-Backup终极工具教程 🚀

TTS-Backup是一款专为Tabletop Simulator玩家设计的开源备份工具，能够将游戏保存文件和模组资产自动打包成完整的Zip文件，轻松解决游戏数据丢失风险。本文将带你掌握这款工具的安装使用技巧，让你的桌游收藏安全无忧！

📌 为什么选择TTS-Backup？3大核心优势

对于Tabletop Simulator（简称TTS）玩家而言，精心收藏的桌游模组和自定义场景是无价之宝。TTS-Backup通过以下特性守护你的游戏资产：

✅ 完整备份：自动抓取本地缓存的图像、模型等所有关联资源
✅ 双界面支持：提供命令行（CLI）和图形界面（GUI）两种操作方式
✅ 轻量高效：纯Python编写，无需复杂配置即可快速运行

💡 适合人群：桌游设计师、重度TTS玩家、经常更换设备的用户

🔧 2分钟极速安装指南

系统要求

• Python 3.3+ 环境
• Windows/macOS/Linux全平台支持

安装步骤

方法1：源码安装（推荐开发者）

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/tt/tts-backup

# 进入项目目录
cd tts-backup

# 安装依赖
pip install -r requirements.txt

方法2：Windows二进制版（推荐普通用户）

直接下载预编译的exe文件，双击即可运行（需从项目发布页获取）

🚀 3种实用操作场景全解析

场景1：基础备份流程（GUI界面）

1. 启动图形界面

   python src/tts_tools/backup/gui.py
   

2. 在弹出窗口中选择游戏数据目录（通常位于Documents/My Games/Tabletop Simulator）
3. 点击"开始备份"按钮，工具将自动生成包含时间戳的Zip文件

场景2：定时自动备份（CLI命令）

# 每天凌晨2点执行备份
python src/tts_tools/backup/cli.py --gamedata ~/Documents/My\ Games/Tabletop\ Simulator --schedule daily

场景3：资产预加载加速

# 预下载模组所需的所有网络资源
python src/tts_tools/prefetch/cli.py --mod-id "12345" --output ./prefetch_cache

⚙️ 高级配置技巧

自定义备份规则

修改配置文件src/tts_tools/util.py中的DEFAULT_BACKUP_RULES字典，可：

• 排除临时文件
• 设置压缩级别
• 添加自定义文件过滤规则

日志查看与问题排查

所有操作记录保存在tts-backup.log文件中，可通过以下命令快速定位问题：

grep "ERROR" tts-backup.log

🛡️ 数据安全最佳实践

1. 定期测试恢复：每月从备份文件中提取部分内容验证完整性
2. 异地存储：将Zip备份同步至云盘或外部硬盘
3. 版本管理：使用--comment参数为备份添加描述

   python src/tts_tools/backup/cli.py --comment "更新了D&D模组后备份"
   

📚 扩展学习资源

• 核心功能模块：src/tts_tools/libtts.py
• 图形界面源码：src/tts_tools/libgui/
• 测试用例：test/tts_tools/test_libtts.py

提示：项目使用Nix包管理器维护依赖，高级用户可通过flake.nix文件构建开发环境

❓ 常见问题解答

Q：备份文件太大怎么办？
A：使用--compress-level 9参数开启最高压缩等级，或通过util.py配置排除缓存文件

Q：能否备份Steam创意工坊订阅的模组？
A：支持！工具会自动识别订阅内容并包含相关元数据

Q：macOS下提示权限不足？
A：在终端中执行chmod +x src/tts_tools/backup/cli.py赋予执行权限

通过TTS-Backup，让你的Tabletop Simulator收藏得到银行级别的安全保障！无论是分享模组给朋友，还是重装系统后快速恢复，这款工具都能成为你最可靠的桌游数据管家。现在就用git clone命令开启你的安全备份之旅吧！ 🌟