猫不跟我的键盘动
这是所有桌面桌宠的头号症状，排查阶梯都一样：
- 确认应用真的在运行：托盘或菜单栏里有它，而不只是装好了。
- 重新授予输入权限。macOS 可能在大版本更新后收回输入监听权限，去系统设置里重新打开。这一步对同类悬浮窗应用有文档可查，Mac 上先查它。
- 先重启应用，再考虑更复杂的操作。
Linux 桌面用户注意：全局输入默认走 X11；Wayland 会话下先看平台页的说明，实验性 evdev 默认关闭。
Steam 版：猫不拍任务栏了
Steam 版首先确认游戏进程在运行（它是一个要启动的应用，不是常驻悬浮窗）。社区报告还指出与其他悬浮窗软件的冲突：如果你同时跑多个桌宠或悬浮窗，关掉其他的多试一次。游戏本身启动不了，就走 Steam 验证文件完整性，并且只从官方商店页重装。
"gaming mode"：Steam 版的功能
"gaming mode" 属于 Steam 版，开源桌宠没有这个模式。游戏的 Steam 社区 FAQ 帖（2025 年 2 月）同时提到卡进去和出来的办法：用 Alt+Tab 或点任务栏图标把 Bongo Cat 窗口聚焦，按 F4 切换关闭，或者重启游戏。我们没能直接打开原帖，F4 这个快捷键请按"社区文档"对待，而非商店页官方说明。
启动崩溃或猫是空白
- 先查安装来源。 非官方安装包是安装损坏的最常见原因，按下载指南的渠道重装。
- 查系统版本。 vladelaina 版面向当前的 Windows、macOS、Linux 版本，过老的系统不在支持范围内。
- Linux 重查构建依赖。 README 列了确切的包（
build-essential、cmake、ninja、SDL3 与 OpenGL 库），缺依赖是构建失败最常见的原因。
模型加载不出来
模型问题多半是格式问题，但这一只有个好消息：按 README 说明，vladelaina 版能导入 Mver 源、Tauri（ayangweb）源、Live2D .model3.json 文件与图片补丁，统一归一化进它自己的 Mver 安装格式，所以邻近生态的模型通常能直接装。反方向没有文档：其他应用能不能读它装好的包，我们未能核实。模型页讲清了哪种格式对应哪个应用。
这页没修好的问题去哪报
各项目在各自的 issue 区处理 bug：主桌宠去 vladelaina 仓库的 issues，游戏去 Steam 社区。分不清自己装的是哪只猫，从五版本之辨开始。