v0.4.1-alpha

[Mike-Solar]

Oak Video Editor v0.4.1-alpha 更新说明 / Release Notes

中文版

代理剪辑

• 新增独立的代理对话框，统一入口：工具菜单"代理设置..."、项目面板右键、时间轴片段右键；可查看各素材代理状态、批量生成/删除。
• 支持按素材独立的代理预设：单个素材可使用自定义分辨率、CRF、编码预设、封装格式和音频开关，随项目文件保存；未自定义的素材仍使用全局设置。
• 代理文件现在包含音频（AAC），预览时代理音画均可使用；导出仍始终使用原始高质量素材。
• ffmpeg 路径可配置：依次尝试 用户配置路径 → 系统 PATH → 常见安装位置（如 macOS 的 Homebrew 路径），找不到时给出明确提示。
• 偏好设置"磁盘"页新增"在代理中包含音频"和"ffmpeg 可执行文件"设置项。

LUT 与色彩

• 新增全局 LUT 库：在"偏好设置 > LUT"中管理库目录（递归扫描 .cube/.3dl）；OCIO LUT 节点的文件行提供库内容下拉选择，"其他（自定义文件）..."仍可手动指定路径。
• OCIO LUT 节点不再静默透传：文件缺失、扩展名不支持或加载失败时会在状态栏显示原因（渲染仍安全透传）。
• 重新启用 ColorDialog 中 display → reference 的逆向转换和 Display 选项卡（旧 OCIO 反向崩溃已修复并有回归测试覆盖）。
• OCIO 线性调色节点：逐帧强制 white clamp > black clamp，关键帧/连接驱动下也不会产生非法变换；静态黑位钳制时白位钳制的 UI 最小值自动跟随。

音频同步

• 波形同步精度提升：未缓存的波形区域不再按静音参与计算，互相关自动跳过无效窗口。
• 素材属性对话框新增源起始时间手动编辑（支持撤销），不再完全依赖元数据自动探测。
• 新增变速同步："按波形同步（调整速度）"在整体偏移对齐置信度不足时自动估计速率差并应用为片段速度（单次可撤销操作）。

平台与打包修复

• 修复 macOS 上语言为英语时"工具 > 首选项"菜单项不显示的问题。
• 修复视频节点直接连接输出节点时预览黑屏的问题。
• 修复 Linux 上音频后端默认直接使用 ALSA 导致没有声音的问题。
• 修复 Linux 安装包（AppImage/deb/rpm/Arch）缺少 oak-render-worker 导致渲染不可用的问题。
• 修复 Windows 安装包缺少 ffmpeg_bridge.dll（及其依赖的 FFmpeg 运行库）导致无法启动的问题。

其他

• 简体中文界面补齐了本轮所有新增面板的翻译。
• 用户手册（中英双语）与项目文件格式参考已同步更新。

────────────────────────────────────────────────────────────────────────────────

English Version

Proxy Editing

• New dedicated Proxy dialog with unified entry points: Tools menu "Proxy Settings...", project panel context menu, and timeline clip context menu; shows per-footage proxy state with batch generate/delete.
• Per-footage proxy presets: individual footage items can use custom resolution, CRF, encoder preset, container format, and audio inclusion, persisted in the project file; footage without custom settings still uses the global preset.
• Proxy files now include audio (AAC), so proxied previews carry both picture and sound; exports always use the original high-quality source.
• Configurable ffmpeg path: tries the configured path → system PATH → common install locations (e.g. Homebrew on macOS), with a clear error message when none is found.
• New "Include audio in proxies" and "ffmpeg Executable" fields in Preferences > Disk.

LUT & Color

• New global LUT library: manage library directories in Preferences > LUT (scanned recursively for .cube/.3dl); the OCIO LUT node's file row offers a picker combo of library LUTs, with "Other (Custom File)..." for arbitrary paths.
• The OCIO LUT node no longer fails silently: missing files, unsupported extensions, and load errors are reported in the status bar (rendering still passes through safely).
• Re-enabled the display → reference conversion and the Display tab in ColorDialog (the old OCIO inverse crash is fixed and covered by a round-trip regression test).
• OCIO Grading (Linear) node: the white-clamp > black-clamp invariant is now enforced per frame, so keyframed/connected values cannot produce invalid transforms; the white clamp's UI minimum tracks a static black clamp.

Audio Sync

• More accurate waveform sync: uncached waveform regions are no longer treated as silence — the correlation skips invalid windows.
• Footage Properties dialog gains a manually editable Source Start Time (undoable), so sync no longer relies solely on auto-detected metadata.
• New stretch sync: "Synchronize by Waveform (Adjust Speed)" estimates the rate difference when plain offset alignment is inconclusive and applies it as a clip speed change in a single undoable operation.

Platform & Packaging Fixes

• Fixed "Tools > Preferences" disappearing on macOS when the UI language is English.
• Fixed black preview when a video node is connected directly to the output node.
• Fixed no audio on Linux caused by the audio backend defaulting to ALSA directly.
• Fixed Linux packages (AppImage/deb/rpm/Arch) missing oak-render-worker, which broke rendering.
• Fixed the Windows installer missing ffmpeg_bridge.dll (and its FFmpeg runtime dependencies), which prevented startup.

Miscellaneous

• Simplified Chinese translations added for all new panels.
• User manual (EN/ZH) and project file format reference updated.

---

This discussion was created from the release v0.4.1-alpha.