反馈指南

清晰的版本、复现步骤和日志通常比一句“无法使用”更快定位问题。Cafe Launcher 的开发问题统一在源码仓库 Issues跟踪。

提交前

1. 在“设置 → 关于”确认当前版本，并检查是否有更新。
2. 搜索常见问题和已有 Issues。
3. 重启启动器，确认问题是否稳定复现。
4. 如果问题与下载或修复有关，记录所选下载源、代理模式和游戏目录所在磁盘。
5. 如果使用 macOS 或 Linux，请明确说明；这些平台当前为实验性支持（macOS 暂不支持启动游戏）。

一份有效的反馈应包含

• 标题：用一句话说明动作与结果，例如“Cafe 源恢复下载后重复校验同一文件”。
• 版本：从“设置 → 关于”复制版本、构建配置和提交信息。
• 环境：操作系统版本、架构，以及是否使用代理或兼容层。
• 复现步骤：从一个明确初始状态开始，逐步列出操作。
• 预期结果：你认为应该发生什么。
• 实际结果：实际看到的提示、状态或错误。
• 附件：必要的截图和日志 ZIP。

请尽量复制完整错误文本，不要只提供模糊描述。对于偶发问题，请说明大致发生频率和最后一次发生时间。

导出日志

1. 打开 Cafe Launcher。

2. 进入“设置 → 高级”。

3. 如需复现网络或下载问题，可临时将日志级别调为“调试”或“详细”并保存。

4. 复现问题。

5. 返回“设置 → 高级”，点击“导出日志”，打开“导出诊断信息”对话框。

   

6. 选择时间范围。默认导出全部记录，也可以只保留最近 1 小时、最近 24 小时、最近 7 天或最近 30 天。

7. 按需勾选“崩溃报告”和“用户数据”。“日志文件”和“系统信息”始终包含，无法取消。

8. 点击“导出”，选择保存位置，得到 CafeLauncher_Logs_<时间戳>.zip。

导出包包含当前日志、轮转日志和 system-info.json。日志可能包含本地路径、系统版本和网络错误地址等环境信息，发送前可以自行检查；请不要附带账号密码、Cookie、访问令牌或其他敏感信息。

WARNING

“用户数据”包含设置、下载进度与公告已读状态，其中可能含有本地路径和玩家 UID。除非维护人员明确要求，否则不要勾选。

截图与隐私

• 截图前遮盖账号、UID、文件路径或通知中的个人信息。
• 不要公开上传不确定是否包含敏感信息的完整用户数据目录。
• 游戏崩溃日志和 Cafe Launcher 日志不是同一种文件，请优先使用启动器内置的导出功能。
• 如果问题不适合公开，可以通过 feedback@bluearchive.cafe 联系项目组，并在邮件中引用相关 Issue（如有）。

提交位置

• 功能缺陷、兼容问题、功能建议：GitHub Issues
• 使用方法：先查看文档首页和常见问题
• 汉化客户端自身问题：查看汉化客户端常见问题