TTS-Backup：你的桌游模拟器数据终极保护方案

TTS-Backup：你的桌游模拟器数据终极保护方案

【免费下载链接】tts-backupBackup Tabletop Simulator saves and assets into comprehensive Zip files.项目地址: https://gitcode.com/gh_mirrors/tt/tts-backup

你是否曾经花费数小时精心设计的Tabletop Simulator模组，因为一次系统崩溃或误操作而消失无踪？当心爱的桌游数据突然丢失，那种无力感和挫败感令人心痛。TTS-Backup正是为桌游爱好者量身打造的专业备份解决方案，它能智能识别并打包Tabletop Simulator的JSON保存文件及其所有相关资源，创建完整的Zip备份档案，确保你的数字创作永远安全可靠。

为什么你的桌游数据需要专业保护？🔒

Tabletop Simulator作为数字桌游平台，承载着玩家的创意与回忆。然而，数据丢失的风险无处不在：

常见数据风险场景：

• 🖥️系统故障：Windows/Mac/Linux系统意外重启或崩溃
• 💾硬盘损坏：物理损坏或逻辑错误导致文件丢失
• 🗑️误删除：不小心删除关键模组文件
• 🔄软件冲突：TTS更新导致兼容性问题
• 🌐网络依赖：在线资源链接失效导致模组损坏

TTS-Backup的独特价值在于：它不仅备份JSON格式的保存文件，还能智能分析文件内容，找出所有引用的本地缓存资源——包括图片、3D模型、音频文件等，将它们完整打包到一个Zip文件中，实现真正的一键全量备份。

核心功能对比：TTS-Backup vs 传统备份方式

功能特性	TTS-Backup	手动复制	云同步工具
智能资源识别	✅ 自动分析JSON，找出所有关联资源	❌ 只能复制可见文件	❌ 仅同步指定目录
完整性验证	✅ 检查文件完整性，提示缺失资源	❌ 无法验证文件关联性	❌ 可能遗漏隐藏文件
跨平台支持	✅ Windows/Mac/Linux全支持	✅ 所有平台	✅ 所有平台
资源预取功能	✅ 可下载在线资源到本地缓存	❌ 无法处理在线资源	❌ 依赖网络链接
压缩打包	✅ 自动压缩为Zip格式	❌ 需要额外压缩步骤	❌ 通常不压缩
备份描述	✅ 支持添加备份注释	❌ 无注释功能	⚠️ 有限注释功能

三步快速上手：从零开始保护你的桌游数据 🚀

第一步：环境准备与安装

确保你的系统已安装Python 3.3或更高版本，然后执行以下简单命令：

# 克隆项目到本地 git clone https://gitcode.com/gh_mirrors/tt/tts-backup # 进入项目目录 cd tts-backup # 安装项目依赖 pip install .

安装完成后，系统会自动注册四个命令行工具：

• tts-backup- 主备份工具（命令行版）
• tts-backup-gui- 图形界面备份工具
• tts-prefetch- 资源预取工具（命令行版）
• tts-prefetch-gui- 图形界面预取工具

第二步：选择适合你的操作方式

图形界面（推荐新手使用）

# 启动图形界面备份工具 tts-backup-gui # 或直接运行Python脚本 python src/tts_tools/backup/gui.py

图形界面提供直观的操作体验，无需记忆复杂命令，适合偶尔备份或偏好可视化操作的用户。

命令行界面（适合高级用户）

# 基本备份命令 tts-backup my_game_save.json # 或直接运行Python脚本 python src/tts_tools/backup/cli.py my_game_save.json

命令行界面更加灵活高效，支持脚本自动化，适合批量处理或定期备份需求。

第三步：执行第一次完整备份

假设你有一个名为fantasy_rpg_mod.json的模组文件：

# 基本备份（使用默认设置） tts-backup fantasy_rpg_mod.json # 指定输出文件名 tts-backup fantasy_rpg_mod.json -o "fantasy_rpg_backup_2024.zip" # 添加备份描述信息 tts-backup fantasy_rpg_mod.json -c "龙与地下城模组 - 版本2.1.4" # 预览备份内容而不实际执行 tts-backup fantasy_rpg_mod.json --dry-run # 忽略缺失文件继续备份 tts-backup fantasy_rpg_mod.json --ignore-missing

备份完成后，你将获得一个包含所有资源的完整Zip文件，即使原始文件丢失，也能从这个备份中完全恢复你的模组。

双模式操作：备份与预取的完美组合 📦

备份模式：数据保护的核心

备份模式是TTS-Backup的核心功能，它能：

