如何用TTS-Backup实现桌面模拟器存档一键备份？Tabletop玩家必备的2款免费工具

项目简介 🎮

TTS-Backup和TTS-Prefetch是专为Tabletop Simulator（桌面模拟器）设计的免费开源工具组合，能够帮助玩家轻松备份游戏存档、模组资产，并自动预下载所需资源。通过将本地缓存的图像、模型等文件打包成Zip格式，彻底解决存档丢失、资产加载失败等痛点，让桌游模拟体验更流畅！

为什么需要这两款工具？ 🤔

核心功能对比表

工具名称	主要功能	适用场景	技术亮点
TTS-Backup	存档/模组一键打包备份	防止数据丢失、设备迁移	JSON解析+Zip压缩技术
TTS-Prefetch	自动下载存档所需资产到本地缓存	提前加载模组资源、修复卡顿	多线程资源抓取+断点续传

痛点解决示意图

（假设项目包含操作流程图，此处使用占位描述）
下图展示传统手动备份与工具自动备份的效率对比：
桌面模拟器备份效率对比示意图
（alt文本：Tabletop Simulator存档备份工具效率对比）

快速上手指南 ⚡

1️⃣ 环境准备

• 运行环境：Python 3.3+
• 安装方式：

  git clone https://gitcode.com/gh_mirrors/tt/tts-backup
  cd tts-backup
  pip install .  # 自动安装依赖
  

2️⃣ TTS-Backup使用步骤

1. 基础命令备份

   tts-backup --input "C:/Users/用户名/Documents/My Games/Tabletop Simulator/Saves" --output ./backups
   

   （备份路径可通过src/tts_tools/backup/cli.py自定义配置）

2. GUI图形界面操作
   运行可视化工具：

   tts-backup-gui
   

   在弹出窗口中：

   • 选择存档文件夹
   • 勾选需要备份的资产类型（图像/模型/PDF）
   • 点击【开始备份】生成Zip文件

3️⃣ TTS-Prefetch预加载技巧

• 批量预下载命令

  tts-prefetch --file "MyAwesomeGame.json" --refetch  # 强制刷新过期资源
  

• 核心参数说明（来自src/tts_tools/prefetch/__init__.py）：
  • --dry-run：模拟下载不实际保存
  • --timeout 10：设置网络超时时间
  • --user-agent "CustomAgent"：自定义请求头

技术原理简析 🔍

资源处理流程

1. TTS-Backup工作流

   graph LR
   A[读取JSON存档] --> B[解析资源URL]
   B --> C[筛选本地缓存文件]
   C --> D[生成Zip压缩包]
   

   （代码实现位于src/tts_tools/libtts.py的urls_from_save()函数）

2. Prefetch核心逻辑
   通过src/tts_tools/prefetch/__init__.py中的prefetch_file()函数实现：

   • 多线程并发下载（默认5线程）
   • MIME类型校验（过滤无效资源）
   • 断点续传（支持--refetch参数重新获取）

常见问题解决 ❓

Q：备份文件过大怎么办？

A：通过src/tts_tools/util.py中的strip_mime_parms()函数过滤非必要资源，或使用--exclude "*.mp4"参数排除大型视频文件。

Q：预下载时提示网络错误？

A：检查网络代理配置，或修改src/tts_tools/util.py中的user_agent参数模拟浏览器请求。

项目结构与扩展 🛠️

tts-backup/
├── src/tts_tools/
│   ├── backup/        # 备份功能核心代码
│   ├── prefetch/      # 资源预下载模块
│   ├── libgui/        # GUI界面组件（frame.py/entry.py）
│   └── libtts.py      # 核心解析库
└── test/              # 单元测试（test_libtts.py）

想开发自定义功能？可基于src/tts_tools/prefetch/__init__.py的prefetch_files()接口扩展！

总结与展望 🌟

TTS-Backup和TTS-Prefetch通过轻量化设计实现了桌面模拟器资源管理的自动化，尤其适合：

• 经常更换设备的玩家
• 模组创作者备份作品
• 网络不稳定环境下的离线游玩

未来版本计划支持：

• 云备份同步功能
• 资产冲突检测机制
• 多语言界面（目前仅支持英文）

提示：项目文档可参考README.rst，遇到问题可提交Issue到项目仓库！

---

本文所有工具源码基于MIT协议开源，详见项目根目录LICENSE文件。
Tabletop Simulator工具集封面图
（alt文本：Tabletop Simulator存档备份与资源预加载工具）