游戏目录与备份范围
安装和排障时，最容易出错的是把“游戏文件、Mod 文件、用户数据、下载缓存”混在一起处理。本页按使用者可见的目录类型说明备份范围，不要求修改任何内部文件。
常见目录区域
不同版本的目录名称可能略有差异，但通常能看到以下几类内容：
| 区域 | 用途 | 建议 |
|---|---|---|
| 游戏根目录 | 主程序、启动脚本和全局配置 | 整体备份，避免只拷贝单个 DLL |
*_Data 数据目录 | 运行资源、版本资源和内容文件 | 不要手动删除未知子目录 |
Mods | 已安装的 Mod 文件 | 升级前单独备份，排障时可暂时移出新增文件 |
Plugins | 运行时插件 | 只使用管理员确认的版本 |
LocalAssets | 本地图片、视频、皮肤或自定义资源 | 按功能建立子目录并记录来源 |
UserData | 加载器、启动画面和用户侧配置 | 备份后再修改主题或启动项 |
UploadData | 待上传或处理中的用户数据 | 不要当作完整账号备份 |
Errorlog/日志目录 | 启动、加载和运行错误记录 | 排障时按时间选择相关文件 |
现场目录的细分判断
实际安装包中还可能看到固件、资源、启动器、设备信息和运行库等区域。它们的名称会随版本变化，处理时按用途判断，不要因为名字像普通文件夹就直接删除。
| 可见区域类别 | 可能包含 | 备份优先级 | 排障时的处理 |
|---|---|---|---|
| 主程序与启动脚本 | 主程序、启动脚本、版本文件 | 必须 | 先整体复制，再验证单项 |
| 主程序数据目录 | 资源索引、内容、运行数据 | 必须 | 不手动删除未知子目录 |
| 运行加载器 | 加载器、运行依赖和配置 | 必须 | 只移出最近新增的一组 |
| Mod 区 | Mod 文件和开关配置 | 高 | 升级前单独快照，必要时逐组移出 |
| 插件区 | 可选插件或扩展 | 高 | 只使用已确认版本 |
| 本地资源区 | 图片、视频、封面、皮肤和自定义资源 | 高 | 记录来源和相对路径 |
| 用户数据区 | 启动显示、用户设置和本地偏好 | 高 | 先备份再改主题/启动项 |
| 上传数据区 | 等待处理或暂存的数据 | 高 | 不把它当作完整账号备份 |
| 错误日志区 | 启动、加载、网络和运行错误 | 中 | 按时间选取，不公开全量 |
| 设备/固件区 | 设备标识、固件或校验文件 | 必须 | 不改名、不覆盖、不跨版本复制 |
| 公共配置区 | 客户端/服务端/通用 JSON 或 ini | 必须 | 先复制原文，逐项改动 |
| 运行库区 | 引擎、托管运行库和 DLL | 必须 | 不从其它版本机器拼接 |
如何区分“可删除缓存”和“不能删除的文件”
文件名本身不能证明它是缓存。只有满足以下条件时，才考虑清理：
- 管理员明确指出它是可重建的下载缓存；
- 当前已有完整账号备份和恢复介质；
- 没有正在运行的订单、上传或安装；
- 清理范围、时间和回滚方式已经记录；
- 清理后知道如何重新下载或恢复。
主程序、运行库、设备/固件、用户数据、配置和未知日志目录不要直接删除。
配置文件的备份策略
根目录中可能存在多个 JSON、INI、TOML 或批处理文件。它们的用途可能分别是客户端、通用配置、服务地址、启动参数和本地显示。
备份时：
- 保存原文件名和相对路径；
- 记录文件修改时间和维护时间；
- 不把 Token、密码、访问码或网络地址提交到公开仓库；
- 不要把不同版本的配置文件互相覆盖；
- 修改前保留一份只读副本；
- 出现异常时一次只恢复一个文件。
如果网页配置和目录配置同时存在，以管理员说明的可见入口为准。不要通过手动编辑本地文件绕过网页权限。
本地资源区的维护
本地资源通常数量多、体积大，并且可能与某个订单或版本绑定。维护时给资源建立清单：
text
资源相对路径：
资源类型：图片/视频/音频/其它
来源：管理员/自制/网页下载
适用版本：
最后验证时间：
是否可重新下载：更新后资源缺失时，先检查订单是否完整、路径是否变化和磁盘空间，不要马上覆盖整个资源目录。
日志收集范围
发生启动、挂载、下载、网络或上传问题时，只收集与时间点相关的日志：
- 记录故障时间和本地时区；
- 复制故障前后相邻时间段的日志；
- 保留文件名和相对路径；
- 打码 Token、访问码、账号、机台标识、网络地址和个人信息；
- 同时附上网页错误消息和健康页截图。
不要把整个日志目录打包发到群里，也不要把日志中的命令、密码或配置原样复制到公开反馈。
更新前后目录快照
推荐为每次大更新保留三份快照：
| 快照 | 时机 | 用途 |
|---|---|---|
| A | 更新前 | 判断原始状态和回滚 |
| B | 下载完成、应用前 | 判断下载/校验阶段是否完整 |
| C | 重启验收后 | 作为新的可用基线 |
快照不一定要包含可重新下载的大型文件，但至少应包含配置、Mod、插件、本地资源索引、用户数据、错误日志摘要和账号缓存位置。
目录异常的最小变更流程
- 复制当前根目录和日志；
- 标记最近新增/修改的文件；
- 只移出一组最近变更；
- 启动并记录结果；
- 若问题消失，恢复一组中的文件逐个定位；
- 若问题仍在，回到快照 A，不要继续叠加修改。
这种流程比“整目录覆盖”更容易定位问题，也能避免把用户数据和可恢复缓存一起覆盖。
安装前备份
至少保留：
- 整个游戏根目录的版本快照，或管理员提供的可恢复镜像；
Mods和Plugins；- Mod 配置文件和配置备份目录；
LocalAssets；- 网页下载的账号缓存；
- 最近一次健康检查截图。
不要只备份一个 Mod 文件就认为可以恢复。启动器、插件和配置版本不匹配时，单个文件通常无法独立工作。
更新后文件检查
更新完成后按以下顺序检查：
- 主程序可以启动；
- 加载器没有连续报错；
Mods中的文件版本匹配；- 自定义资源仍然存在；
- 用户数据和上传缓存没有被误删；
- Web 端能读取账号记录和相片。
排障时的最小变更法
- 先复制当前目录和日志；
- 只移出最近新增的文件；
- 启动测试并记录结果；
- 一次只恢复一组文件；
- 出现异常立即停止，回到最近一次可用快照。
不要在没有备份的情况下直接覆盖整个目录，也不要从不同版本的机器复制运行库。