Voicebox声音档案管理导入、导出、备份与共享完整教程【免费下载链接】voiceboxThe open-source AI voice studio. Clone, dictate, create.项目地址: https://gitcode.com/GitHub_Trending/voicebox1/voiceboxVoicebox 是一款开源的 AI 声音工作室The open-source AI voice studio支持声音克隆、听写与创作。它的核心资产就是声音档案Voice Profile——你精心克隆的每一个声音都值得好好管理。本教程将带你快速掌握 Voicebox 声音档案的导出、导入、备份与共享几分钟即可完成第一次完整备份。一、先搞懂什么是 Voicebox 声音档案在 Voicebox 中声音档案是一个已保存声音的基本单位主要分为两类档案类型说明包含内容克隆档案cloned存储你上传的参考音频音频样本 对应参考文本 名称/描述/语言 头像预设档案preset指向引擎内置声音如 Kokoro 的 am_adam仅引擎与声音 ID 指针克隆档案的每条样本都附带参考文本合成时引擎会据此生成声音嵌入voice embedding。档案数据存储在本地数据目录data/profiles/{档案ID}/下样本保存为.wav文件元数据则记录在 SQLite 数据库voicebox.db中。 正因为档案由音频文件 数据库记录两部分组成Voicebox 才设计了 ZIP 打包导出机制让备份与共享变得一键完成。二、一键导出声音档案生成 .voicebox.zip 备份文件导出是备份和共享的第一步操作极其简单打开 Voicebox进入Voices声音标签页找到目标档案卡片点击卡片上的下载Download图标按钮在弹出的系统保存对话框中选择位置即得到形如profile-你的名字.voicebox.zip的备份文件。ZIP 包里有什么解压后你会看到profile-你的名字.voicebox.zip ├── manifest.json # 档案名称、描述、语言等元数据 ├── samples.json # 样本文件名 → 参考文本 的映射 ├── samples/ # 所有参考音频 .wav 文件 └── avatar.* # 档案头像可选有头像才会包含这一打包逻辑由后端模块 backend/services/export_import.py 实现对应 API 端点为GET /profiles/{档案ID}/export路由定义见 backend/routes/profiles.py。✅建议每当给档案新增或修改样本后就重新导出一次始终保持备份是最新的。三、导入声音档案三步完成恢复与接收共享导入Import与导出互为镜像无论是自己换电脑恢复还是接收朋友分享的档案流程都一样在主编辑区点击Import导入按钮在文件选择框中选中.voicebox.zip文件点击确认等待导入完成——新档案立即出现在声音列表中。几个你可能遇到的细节重名自动处理如果已存在同名档案Voicebox 会自动追加编号例如张三 (1)、张三 (2)不会覆盖原有档案大小限制导入文件上限为100MB样本过多时请先清理不需要的音频头像可选ZIP 中的头像导入失败不会中断流程档案与样本依然正常恢复格式校验样本必须为.wav文件且与samples.json一一对应结构不完整的压缩包会被拒绝并提示具体原因。前端导入逻辑位于 app/src/lib/hooks/useProfiles.ts 的useImportProfile后端入口为POST /profiles/import。四、手动完整备份复制 data 目录一次带走所有声音ZIP 导出适合单档案分享而整机迁移或定期备份时直接复制数据目录最省心data/ ├── voicebox.db # SQLite 数据库档案、历史、设置等全部元数据 ├── profiles/ # 所有克隆档案的参考音频 ├── generations/ # 已生成的语音成品 └── captures/ # 听写捕获的录音备份要点⚠️先停止 Voicebox 服务再复制避免数据库写入中断整个data目录复制到外部硬盘或网盘即可恢复时放回原位置该目录结构定义见 backend/config.py 中的get_profiles_dir等函数完整说明参考官方开发者文档 docs/content/docs/developer/voice-profiles.mdx。五、共享声音档案把 ZIP 发给朋友共享其实就是导出 发送 对方导入你按第二节导出档案 ZIP通过网盘、聊天工具等任意方式发送给对方文件通常只有几 MB对方在 Voicebox 中按第三节流程导入即刻获得与你相同的克隆声音。 注意导出只包含档案本身样本、名称、头像不包含生成历史。若想让对方使用你的声音档案备份就够了。六、附赠技巧导出与导入历史生成记录除了档案Voicebox 还支持对单条生成记录做 ZIP 打包包含所有版本音频与效果链配置历史页面提供导入对话框可以把别人分享的生成记录恢复到本地历史中。适合做作品集归档或跨设备迁移成品语音。常见问题 FAQQ1导出的 ZIP 发给别人对方声音会不一样吗不会。样本音频和参考文本完整打包导入后克隆效果与你本地一致需对方已安装相同克隆引擎。Q2导入后为什么档案名叫某某 (1)说明你已有同名档案这是防覆盖保护。可编辑档案重命名后删除旧档案。Q3备份文件会越来越大吗样本以 WAV 保存30 秒 24kHz 音频约 1~2MB几十个样本的档案通常远小于 100MB 上限无需担心。Q4我可以直接修改 ZIP 里的样本吗可以。替换samples/中的.wav文件并确保samples.json中文件名与参考文本对应后重新导入即可。一句话总结日常单档案共享用ZIP 导出/导入换电脑或定期保险用整目录备份 data/。两种方法配合你的每一个克隆声音都能安全流转、永不丢失。【免费下载链接】voiceboxThe open-source AI voice studio. Clone, dictate, create.项目地址: https://gitcode.com/GitHub_Trending/voicebox1/voicebox创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考