幽影小猫桌宠

先解压，解压后打开第四个文件即可使用# Bongo Cat Mver 桌面宠物 — 产品描述

## 产品概述

Bongo Cat Mver 是一款轻量级 Windows 桌面宠物应用，能够在桌面上实时展示一只跟随键盘、鼠标和游戏手柄输入而动态响应的虚拟角色。程序灵感来源于著名网络迷因 "Bongo Cat"，通过多层 PNG 素材叠加和 Live2D 骨骼动画技术，实现生动流畅的交互效果。

## 核心功能

### 1. 实时输入响应
- 键盘模式：检测键盘按键，手部跟随键位节拍敲击，类似 Bongo Cat 经典动作
- 鼠标模式：角色手臂跟踪鼠标光标位置，实现"猫咪跟着鼠标走"的趣味效果
- 游戏手柄模式：支持 Xbox/PS 等标准手柄，检测摇杆和按钮操作
- 数位板模式：支持绘图板输入，笔触位置实时跟踪

### 2. 三种工作模式

| 模式 | 说明 | 适用场景 |
|------|------|----------|
| 🎹 键盘模式 | 纯键盘输入，左右手独立动画 | 打字、编程、游戏键鼠分离 |
| 🖱️ 标准模式 | 键盘 + 鼠标 + 数位板全支持 | 日常办公、浏览网页 |
| 🎮 手柄模式 | 游戏手柄输入，双摇杆独立动画 | 主机游戏直播、手柄操作展示 |

### 3. 动画与音效
- 每种按键对应独立的手部动画帧，动作细腻流畅
- 内置 6 组按键音效（FLAC 无损格式），手感反馈真实
- 支持 Live2D 骨骼动画（可选开关），角色面部表情和身体动态更生动
- 60 FPS 渲染，画面丝滑无卡顿

### 4. 桌面集成
- 窗口置顶：始终浮动在桌面最上层，不遮挡任务栏
- 桌面宠物模式：点击穿透，不影响正常桌面操作
- 自定义位置：支持手动拖拽或配置坐标固定位置
- 窗口缩放：可调整宠物显示大小（1.0x 缩放）

## 技术架构

┌─────────────────────────────────────────────────┐
│                  Bongo Cat Mver.exe              │
│                                                 │
│  ┌──────────┐  ┌──────────┐  ┌───────────────┐  │
│  │ 输入检测  │  │ 动画引擎  │  │  音频引擎     │  │
│  │          │  │          │  │               │  │
│  │ 键盘 Hook│  │ PNG 叠加 │  │  OpenAL 播放  │  │
│  │ 鼠标跟踪  │  │ Live2D   │  │  FLAC 解码    │  │
│  │ 手柄 API │  │ 帧动画   │  │  音效混合     │  │
│  └────┬─────┘  └────┬─────┘  └───────┬───────┘  │
│       │             │                │          │
│  ┌────┴─────────────┴────────────────┴───────┐   │
│  │            SFML 渲染框架 (2.x)            │   │
│  │    OpenGL 渲染  │  窗口管理  │ 网络通信   │   │
│  └───────────────────────────────────────────┘   │
└─────────────────────────────────────────────────┘

### 依赖库

| 组件 | 用途 |
|------|------|
| SFML 2.x | 图形渲染、窗口管理、音频播放、网络通信 |
| OpenAL | 3D 空间音频引擎 |
| Live2D Cubism 3 | 骨骼动画和面部表情系统 |
| Material Design Toolkit | UI 配置界面主题 |

## 素材规格

| 素材类型 | 格式 | 尺寸 | 数量 |
|----------|------|------|------|
| 宠物本体 | PNG | 612×354 | 1 张/模式 |
| 手部动画 | PNG | 612×354 | 50~54 帧/模式 |
| 面部表情 | PNG | 612×354 | 3~4 种/模式 |
| 按键音效 | FLAC | ~28KB/个 | 6 个/模式 |
| Live2D 纹理 | PNG | 1024×512 | 3 张/模型 |
| Live2D 骨骼 | MOC3 | — | 1 个/模型 |

## 配置说明

所有设置通过 config.json 管理，主要可调参数：

json
{
  "decoration": {
    "window_size": [612, 352],    // 窗口大小
    "framerateLimit": 60,         // 帧率限制
    "scalar": [1.0, 1.0],         // 缩放比例
    "mouse_speed": 1.0,           // 鼠标跟随速度
    "topWindow": true,            // 窗口置顶
    "desktop_pet": true,          // 桌面宠物模式（点击穿透）
    "leftHanded": false           // 左手模式
  },
  "mode": 1,                      // 当前模式：0=手柄 1=键盘 2=标准
  "network": {
    "network": false              // 网络同步开关（多机联动）
  }
}

## 使用方法

### 快速开始
1. 双击 Bongo Cat Mver.exe 启动程序
2. 宠物将出现在桌面上
3. 打字 / 移动鼠标 / 连接手柄即可看到响应动画
4. 右键系统托盘图标打开 UI 设置面板进行详细配置

### 模式切换
- 通过系统托盘右键菜单切换 keyboard / standard / gamepad 模式
- 或通过 BongoCatUI.exe 图形界面切换

### 自定义角色
- 替换 img/[模式]/cat.png 为自定义角色图片
- 推荐尺寸：612×354 像素，PNG 格式（支持透明通道）
- 可自定义手部动画序列替换对应 PNG 文件

## 系统要求

| 项目 | 最低要求 |
|------|----------|
| 操作系统 | Windows 7 / 8 / 10 / 11 (64-bit) |
| 内存 | 512 MB |
| 显卡 | 支持 OpenGL 2.0+ |
| DirectX | DirectX 10 运行库 |
| VC++ | Visual C++ 2015+ 运行库 |
| 硬盘空间 | ~50 MB |

## 特色亮点

- 🆓 完全免费：开源社区项目，无广告无付费
- 🎨 高度可定制：支持自定义角色、动画、音效
- 🎮 多设备兼容：同时支持键盘、鼠标、数位板、游戏手柄
- 🖥️ 桌面友好：点击穿透、窗口置顶，不影响正常工作
- 🌐 网络联机：支持多机同步动画，适合直播/录制场景
- 🔊 无损音效：FLAC 格式音效，高品质听觉体验
- 🦴 Live2D 支持：可选的骨骼动画引擎，角色表现力更强

## 适用场景

1. 内容创作者：直播/录屏时增添趣味元素
2. 程序员/写作者：打字时桌面陪伴，提升工作乐趣
3. 游戏玩家：手柄操作可视化展示
4. 二次元爱好者：桌面展示心仪角色的 Live2D 动态效果
5. 教学演示：键盘/手柄操作输入的可视化教学工具

## 自定义版本说明

> 当前版本已将原始 Bongo Cat 角色替换为用户自定义形象。
> - 角色图片：picture.jpg（已裁剪适配为 612×354 PNG）
> - Live2D 模式：已禁用（使用静态图片 + 手部叠加动画）
> - 如需恢复原始角色，将 cat_backup.png 重命名为 cat.png 即可