参考与开发
诊断与故障排查
mcl 如何收集会话日志、防止实例锁冲突以及恢复中断的更新或迁移任务。
会话日志
每次启动游戏时,mcl 会按本次会话采集边界内的输出日志,并在保存前自动对敏感令牌做脱敏处理,便于在日志页面排查异常退出问题。
实例锁与运行中保护
mcl 使用操作系统级文件锁与持久化的游戏进程身份记录。即使启动器在游戏运行期间关闭并重开,仍会保持实例占用状态,防止修复或删除操作损坏正在运行的游戏目录。
中断恢复机制
- 资产更新:通过私有暂存区与待完成日志(
asset-update.pending.json)保障原子性;异常退出后重开实例页可继续完成或安全回滚。 - 目录迁移:迁移完成确认前保留原目录副本。
- 下载任务:任务状态持久化保存,可在下载任务面板中查看详情、取消或重试。