代理剪辑¶

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

代理状态¶

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

生成代理的方法¶

Oak 提供多处入口生成/管理代理：

1. 素材管理器：选中一个或多个素材 → 右键 → 生成代理 / 使用代理 / 在文件中显示代理 / 删除代理。

2. 时间轴：选中片段 → 右键 → 代理相关菜单。

3. 全局设置：工具 > 代理设置，打开偏好设置的磁盘标签页。

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

代理设置¶

代理预设为全局设置，路径：编辑 > 偏好设置 > 磁盘。

可调参数：

代理文件存储位置¶

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

<project_cache_path>/proxy/<unique_id>-<stream_index>.<width>x<height>.v<version>.mp4

生成中的临时文件名为：

<proxy_filename>.working.mp4

代理生成过程¶

• 调用系统 PATH 中的 ffmpeg 进行转码。

• 仅转码 视频流，丢弃音频（-an）。

• 使用 libx264、-pix_fmt yuv420p、-movflags +faststart。

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

使用与禁用¶

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

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

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

导出时的行为¶

• 预览/离线渲染（RenderMode::kOffline）且代理可用时，使用代理。

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

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

限制¶

• 没有按素材独立的代理预设，只能使用全局设置。

• 代理仅包含视频，没有音频；代理主要用于画面预览。

• 生成代理依赖系统 PATH 中的 ffmpeg；如果找不到 ffmpeg，代理任务会失败。

• 当前没有独立的“代理对话框”，入口分散在项目面板、时间轴右键和偏好设置中。