代理剪辑¶

代理（Proxy）是高分辨率素材的低码率/低分辨率副本。在剪辑 4K/8K 或高码率素材时，使用代理可以显著提升时间线预览与节点编辑的流畅度。导出时 Oak 会自动回退到原始高质量源文件。

代理状态¶

每个素材的代理可能有以下状态：

生成代理的方法¶

Oak 提供独立的 代理对话框（Proxy dialog），可从以下入口打开：

1. 工具 > 代理设置...。

2. 项目面板：选中一个或多个素材 → 右键 → 代理 → 代理设置...。

3. 时间轴：选中片段 → 右键 → 代理 → 代理设置...。

对话框中显示全局代理设置，可为选中的素材设置单独的自定义参数，并提供 生成 / 删除 按钮。

项目面板和时间轴右键菜单中的单项操作（生成代理 / 使用代理 / 显示代理 / 删除代理）仍然保留，便于快速处理。

在项目面板中选中素材后右键，可看到“生成代理”“使用代理”等选项；也可在时间轴上选中片段右键，或同时选中多个素材批量处理。¶

代理设置¶

代理设置默认为 全局设置，位于 编辑 > 偏好设置 > 磁盘 中的 代理设置 分组。每个素材可以通过代理对话框设置自定义参数来覆盖全局设置，自定义参数会随项目文件保存。

可调参数：

未配置路径时，ffmpeg 按以下顺序自动检测：

1. 已配置的路径（如果已设置且可用）。

2. 系统 PATH。

3. 常见安装位置，如 macOS 上的 /opt/homebrew/bin/ffmpeg、/usr/local/bin/ffmpeg，应用程序所在目录，以及 /usr/bin。

代理文件存储位置¶

代理文件保存在项目磁盘缓存目录下的 proxy/ 子目录中：

<project_cache_path>/proxy/<unique_id>-<stream>.<W>x<H>.v<version>.a<0|1>.<ext>

其中 a 标记记录代理是否包含音频：包含为 a1，否则为 a0。

生成中的临时文件名为：

<proxy_filename>.working.mp4

代理生成过程¶

• Oak 调用 ffmpeg 进行转码（自动检测顺序见上文）。

• 首先映射所选视频流，使其在代理中成为 0 号流。

• 开启“在代理中包含音频”时，源文件的所有音频流会映射在视频流之后，并编码为 AAC 128 kbps；否则丢弃音频（-an）。

• 视频编码使用 libx264、-pix_fmt yuv420p、-movflags +faststart。

• 后台任务会显示在任务管理器中，生成完成后状态变为 ready。

使用与禁用¶

• 使用代理：开启后，该素材在时间线预览和节点编辑时使用代理文件。

• 可再次右键取消 使用代理，恢复使用原始源文件。

• 代理状态会随项目一起保存到 .ove 文件中。

导出时的行为¶

• 预览/离线渲染（RenderMode::kOffline）且代理可用时，使用代理；代理中包含音频时，离线预览也会解码代理的音频。

• 导出（RenderMode::kOnline）时 强制使用原始高质量源文件，不会使用代理。

• 因此无需担心代理影响最终画质。

限制¶

• 代理仅用于预览/离线渲染，导出始终使用原始高质量源文件。