3分钟搞定BongoCat模型打包：从单文件到分享全流程

你是否曾为BongoCat模型的分享而烦恼？每次想把精心调整的可爱猫咪动作分享给朋友，却要手动整理十几个文件？本文将带你掌握BongoCat的批量导出功能，让模型打包与分享变得像拖拽文件一样简单。读完本文，你将学会：快速打包预设模型、自定义模型导出设置、验证打包完整性的技巧，以及分享前的最后准备工作。

模型存储结构解析

BongoCat的模型系统采用模块化设计，所有模型文件按照使用场景分类存储。预设模型存放在src-tauri/assets/models/目录下，包含三种模式：标准模式（standard）、键盘模式（keyboard）和游戏手柄模式（gamepad）。每个模式目录下包含模型定义文件（.model3.json）、动作数据（.motion3.json）、表情文件（.exp3.json）以及纹理资源文件夹。

核心模型数据存储在src/stores/model.ts中，通过Model接口定义模型基本信息：

export interface Model {
  id: string          // 模型唯一标识
  path: string        // 模型文件路径
  mode: ModelMode     // 模型模式：standard/keyboard/gamepad
  isPreset: boolean   // 是否为预设模型
}

批量导出功能实现

BongoCat的批量导出功能通过前端交互与后端文件操作协同完成。前端通过src/composables/useModel.ts提供模型加载与管理能力，其中handleLoad函数负责解析模型文件并初始化动画系统：

async function handleLoad() {
  if (!modelStore.currentModel) return
  
  const { path } = modelStore.currentModel
  await resolveResource(path)
  
  const { width, height, ...rest } = await live2d.load(path)
  modelSize.value = { width, height }
  handleResize()
  Object.assign(modelStore, rest)
}

后端文件操作由src-tauri/src/utils/fs_extra.rs实现，copy_dir函数提供目录复制能力，支持将整个模型目录批量导出：

#[command]
pub async fn copy_dir(from_path: String, to_path: String) -> Result<(), String> {
    let mut options = CopyOptions::new();
    options.content_only = true;  // 仅复制内容，不包含源目录本身
    
    create_dir_all(&to_path).map_err(|err| err.to_string())?;
    copy(from_path, to_path, &options).map_err(|err| err.to_string())?;
    
    Ok(())
}

预设模型快速打包

打包预设模型是最常见的使用场景，只需三步即可完成：

1. 打开BongoCat设置界面，切换到"模型"标签页
2. 在模型列表中选择要导出的模型模式（标准/键盘/游戏手柄）
3. 点击"导出模型"按钮，选择保存位置

系统会自动将选中模式的所有相关文件（包括纹理、动作、表情）打包到目标文件夹。以键盘模式为例，导出的文件夹结构如下：

keyboard-export/
├── cat.model3.json        # 模型定义文件
├── demomodel2.cdi3.json   # 模型配置信息
├── demomodel2.moc3        # 模型数据
├── demomodel2.1024/       # 纹理资源文件夹
│   ├── texture_00.png
│   ├── texture_01.png
│   └── texture_02.png
├── *.exp3.json            # 表情文件（多个）
└── *.motion3.json         # 动作文件（多个）

自定义模型导出设置

对于导入的自定义模型，导出时可以进行更多设置。通过修改src/stores/model.ts中的模型存储状态，可控制导出内容：

export const useModelStore = defineStore('model', () => {
  const models = ref<Model[]>([])          // 所有可用模型
  const currentModel = ref<Model>()        // 当前选中模型
  const motions = ref<MotionGroup>({})     // 动作数据
  const expressions = ref<Expression[]>([]) // 表情数据
  
  // ...
})

你可以通过过滤motions和expressions来选择需要导出的动作和表情，实现按需打包。这对于减小导出文件体积非常有用，特别是当模型包含大量不常用动作时。

打包完整性验证

导出模型后，建议进行完整性验证以确保分享的模型可以正常使用。验证方法很简单：

1. 将导出的文件夹复制到src-tauri/assets/models/custom/目录
2. 在BongoCat设置中切换到"自定义模型"
3. 选择刚刚复制的模型并测试所有动作和表情

如果模型加载失败或某些动作无法播放，可能是导出过程中文件丢失。这时可以检查原模型目录，确保所有必要文件都已包含在导出包中。

分享前的最后准备

在分享模型前，还需要做一些简单的准备工作：

1. 检查导出文件夹大小，过大时可考虑压缩为ZIP格式
2. 创建一个简单的README.txt，说明模型的使用场景和特点
3. （可选）截图展示模型的几个典型动作，方便他人预览

完成这些步骤后，你的BongoCat模型就 ready 可以分享了！无论是通过社交平台、文件分享服务，还是直接发送给朋友，对方都能轻松导入并使用你精心制作的可爱猫咪模型。

通过本文介绍的批量导出功能，你可以轻松打包任何BongoCat模型，让分享变得简单而高效。下次当你制作了特别可爱的猫咪动作，不妨试试这个功能，让更多人感受到BongoCat带来的乐趣！