文件与备份
Vfinity 在本机保存设置的位置、备份内容及不会离开电脑的信息
Vfinity 保存的数据都在本机。备份会将你选择的部分打包为一个文件，可用于留存、迁移到其他电脑或日后恢复。
数据保存位置
Vfinity 的文件夹以应用 ID com.zyphite.vfinity 命名。
| 系统 | 文件夹 |
|---|---|
| Windows | %APPDATA%\com.zyphite.vfinity |
| macOS | ~/Library/Application Support/com.zyphite.vfinity |
| Linux | ~/.local/share/com.zyphite.vfinity；下面的小型文件也可能在 ~/.config/com.zyphite.vfinity |
| 文件或文件夹 | 内容 |
|---|---|
overlay_assets | 你为叠加层、提醒、投掷、动作步骤和快捷面板上传的声音、图片与视频 |
docs/history | 每场直播一份历史文件 |
overlay_port.txt | 叠加层服务器端口 |
overlay_network.json | 局域网访问状态及访问密钥 |
desktop_prefs.json | 窗口打开前读取的托盘与启动偏好 |
其余设置、事件、投掷场景、主题、组件和统计数据保存在应用窗口自身的存储中。请用备份迁移，而不是手动复制文件夹。
备份包含什么
打开 设置偏好与数据数据管理，选择导出备份。对话框列出以下部分，大部分默认选中。
| 部分 | 默认选中 | 内容 |
|---|---|---|
| 连接与偏好 | 是 | VTube Studio 和直播平台连接设置、API 服务器、自动连接与调试模式 |
| 事件映射 | 是 | 所有事件及其动作步骤或蓝图，包括开启状态 |
| 快捷面板 | 是 | 按键及其声音和图片 |
| 投掷场景 | 是 | 可投掷物和物品库、礼物规则、身体部位与碰撞区，及图片和声音 |
| 外观与主题 | 是 | 当前主题、自定义主题、浅色或深色模式及背景图片 |
| 语言 | 是 | 应用语言 |
| 叠加层组件 | 是 | 所有组件设置及上传的文件、你的收藏和合集，以及已保存的样式预设 |
| 互动组件 | 否 | 礼物罐内容、投票、观众队列、抽奖参与者和游戏分数，含观众名称 |
| 直播配置 | 是 | 所有已保存的配置及其文件 |
| 文本转语音 | 是 | 声音、提供商和朗读设置，笑的写法与自定义笑声，以及观众声音分配；不含 API 密钥 |
| 直播统计数据 | 是 | 历史总数和积分余额，含头部观众名称 |
| 积分体系 | 是 | 点赞、评论、分享、关注和钻石的积分比率 |
| 倒计时 | 否 | 剩余时间；恢复后始终暂停 |
| 全局快捷键 | 是 | 快捷键及其运行的命令 |
选择要包含在备份文件中的内容。
密码与令牌
只有勾选包含密码和令牌后，下列凭据才进入备份，以便恢复后无需重新登录：
- VTube Studio 令牌
- OBS 服务器密码
- Streamer.bot 密码
- Webhook 的授权请求头值
- Twitch 和 Kick 登录凭据，以及 Kick 客户端密钥
- 本地 API 令牌
如果不包含凭据，恢复后本地 API 会关闭。文本转语音 API 密钥始终不包含在备份中，恢复时保留本机已有密钥。
妥善保管包含密码的备份
任何持有勾选包含密码和令牌后制作的备份的人，都能使用其中凭据并控制你的 VTube Studio 插件。不要分享或公开上传。
始终不包含在备份中
- 直播历史
- 本场直播的实时数据及目标当前进度
- 触发器里程碑和首次发言历史
- 仪表板布局
- 设置向导的进度
- 你在聊天窗口中给观众起的私人昵称
恢复备份
打开文件
在 设置偏好与数据数据管理 选择导入备份，然后点击打开文件…。在更改任何内容前，Vfinity 会显示文件的版本、制作时间及内容。
选择要恢复的部分
选中的部分会替换当前内容。对于事件映射，可选择替换现有事件或追加导入。
开始恢复
点击恢复。部分设置立即生效；其他部分需要重新加载应用，之后应用会重新连接服务。
| 事件映射选项 | 结果 |
|---|---|
| 替换我的映射 | 用文件中的事件替换现有事件 |
| 添加到我的映射 | 将文件中的事件接在现有事件之后；跳过已有事件 |
追加时，冲突的 ID 会重新生成。VTube Studio 快捷键按当前模型中的名称匹配，未匹配成功的事件会以关闭状态导入。
分享部分设置
分享映射或小组件可将事件，或带有上传文件的单个叠加层组件，另存为供他人使用的文件。对方通过导入备份打开；共享组件只修改该组件。
| 文件 | 创建方式 |
|---|---|
| 备份 | 导出备份 |
| 共享事件映射 | 分享映射或小组件 |
| 共享组件 | 分享映射或小组件 |
| 单个事件 | 蓝图编辑器中的导出 |
单个事件的文件是只包含这一个事件的共享事件映射文件，带有它的触发器及其用到的声音和媒体。文件名以 vfinity-event- 开头，后接事件名称和日期。可在任意蓝图中用导入打开，也可以通过导入备份打开。
格式版本
备份采用格式 7。Vfinity 2.0 可恢复格式 1 至 7，因此旧版本备份仍能打开，较新功能会使用默认值。