三步打造专属桌面猫咪：BongoCat自定义模型导入全攻略

你是否已经厌倦了千篇一律的桌面宠物？想让你的BongoCat与众不同？本文将带你通过简单三步，将任何Live2D模型转化为会对你的键盘和鼠标操作做出反应的专属桌面猫咪。无需编程基础，只需跟着指引操作，5分钟即可完成个性化设置。

一、准备符合规范的模型文件

BongoCat支持标准Live2D Cubism 3/4格式的模型文件，你需要准备以下文件结构：

• 主配置文件（.model3.json）
• 模型数据文件（.moc3）
• 纹理图片文件夹（包含.png格式纹理图）
• 动作文件（.motion3.json，可选）
• 表情文件（.exp3.json，可选）

官方预设模型结构可参考：src-tauri/assets/models/standard/

模型配置文件（.model3.json）是关键，需要正确定义文件引用关系。以下是一个基本的配置示例：

{
  "Version": 3,
  "FileReferences": {
    "Moc": "demomodel.moc3",
    "Textures": [
      "demomodel.1024/texture_00.png",
      "demomodel.1024/texture_01.png"
    ],
    "Motions": {
      "CAT_motion": [
        {
          "File": "live2d_motion1.motion3.json",
          "FadeInTime": 0.5
        }
      ]
    }
  }
}

二、导入模型到BongoCat

1. 创建模型文件夹 在项目的模型目录中创建新文件夹：src-tauri/assets/models/ 建议使用有意义的名称（如"my_custom_cat"）作为你的模型标识。

2. 复制文件到目录 将准备好的所有模型文件复制到新创建的文件夹中，保持文件结构与官方模型一致。确保所有文件路径在.model3.json中正确引用，相对路径以配置文件所在位置为基准。

3. 修改模型存储配置 编辑模型存储文件：src/stores/model.ts 在初始化函数中添加你的模型信息：

nextModels.unshift({
  id: "my_custom_cat",  // 唯一标识
  mode: "standard",     // 模型类型：standard/keyboard/gamepad
  isPreset: false,      // 设为false表示自定义模型
  path: join(modelsPath, "my_custom_cat"),  // 模型文件夹路径
})

三、配置模型交互行为

BongoCat通过参数映射实现模型对用户输入的响应，你需要配置键盘按键与模型动作的对应关系。

1. 编辑模型交互逻辑 打开模型交互逻辑文件：src/composables/useModel.ts

2. 设置按键响应 在handlePress函数中添加按键与动作的映射关系：

const handlePress = (key: string) => {
  // 自定义按键映射
  const keyMappings = {
    'KeyA': 'left_paw',
    'KeyS': 'right_paw',
    'Space': 'jump'
  };
  
  const motionPath = modelStore.supportKeys[keyMappings[key]];
  if (motionPath) {
    live2d.startMotion(motionPath);
  }
}

3. 调整模型大小与位置 如果导入的模型大小不合适，可以在handleResize函数中调整缩放比例：

catStore.window.scale = round((size.width / width) * 80);  // 80为缩放百分比

四、应用与测试

完成上述步骤后，重新启动BongoCat应用，在设置界面的模型选择中就能看到你的自定义模型了。点击应用后，模型会立即加载并对你的键盘操作做出反应。

如果模型无法加载或动作异常，可以检查：

• 模型文件路径是否正确
• .model3.json配置是否有语法错误
• 纹理图片格式是否为PNG且尺寸合适
• 模型文件权限是否正常

现在，你已经成功创建了专属的BongoCat模型！尝试添加更多自定义动作和表情，让你的桌面猫咪更加生动有趣。如有疑问，可以参考项目官方文档或提交issue获取帮助。