参考与开发

诊断与故障排查

mcl 如何收集会话日志、防止实例锁冲突以及恢复中断的更新或迁移任务。

会话日志

每次启动游戏时,mcl 会按本次会话采集边界内的输出日志,并在保存前自动对敏感令牌做脱敏处理,便于在日志页面排查异常退出问题。

实例锁与运行中保护

mcl 使用操作系统级文件锁与持久化的游戏进程身份记录。即使启动器在游戏运行期间关闭并重开,仍会保持实例占用状态,防止修复或删除操作损坏正在运行的游戏目录。

中断恢复机制

  • 资产更新:通过私有暂存区与待完成日志(asset-update.pending.json)保障原子性;异常退出后重开实例页可继续完成或安全回滚。
  • 目录迁移:迁移完成确认前保留原目录副本。
  • 下载任务:任务状态持久化保存,可在下载任务面板中查看详情、取消或重试。