常见问题

对局列表 / 存档

• 对局列表是空的 / 扫不到存档？ 多半是存档目录没选对。点左下角「选择存档文件夹」，确认选到 ...\2868840\remote\profile1\saves 这一层（里面应有 .run 文件）。注意 <好友邀请码> 那一段是你自己的 Steam 好友代码。
• 某局解析失败 / 不显示？ 当前主要支持 schema_version = 9 的 .run，过旧存档可能解析失败。如确认是新版游戏存档仍失败，欢迎附上该 .run 文件反馈。
• 列表加载比平时慢？ 仅首次进入战斗页会建立解析缓存，之后再开就是秒开；只有新增 / 修改过的对局才会重新解析。

首页 / Steam 资料

• 头像 / 昵称 / 游玩时长读不到？ 先到「设置」填一次 17 位 SteamID64（纯数字）。头像昵称还依赖联网反查，离线时可能只显示缓存或 SteamID。
• 新闻一直显示「正在施工中」？ 这是新闻源暂时拉取失败时的友好占位，通常是网络问题，稍后会自动重试，不影响其它功能。
• 点「开始游戏」没反应？ 该按钮通过 steam://rungameid/ 唤起，需要本机已安装并登录 Steam 客户端。

生涯统计

• 统计数字看起来不对（尤其承伤 / 卡牌口径）？ 「本人向」指标只统计本人，依赖 SteamID 区分联机队友。请确认「设置」里填了正确的 SteamID64。
• 「生涯档案」区域是空的？ 该区读取游戏本体 progress.save，请确认游戏存档存在且可被读取；它不依赖 mod 或 Pro 模式。
• 某些卡没出现在上分 / 战犯卡里？ 样本太少的卡会被自动过滤（需见过 ≥5 局且拿过 ≥2 局），属正常筛选。

Pro 模式 / 战斗时间线

• Pro 模式装不上 / 找不到游戏？ 先到「设置 → Steam 路径」确认路径正确（尤其多个 Steam Library 的情况）；仍失败时以管理员身份运行软件再启用。
• 启用了 Pro 模式但看不到战斗时间线？ Mod 只对启用之后打的新对局生效，老对局没有逐回合数据。请开一局新的再看。
• 游戏更新后 Pro 模式失效？ Mod 基于 Harmony 补丁，游戏大版本更新后补丁可能需要等软件升级适配（例如 v0.3.5 已适配游戏 v0.108 更新导致的回合边界 hook 改名问题）。遇到类似情况请先升级到最新版本再试。
• 战斗徽章旁出现橙色「数据存疑」角标是什么意思？（v0.3.5 新增）软件会用结构启发式判断每局的回合/伤害数据是否完整——常见诱因是游戏本体更新后 mod 的回合边界识别短暂失效，导致整局被压缩进一个回合。出现该角标只代表这一局的逐回合统计可能不完整，不影响其它局，也不影响「战斗」页之外的功能。请确认 Pro 模式 mod 已是最新版本，并重新打一局新对局验证是否恢复正常。
• 卸载 Mod 后日志还在？ 这是有意设计——卸载不删已生成的日志。想清空到「设置 → 清理日志」手动清理（默认清 7 天前）。

AI 复盘

• 直连 API 失败 / 报错？ 检查 BaseURL、API Key、模型名是否正确，且接口兼容 OpenAI 规范。不想配接口的话，可改用「仅生成提示词」手动复制到外部 AI。
• API Key 安全吗？ Key 用 Windows DPAPI 加密保存在本地，不会上传任何服务器。

更新 / 设置 / 安全

• 提示「链接不安全，已阻止打开」？ 这是 v0.3.2 起的白名单保护：新闻 / 公告里的链接只允许 https 可信域名。出现该提示说明拦下了非预期链接，属正常保护，可反馈具体场景。
• 更新后设置会丢吗？ 不会。覆盖安装即可保留全部设置与数据。v0.3.2 起设置采用原子写入，断电 / 崩溃也不会写出半截文件；万一检测到损坏，会先备份为 settings.json.corrupt 再回退默认，配置可手工找回。
• 软件会改我的存档吗？ 不会。本工具只读取存档用于复盘，不写入、不修改任何对局数据。