安装与首次启动

Kabegame 面向 Windows、macOS、Linux 桌面与 Android 发布。桌面端是单一的标准（standard）构建，带有虚拟盘；kabegame-cli 命令行工具是独立下载，不随主程序打包。本页说明在各平台下载哪个包、如何处理虚拟盘依赖，以及首次启动后数据落在哪里。

选择发行包

从 GitHub Releases 下载对应平台的文件：

平台	主程序包名	命令行工具（可选，单独下载）
Windows	`Kabegame-standard_<版本>_x64-setup.exe`	`Kabegame-cli-standard_<版本>_x64-setup.exe`
macOS	`Kabegame-standard_<版本>_aarch64.dmg`	`Kabegame-cli-standard_<版本>_aarch64`
Linux	`Kabegame-standard_<版本>_amd64.deb`	`Kabegame-cli-standard_<版本>_amd64`
Android	`Kabegame_<版本>_android-preview.apk`	不适用

Windows

下载 Kabegame-standard_<版本>_x64-setup.exe，双击运行 NSIS 安装向导。

首次安装时，如果系统缺少 Dokan 2.x 驱动，安装器会通过 UAC 提权自动调起捆绑的 Dokan 安装程序。完成后安装目录默认位于 C:\Program Files\Kabegame\，开始菜单会出现 Kabegame 图标。

虚拟盘的进一步配置请见虚拟盘。

macOS

下载 Kabegame-standard_<版本>_aarch64.dmg，双击挂载后把 Kabegame.app 拖入「应用程序」。

由于安装包未签名，首次打开时 macOS Gatekeeper 会提示「已损坏」或无法验证开发者。在终端执行：

xattr -d com.apple.quarantine /Applications/Kabegame.app

命令完成后即可正常启动。最低系统要求为 macOS 11（Big Sur）。

Linux

下载 Kabegame-standard_<版本>_amd64.deb，在终端执行：

sudo dpkg -i Kabegame-*.deb

如果提示依赖缺失，再执行以下命令补齐：

sudo apt-get install -f

deb 会声明对 fuse3 的依赖，apt 会自动拉取。若你的系统未预装 fuse3，也可以先手动安装：

sudo apt install fuse3

最低支持 Ubuntu 24.04。

Android

从 Releases 页面下载 Kabegame_<版本>_android-preview.apk，按照以下步骤安装：

在系统设置中允许浏览器或文件管理器「安装未知来源的应用」。
在文件管理器中点击下载的 APK，按提示完成安装。
首次启动会自动创建数据目录，无需额外配置。

最低 Android 8.0（API 26+）。

虚拟盘依赖一览

虚拟盘只存在于桌面版。各平台所需依赖：

平台	依赖	为什么需要
Windows	Dokan 2.x 驱动（含 `dokan2.sys`）	将图库挂载为本地磁盘
macOS	macFUSE	通过 FUSE 在 `~` 下暴露挂载点
Linux	`fuse3`	通过 FUSE 在本地目录挂载，`fusermount3` 用于卸载

各平台的挂载点配置、常见错误处理均在虚拟盘中展开。

`.kgpg` 文件关联

桌面平台安装完成后会自动注册 .kgpg 文件关联：

Windows、macOS：安装器自动写入注册表与 UTI。
Linux：deb 的 postinst 脚本刷新 mime 数据库。

双击 .kgpg 插件包会通过 kabegame-cli 导入。Android 没有 .kgpg 关联。

首次启动后的数据目录

应用不会弹出安装引导窗口，启动后会直接创建数据与缓存目录。各平台路径如下：

平台	应用数据	缓存
Windows	`%LOCALAPPDATA%\Kabegame`	`%LOCALAPPDATA%` 下的 `Kabegame` 子目录
macOS	`~/Library/Application Support/Kabegame`	`~/Library/Caches/Kabegame`
Linux	`~/.local/share/Kabegame`（或 `$XDG_DATA_HOME/Kabegame`）	`~/.cache/Kabegame`
Android	`/data/data/app.kabegame/files`	`/data/data/app.kabegame/cache`

Android 的大文件目录位于 /storage/emulated/0/Android/data/app.kabegame/files。所有平台的临时目录都是系统 temp 下的 Kabegame 子目录。

卸载

桌面端可通过系统的「应用与功能」或「应用程序」卸载 Kabegame。需要注意：

Pictures/Kabegame 中的图片不会被删除，若要清理需手动操作。
应用数据目录和缓存目录（见上一节）同样不会随卸载移除，请按需手动删除。

排障

Windows 挂载虚拟盘提示「Dokan 驱动不可用」 → Dokan 2.x 运行时未正确安装或缺少 dokan2.sys → 重新安装 Dokan 2.x 驱动。
Windows 挂载提示「Dokan 版本不兼容」 → dokan2.dll 与系统驱动版本不匹配 → 升级或重装 Dokan 2.x 驱动到与应用匹配的版本。
macOS 启动提示「已损坏」或无法打开 → 安装包未签名被 Gatekeeper 隔离 → 执行 xattr -d com.apple.quarantine /Applications/Kabegame.app。
Linux dpkg -i 报依赖错误 → fuse3 等依赖缺失 → 执行 sudo apt-get install -f 自动补齐。
Linux 在 Wayland 下看起来仍然走 X11 → 应用主动设置了 GDK_BACKEND=x11 作为兼容方案 → 这是正常行为，无需处理。