RustServerToolbox 服务器运维工具箱 v1.1.7

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【一】工具简介
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
RustServerToolbox 是一款面向 Rust 服主的 Windows 图形化服务器运维工具箱，把日常维护中最容易出错、最繁琐的五件事——开关服、SteamCMD 更新、Oxide 补丁重打、自定义地图直发、清档换档——全部整合到一个窗口里。全程按钮化操作，自动存档、自动备份、自动识别服务器路径，不需要手敲命令、不需要手写 bat，新手也能安全完成资深服主的标准操作流程，从根源上避免强退回档、大更后忘打 Oxide、清档误删权限数据等常见事故。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【二】安全开关服（首页）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1、安全关服走标准存档流程：先经 RCON/控制台执行 server.save 等待 12 秒确保世界存档落盘，再结束 sta.bat 看门狗进程，最后硬终止 RustDedicated.exe，杜绝直接杀进程导致的回档丢档。
2、安全重启 = 安全关服 + 等待 5 秒 + 自动启动 sta.bat，执行前二次确认，服上玩家会被保存后踢出。
3、一键直接开服：调用 sta.bat 启动器开服。
4、底部状态栏每 2.5 秒刷新一次服务器运行状态（运行中显示 PID，已停止显示空闲）；多服务端同机时只识别本工具配置目录下的 RustDedicated 进程，不会误判、误杀兄弟服。
5、首页自带 CrateDiag 插件状态检测：自动识别 oxide/plugins 下是否已安装 CrateDiag（解决油田等物资点箱子占位冲突、无限刷新、挤压堆叠问题），缺失时一键安装工具内置副本，无需另行下载。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【三】SteamCMD 更新与 Oxide 补丁（更新页）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1、内置两种更新模式：小更执行 app_update 258550 不带 validate，适用于日常小版本和热修，速度快；大更执行 app_update 258550 validate 校验全部游戏文件，适用于月度大更新或文件损坏修复。
2、可勾选“更新完成后自动开服”，更新结束自动执行 sta.bat，无需值守。
3、大更完成后红字醒目提醒：必须重新打上 Oxide 补丁，避免版本不匹配导致插件全部失效。
4、一键从 uMod 官方地址下载最新 Oxide/uMod 公共补丁，下载前弹窗确认加速器状态，补丁统一缓存到服务端根目录下的 _patch_cache 文件夹。
5、下载完成可一键解压覆盖到服务端根目录完成重打补丁，解压内置 zip slip 路径穿越防护，拒绝恶意路径。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【四】地图直发（地图页）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1、专为国内服务器解决自定义地图分发难题：官方 server.autouploadmap 在国内连接 Facepunch 服务器超时不可用，本工具直连免费地图站 RustMapCloud（map.rustnm.com）。
2、三步式流程按钮：① 按种子号和地图大小本地生成地图；② 上传 identity 目录下最新的 .map 文件；③ 把下载直链写入 sta.bat 的 levelurl 并开服。原 sta.bat 自动备份带时间戳的 .bak 文件。
3、提供“一键全流程”：自动启动本地生图 → 监控地图文件大小稳定 30 秒 → RCON 通知停服 → 自动上传 → 自动改 levelurl → 自动开服，全程无需干预。
4、上传协议完善：整文件 MD5 秒传去重（不占上传额度）、大文件自动分片上传、失败自动重试，并支持只上传指定的 .map 文件。
5、直链格式固定为 https://map.rustnm.com/down.php/ 文件MD5.map，支持 Range 断点续传，玩家进服下载稳定。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【五】可视化清档换档（清档页）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1、三类清理清单全部勾选式操作：第一类 server<identity> 存档目录（地图、蓝图、玩家数据）；第二类 userdata 玩家本地缓存；第三类 oxide/data 插件数据，自动扫描本服实际安装的插件生成勾选项，未识别的项目默认不勾，绝不乱删。
2、清单提供“默认勾选 / 全选 / 全不选”三个快捷预设。
3、永久保留项明确标注并默认保护：权限组数据（oxide.groups / oxide.users）、CopyPaste 建筑粘贴数据、RaidableBases 战利品模板、NpcSpawn 导航数据、ImageLibrary 图片缓存、传送点数据，清档不丢管理配置。
4、强制安全流程：服务器运行中拒绝执行清档；必须按顺序走“① 安全关服 → ② 生成清理计划预览 → ③ 勾选确认复选框 → 执行清档”，先看清楚删什么再动手。
5、所有被清理的文件移动（非删除）到 wipe_backup_时间戳 备份目录，发现清错可完整找回。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【六】全局设置与自动识别
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1、首次启动自动在程序相邻目录内探测 RustDedicated.exe 并完成全套配置，无需手动填写。
2、一键自动识别：扫描启动 bat/cmd 中的 +server.identity、+rcon.port、+rcon.password，自动定位 SteamCMD 目录和补丁缓存目录，识别结果全部可手动修改。
3、配置保存在程序同目录的 servertoolbox.json 单文件中，拷贝程序即可迁移。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【七】使用方法
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1、将 RustServerToolbox.exe 放到服务器上任意目录（建议放在服务端根目录附近，便于首次自动识别），双击运行。
2、首次打开会自动识别服务器路径；如识别不全，点右上角“全局设置”，选好服务端根目录后点“自动识别”，核对无误点保存。
3、日常重启：首页点“安全重启”。日常小更新：更新页选“小更”，点“开始 SteamCMD 更新”，可勾选更新后自动开服。
4、月度大更新：更新页选“大更”，更新完成后点“下载最新 Oxide 补丁”，再点“解压覆盖到根目录”，然后开服。
5、换自定义地图：地图页填种子号和地图大小，点“一键全流程”等待自动完成即可。
6、清档：清档页按提示先安全关服，勾选要清理的项目，先生成清理计划预览，确认后勾选复选框并执行。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【八】注意事项
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1、本工具为 Windows 桌面程序，需在运行 Rust 服务端的机器上（或远程桌面中）使用，不需要安装，单个 exe 双击即用。
2、工具只服务于 Windows 版 Rust 服务端 + Oxide/uMod 环境，依赖你现有的 sta.bat 启动器（含 identity、RCON 端口和密码配置）。
3、所有关服、更新、清档动作均在后台线程执行，执行日志实时显示在底部日志栏，请勿在流程进行中关闭程序。
4、安全关服要求 RCON 信息配置正确；RCON 不通时工具会拒绝强杀进程，防止误操作。
5、清档与地图操作均有自动备份，但重要数据仍建议服主另行定期异地备份。