1. 深度解析JSON结构：智能识别所有资源引用路径
2. 收集本地缓存文件：自动查找图片、模型、音频等资源
3. 完整性检查：验证所有文件是否存在且可访问
4. 智能打包：将所有文件压缩为单一Zip档案

# 备份多个文件 tts-backup save1.json save2.json save3.json # 指定TTS游戏数据目录（非默认位置时使用） tts-backup my_mod.json --gamedata "D:/Games/Tabletop Simulator/Data"

预取模式：确保资源的完整性

预取模式专门用于下载JSON文件中引用的在线资源到本地缓存：

# 预取单个模组的所有在线资源 tts-prefetch online_mod.json # 强制重新下载已有资源 tts-prefetch updated_mod.json --refetch # 设置下载超时时间（秒） tts-prefetch large_mod.json --timeout 60 # 预取多个文件 tts-prefetch mod1.json mod2.json mod3.json

预取模式特别适用于以下场景：

• 准备将模组分享给朋友
• 确保离线环境下模组可用
• 更新模组前备份所有资源
• 迁移到新电脑前收集所有文件

实用场景：不同用户的数据保护策略 🎮

场景一：模组开发者的版本管理

作为模组开发者，你需要系统化的版本控制和工作流程：

#!/bin/bash # 开发工作流自动化脚本：dev_backup.sh # 开发过程中的里程碑备份 tts-backup my_mod.json -c "版本0.8 - 新增战斗系统" -o "dev_v0.8.zip" # 测试版本备份 tts-backup my_mod.json -c "测试版 - 多人联机功能" -o "test_multiplayer.zip" # 发布前最终备份 tts-backup my_mod.json -c "正式版1.0发布" -o "release_v1.0.zip" # 预取所有在线资源确保完整性 tts-prefetch my_mod.json --refetch

开发工作流最佳实践：

1. 功能分支备份：每个新功能开发完成后立即备份
2. 版本标签：使用描述性注释记录变更内容
3. 定期归档：每周归档一次开发进度
4. 云端同步：将备份文件同步到Git仓库或云存储

场景二：普通玩家的数据安全

对于普通玩家，建议采用分层备份策略：

日常使用层（高频备份）

• 频率：每次游戏会话后
• 内容：当前活跃模组
• 存储：本地硬盘快速访问
• 命令：tts-backup current_game.json -c "日常备份"

版本保护层（中频备份）

• 频率：每周一次
• 内容：所有收藏模组
• 存储：外部移动硬盘
• 命令：tts-backup *.json -o "weekly_backup.zip"

长期归档层（低频备份）

