安装与首次使用
1. 确认平台
| 平台 | 可用发行包 | 支持状态 |
|---|---|---|
| Windows 10 1809+ / Windows 11 x64 | 安装程序、便携 ZIP | 正式支持 |
| macOS Apple Silicon | .app 压缩包 | 实验性（暂不支持启动游戏） |
| Linux x64 | .deb、AppImage、tar.gz | 实验性 |
发行包为自包含应用，无需另行安装 .NET Runtime。游戏本体仍需要足够的磁盘空间和持续可用的网络连接。
WARNING
macOS 与 Linux 版本仍为实验性构建。Linux 下使用 UMU / Proton 或 Wine 启动 Windows 游戏客户端时，XIGNCODE3 反作弊兼容性未经验证。macOS 版本目前只能安装、更新和修复游戏，启动游戏暂无支持计划。
2. 下载正确的文件
前往 Cafe Launcher Releases，进入最新版本并选择：
| 文件名 | 用途 |
|---|---|
Cafe.Launcher.Avalonia_v*_setup.exe | Windows 标准安装，推荐大多数用户使用 |
Cafe.Launcher.Avalonia_v*_win-x64.zip | Windows 便携版 |
Cafe.Launcher.Avalonia_v*_osx-arm64.zip | Apple Silicon Mac |
Cafe.Launcher.Avalonia_v*_linux-x64.deb | Debian、Ubuntu 等发行版 |
Cafe.Launcher.Avalonia_v*_linux-x64.AppImage | Linux 免安装运行 |
Cafe.Launcher.Avalonia_v*_linux-x64.tar.gz | Linux 手动解压部署 |
带有 beta 的版本属于测试频道。希望获得更稳定体验时，请选择不带预发布标签的最新版本。
3. 安装启动器
Windows 安装版
运行
setup.exe。选择安装语言，可选项为 English、简体中文和日本語。该选择只影响安装程序本身，启动器界面语言在下一步的首次设置中单独选择。
接受系统的管理员权限提示。
确认安装目录。默认写入
C:\Program Files\Cafe Launcher，向导同时显示所选磁盘的可用空间。
选择附加任务，可以创建桌面快捷方式。
完成后可以直接勾选“运行 Cafe Launcher”启动程序。
安装、升级和卸载按所有用户范围执行，需要管理员权限。覆盖安装新版本时，游戏文件和用户设置不会被删除。
Windows 便携版
- 完整解压
win-x64.zip。 - 运行
Cafe.Launcher.Avalonia.exe。 - 更新时先退出程序，再替换便携目录。
不要直接在压缩包预览窗口中运行程序。便携版不会创建标准卸载入口，但设置和日志仍保存在用户数据目录中。
macOS
解压 osx-arm64.zip，将 Cafe Launcher.app 移入“应用程序”后运行。该构建仅适用于 Apple Silicon Mac。
macOS 上只能安装、更新和修复游戏：启动 Windows 游戏客户端需要额外的兼容运行层，当前不提供，也暂无支持计划。
Linux
.deb：通过发行版的软件包管理工具安装。- AppImage：赋予执行权限后直接运行。
tar.gz：解压后运行Cafe.Launcher.Avalonia。
Linux 系统需要提供图形、字体和基础运行库。若程序无法启动，请从终端运行并根据缺失库提示安装依赖。
4. 完成首次设置
第一次启动时会显示五步向导，每一步都可以用“上一步”返回修改。
- 语言：选择启动器界面语言。
- 下载源：官方源提供原始日服资源；Cafe 源由蔚蓝咖啡厅（bluearchive.cafe）日服汉化组提供，内置本地化（汉化）资源。
- 游戏安装路径：选择一个基础目录，游戏会安装在该目录的
YostarGames\BlueArchive_JP子目录中。如果所选目录中已经存在有效安装，向导会直接识别出来。 - 代理：选择自动、直连或系统代理。
- 确认您的设置：复核以上四项，每项都可以单独“修改”，确认后点击“完成”应用。
中文系统默认选择 Cafe 源，其他语言环境默认选择官方源。稳定构建默认跟踪稳定频道，预发布构建默认跟踪测试频道；两项设置之后都可以修改。
选择“跳过引导”或按 Esc 时，启动器会先确认，再应用默认设置。
5. 识别或安装游戏
- 如果已有官方启动器下载的游戏，选择其
BlueArchive_JP目录。启动器会读取manifest.json和game-launcher-config.json，无需重复下载完整游戏。 - 如果未安装游戏，点击主界面的“安装游戏”。下载期间可以暂停或继续，完成后会自动校验。
- 如果目录中只有部分文件，启动器会根据清单计算并下载缺失内容。
TIP
安装前请确认目录可写，并预留足够空间。不要把游戏安装到只读目录；Linux 软件包和 AppImage 默认会改用用户主目录下的 YostarGames/BlueArchive_JP。