让猫咪跟着你的键盘、鼠标和手柄一起动BongoCat 桌面宠物上手指南【免费下载链接】BongoCat 跨平台互动桌宠 BongoCat为桌面增添乐趣项目地址: https://gitcode.com/gh_mirrors/bong/BongoCatBongoCat 是一款跨平台的互动桌宠它常驻在桌面上实时接收你的键盘、鼠标或游戏手柄输入并同步做出敲击、弹跳等动作。项目基于 Tauri 框架开发支持 macOS、Windows 和 Linuxx11完全开源、离线运行不收集任何用户数据。如果你长时间面对屏幕想让打字和打游戏的过程多一点视觉反馈它就是一个低门槛、可定制的起点。第一次使用前先确认三件事桌宠不响应输入90% 的情况出在这三步之外动手前先花一分钟核对你的输入方式是什么。BongoCat 按输入源区分模型键盘、手柄各有专属内置模型先确定你主要用哪种方式操作电脑再选对应模型后面的行为配置才有意义。系统权限是否给到位。macOS 需要「输入监控」权限Windows 需要以管理员身份运行缺少授权时应用根本收不到键盘事件猫咪会一动不动。输入设备是否可用。手柄模式要确认设备已被系统识别键盘模式则确认驱动正常。设备连不上后面所有映射都是空谈。快速开始最短路径跑起来获取应用。从项目 Releases 下载对应平台的安装包Windows / macOS / Linux解压或安装后直接启动如果你打算自己编译运行可克隆仓库https://gitcode.com/gh_mirrors/bong/BongoCat构建需要 Node.js 与 Rust/Tauri 工具链具体以项目文档为准。启动并授权。首次打开设置窗口后按系统提示授权macOS 会弹窗引导去「系统设置 → 隐私与安全性 → 输入监控」添加 BongoCatWindows 若未以管理员身份运行会提示退出后用管理员权限重新启动。验证结果。授权后回到桌面敲几下键盘——默认模型下的猫爪应该立刻落下并抬起。动作出现说明输入链路已经通了。如果这一步失败直接跳到文末的快速排错表。按你的输入方式选择配置路径BongoCat 的三套内置模型分别放在src-tauri/assets/models/的 keyboard、gamepad、standard 子目录中对应不同的动作设计。在「设置 → 模型」页点击缩略图即可切换当前生效的模型会显示对勾。键盘模式打字时的默认选择选键盘模型后你按下的键会映射为猫爪敲击动作。想精细控制哪些键触发哪些动作可以打开模型页的行为编辑器模型卡片上的表情图标入口逐条调整按键与动画的对应关系保存后立即生效。适合写代码、写文档等以键盘为主的工作流。手柄模式游戏和直播的加分项手柄模型把按键和扳机映射成猫的动作。注意手柄输入本身不需要额外驱动授权但前提有两个——设备已被系统识别并且你当前切换到了手柄模型。映射同样在行为编辑器里逐条配置改完用真实按键验证一遍确认没有按错键位。鼠标响应可以开也可以完全关掉「模型」设置里有两个与鼠标相关的开关一个控制猫咪是否跟随鼠标动作做出镜像动作另一个可以直接忽略鼠标输入。如果你只想让猫咪响应键盘或手柄把鼠标忽略打开最干净开启镜像则适合想让猫对鼠标移动也有反馈的场景。个性化外观与资源替换导入你自己的 Live2D 模型Live2D 模型是带动画的 2D 角色资源包本质是一组贴图、动作和配置文件的集合。导入路径在「设置 → 模型」页瀑布流最上方是上传卡片选择你的模型目录完成导入后它会以缩略图卡片出现在列表里点击即切换卡片上的文件夹图标可以直接在文件管理器中打开模型目录删除按钮仅对非内置模型可用。内置模型有固定的封面和贴图文件如各模型目录下的resources/cover.png自定义模型按相同结构组织即可被正确识别。窗口显示参数「设置 → 猫咪」页集中管理显示相关项每一项都对应可感知的效果镜像 / 鼠标镜像调整动作方向让猫的动作与你的习惯一致。动作音效敲击时是否发声。窗口大小1% 到 500% 的缩放多屏大桌面可以放大到 200% 以上。透明度10% 到 100%调低后猫咪不挡视觉焦点。点击穿透开启后窗口不再拦截鼠标点击适合把猫咪放在常用区域。始终置顶 / 保持在屏幕内控制层级与边界行为避免拖出屏幕找不到。悬停隐藏鼠标悬停指定秒数后自动隐藏让路给正常操作。平台差异与系统设置平台授权方式生效条件macOS「系统设置 → 隐私与安全性 → 输入监控」中添加 BongoCat授权后重启应用Windows以管理员身份运行启动时即以管理员身份运行Linux需 x11 会话环境启动后直接验证macOS 的细节如果之前授权过旧版本先在输入监控列表中移除 BongoCat 再重新添加然后重启应用权限才正式生效设置窗口内会显示当前授权状态。Windows 的细节普通用户身份启动时应用收不到全局键盘事件必须重新以管理员身份启动Linux 目前适配 x11 桌面环境Wayland 等环境的可用性以项目实际支持为准。体验优化与性能控制控制帧率上限。「猫咪」设置里的最大帧率默认 60低配机器可以下调到 30 左右动作流畅度几乎不受影响渲染开销明显下降。按键自动松开。Windows 下的自动松开延迟秒用于兜底极端情况下按键事件没被正确释放时猫咪动作会卡在半空调大这个值能让它按时复位。多屏布局。直接拖拽猫咪窗口到副屏配合「保持在屏幕内」开关防止越界副屏分辨率较低时把窗口缩放到 50%~100% 比较稳妥。资源占用过高时。依次尝试降帧率、换贴图更简单的模型、开启悬停隐藏必要时重启应用释放内存。快速排错现象优先检查处理动作验证方式敲键盘猫没反应系统授权macOS 输入监控 / Windows 管理员按平台差异一节重新授权重启应用敲击键盘猫爪落下并抬起动作有延迟或掉帧最大帧率设置、系统负载帧率下调至 30关闭后台高占用程序连续快速敲击观察动作是否连贯动作卡住不回位Windows 自动松开延迟适当调大该延迟值秒长按后松开猫咪按时复位猫咪挡住点击操作点击穿透、悬停隐藏开启点击穿透或设置悬停几秒后隐藏鼠标悬停后点击猫咪背后的窗口手柄输入无反应设备识别、当前模型确认系统已识别手柄切换到手柄模型并检查映射逐个按键确认对应动作触发适合场景与扩展建议编程开发写代码、等编译时猫咪随键盘敲击视觉反馈比单纯静音环境更有节奏感。直播与录屏镜头前同时出现猫咪对按键的响应观众能直观看到你敲了多少键是天然的互动元素。手柄游戏手柄模型让猫咪跟随游戏输入动作娱乐场景更有陪伴感。学习办公长时间伏案时角落里的桌宠提供低打扰的陪伴。模型社区分享导入自定义 Live2D 模型后也可以参考上游社区的模型仓库交流作品以社区仓库实际内容为准。下一步清单按主要输入方式选好模型并在行为编辑器里过一遍映射。按机器性能设定最大帧率低配建议 30 起步。把透明度与点击穿透调到不挡正常工作的程度。替换一个自己满意的 Live2D 模型完成个性化。多屏用户拖到副屏、调整缩放确认「保持在屏幕内」已开启。遇到不确定的行为优先回到「设置 → 猫咪」逐开关排查——这个项目的大部分表现问题都能在权限和这两组设置里找到答案。【免费下载链接】BongoCat 跨平台互动桌宠 BongoCat为桌面增添乐趣项目地址: https://gitcode.com/gh_mirrors/bong/BongoCat创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考