• 频率：每月或每季度
• 内容：精选模组合集
• 存储：云存储+物理介质
• 命令：tts-backup favorite_mods/*.json -c "季度归档"

场景三：团队协作与分享

团队协作开发时，确保资源一致性至关重要：

# 创建标准化资源包供团队使用 tts-prefetch team_mod.json --refetch --timeout 120 # 生成团队共享备份包 tts-backup team_mod.json -c "团队开发版本-2024-Q2" -o "team_shared_v2.zip" # 验证备份完整性（预览模式） tts-backup team_mod.json --dry-run # 批量处理多个模组 for mod in *.json; do tts-backup "$mod" -o "backups/${mod%.json}_backup.zip" done

高级功能与优化技巧 ⚙️

命令行参数详解

TTS-Backup提供了丰富的命令行参数，满足各种高级需求：

参数	功能说明	使用示例
--gamedata PATH	指定TTS游戏数据目录	tts-backup --gamedata "C:\TTS\Data" mod.json
--outname FILENAME,-o	自定义输出文件名	tts-backup -o "my_backup.zip" mod.json
--dry-run,-n	预览将要备份的文件	tts-backup --dry-run mod.json
--ignore-missing,-i	忽略缺失文件继续备份	tts-backup -i mod.json
--comment COMMENT,-c	添加备份描述信息	tts-backup -c "重要更新前备份" mod.json
--refetch,-r	强制重新下载已有资源（仅预取）	tts-prefetch -r mod.json
--timeout TIMEOUT,-t	设置下载超时时间（秒）	tts-prefetch -t 45 mod.json
--relax,-x	不因MIME类型不匹配而中止（仅预取）	tts-prefetch -x mod.json

自动化备份脚本示例

创建定期备份的自动化脚本，实现无人值守数据保护：

#!/bin/bash # 自动备份脚本：auto_backup_tts.sh # 配置参数 BACKUP_DIR="$HOME/TTS_Backups" TTS_DATA_DIR="$HOME/Documents/My Games/Tabletop Simulator" LOG_FILE="$BACKUP_DIR/backup_log.txt" # 创建备份目录 mkdir -p "$BACKUP_DIR" # 生成时间戳 TIMESTAMP=$(date +"%Y%m%d_%H%M%S") # 记录开始时间 echo "=== 备份开始: $(date) ===" >> "$LOG_FILE" # 备份所有JSON文件 for json_file in "$TTS_DATA_DIR"/*.json; do if [ -f "$json_file" ]; then filename=$(basename "$json_file" .json) echo "正在备份: $filename" >> "$LOG_FILE" # 执行备份 tts-backup "$json_file" \ -o "$BACKUP_DIR/${filename}_${TIMESTAMP}.zip" \ -c "自动备份 - $TIMESTAMP" if [ $? -eq 0 ]; then echo "✓ $filename 备份成功" >> "$LOG_FILE" else echo "✗ $filename 备份失败" >> "$LOG_FILE" fi fi done # 清理旧备份（保留最近30天） find "$BACKUP_DIR" -name "*.zip" -mtime +30 -delete >> "$LOG_FILE" 2>&1 echo "=== 备份完成: $(date) ===" >> "$LOG_FILE" echo "" >> "$LOG_FILE"

设置定时任务（Linux/Mac）：

# 每天凌晨2点自动执行备份 0 2 * * * /path/to/auto_backup_tts.sh

Windows任务计划程序：

1. 打开"任务计划程序"
2. 创建基本任务
3. 设置每日触发时间
4. 选择"启动程序"
5. 指定脚本路径

常见问题与解决方案 🛠️

问题1：备份时提示"File not found"错误

症状：运行tts-backup时显示文件缺失警告

原因分析：

• 资源文件尚未被TTS缓存到本地
• 文件路径配置不正确
• 模组使用了袋子（bags）功能，资源未解包

解决方案：

# 方案A：使用预取功能下载缺失资源 tts-prefetch your_mod.json # 方案B：忽略缺失文件继续备份（保留现有文件） tts-backup your_mod.json --ignore-missing # 方案C：在TTS中手动解包所有袋子资源 # 1. 进入TTS游戏 # 2. 从袋子中取出所有物品 # 3. 等待资源缓存完成 # 4. 重新执行备份

问题2：备份文件体积异常庞大

可能原因：

• 包含了重复的资源文件
• 模组引用了大量高分辨率资源
• 缓存目录包含不必要的临时文件

优化建议：

1. 清理TTS缓存：定期清理Mods/目录下的临时文件
2. 使用预览模式：先查看备份内容tts-backup --dry-run mod.json
3. 分卷备份：对于超大模组，考虑按功能模块分开备份
4. 资源优化：在TTS中优化图片和模型资源的分辨率

问题3：跨平台兼容性问题

解决方案：

# 检查Python版本 python --version # 确认TTS数据目录位置 # Windows: ~/Documents/My Games/Tabletop Simulator # MacOS: ~/Library/Tabletop Simulator # Linux: ~/.local/share/Tabletop Simulator # 手动指定数据目录 tts-backup --gamedata "/path/to/your/tts/data" mod.json

问题4：图形界面无法启动

排查步骤：

1. 确认Python环境：python --version确保版本≥3.3
2. 检查依赖安装：重新运行pip install .
3. 测试命令行版本：tts-backup --help确认功能正常
4. 检查系统权限：确保有足够的文件访问权限
5. 查看错误日志：运行python src/tts_tools/backup/gui.py查看详细错误

最佳实践与专业建议 💡

数据保护金字塔策略

建立多层次的数据保护体系，确保万无一失：

┌─────────────────┐ │ 云端归档层 │ ← 季度/年度备份 │ (Google Drive, │ │ Dropbox, Git) │ └─────────────────┘ ↑ ┌─────────────────┐ │ 外部存储层 │ ← 月度/重要版本 │ (移动硬盘、NAS) │ └─────────────────┘ ↑ ┌─────────────────┐ │ 本地备份层 │ ← 每周/日常使用 │ (SSD/HDD备份) │ └─────────────────┘ ↑ ┌─────────────────┐ │ 工作副本层 │ ← 实时编辑 │ (TTS原始文件) │ └─────────────────┘

性能优化技巧

备份速度优化：

1. 使用SSD存储：将备份目标目录设置在SSD上
2. 关闭无关程序：备份时关闭其他占用资源的应用
3. 选择合适时段：在系统空闲时执行大型备份
4. 分批处理：对大量模组分批次备份

存储空间管理：

1. 定期清理：设置自动清理30天前的旧备份
2. 增量备份：只备份自上次以来修改过的文件
3. 压缩优化：使用高效的压缩算法
4. 去重处理：识别并移除重复资源

工作流程整合：

1. 版本控制集成：将备份整合到Git工作流中
2. 自动化测试：备份后自动验证文件完整性
3. 通知机制：设置备份完成邮件/消息通知
4. 文档记录：维护备份日志和恢复指南

安全注意事项

⚠️重要安全提醒：

1. 多地点存储：不要将所有备份放在同一物理位置
2. 定期验证：每季度测试一次备份文件的恢复功能
3. 加密敏感数据：对包含个人信息的备份进行加密
4. 访问控制：限制备份文件的访问权限
5. 版本追踪：维护详细的备份版本历史

项目架构与技术亮点 🏗️

模块化设计结构

TTS-Backup采用清晰的模块化架构，便于维护和扩展：

src/tts_tools/ ├── backup/ # 备份功能核心模块 │ ├── __init__.py # 模块初始化 │ ├── cli.py # 命令行接口 │ └── gui.py # 图形界面接口 ├── prefetch/ # 资源预取模块 │ ├── __init__.py # 模块初始化 │ ├── cli.py # 命令行接口 │ └── gui.py # 图形界面接口 ├── libgui/ # GUI共享库 │ ├── __init__.py # 模块初始化 │ ├── entry.py # GUI入口点 │ └── frame.py # 界面框架 ├── __init__.py # 包初始化 ├── libtts.py # 核心功能库 └── util.py # 工具函数

技术特点与优势

1. 智能解析引擎：深度分析JSON结构，准确识别各种资源引用模式
2. 跨平台兼容：自动适配Windows、macOS、Linux系统的不同路径
3. 容错机制完善：完善的错误处理和恢复机制，避免单点故障
4. 资源占用极低：Python实现，运行效率高，内存占用小
5. 扩展性强：模块化设计便于功能扩展和定制开发

核心算法原理

TTS-Backup的核心算法基于递归遍历和模式匹配：

# 简化版资源识别算法（基于src/tts_tools/libtts.py） def seekURL(dic, trail=[]): """递归搜索JSON结构，找出所有URL引用""" for key, value in dic.items(): if isinstance(value, dict): # 递归处理嵌套字典 yield from seekURL(value, trail + [key]) elif isinstance(value, list): # 处理列表中的项 for item in value: if isinstance(item, dict): yield from seekURL(item, trail + [key]) elif key in ["CustomPDF", "CustomAssetbundle", "CustomMesh"]: # 识别特定资源类型 if value and isinstance(value, str): yield (trail + [key], value)

从入门到精通：三层学习路径 📚

第一层：基础用户（快速上手）

• ✅ 掌握基本备份命令
• ✅ 了解图形界面操作
• ✅ 建立定期备份习惯
• ✅ 使用预取功能确保资源完整

第二层：进阶用户（效率提升）

• ✅ 熟练使用命令行参数
• ✅ 编写简单自动化脚本
• ✅ 理解备份策略设计
• ✅ 掌握问题排查技巧

第三层：专家用户（深度定制）

• ✅ 深入理解源码架构
• ✅ 定制化开发扩展功能
• ✅ 贡献代码到开源社区
• ✅ 设计企业级备份方案

总结：为你的数字桌游世界加上多重保险 🔒

TTS-Backup不仅仅是一个备份工具，它是你Tabletop Simulator创作生涯的守护者。通过本文的全面指导，你已经掌握了：

✅快速安装配置- 几分钟内搭建完整备份环境
✅双模式操作- 图形界面与命令行随心切换
✅实用场景策略- 针对不同需求的个性化方案
✅问题解决能力- 应对各种备份挑战
✅高级优化技巧- 提升效率与安全性

数据安全的核心原则：重要的不是备份本身，而是能够成功恢复。TTS-Backup通过完整的资源打包和智能验证机制，确保你的每一次备份都是真正可用的安全网。

立即行动建议：

1. 选择关键模组：找出你最珍视的3个模组
2. 执行首次备份：体验完整的备份流程
3. 测试恢复功能：验证备份文件的可恢复性
4. 建立定期习惯：设置每周自动备份

记住，最好的备份策略是那个你真正会执行的策略。从今天开始，用TTS-Backup为你的桌游模拟器数据建立坚固的防御体系，让创意无忧，让回忆永存！

开源贡献：TTS-Backup是一个开源项目，欢迎开发者参与改进。如果你有功能建议或发现了bug，请访问项目仓库提交issue或pull request，共同打造更好的桌游数据保护工具。

【免费下载链接】tts-backupBackup Tabletop Simulator saves and assets into comprehensive Zip files.项目地址: https://gitcode.com/gh_mirrors/tt/tts-backup