Mike-Solar
66d761b4b7
- app/ no longer includes engine C++ headers nor holds engine C++ types: engine access goes through the oakengine C ABI plus C++ wrappers (oakutil/oaknode.h, oakutil/oakvideo.h) and app-local mirror types (tooltypes, trackreferencehandle, timelinecommonapp, keyframetypes, subtitleapp, serializedlayoutinfoapp, nodevaluehandle, sliderdisplaytypeapp) - engine: new C ABI functions for block/track/clip/transition navigation and predicates, links, caches, waveform/playback, disk folder, sequence_track_list, node_free, footage_is_valid, block_get_track, get_brush; loadotio/saveotio ported to the current engine API - OTIO is now a required dependency: CI and CD build it on every platform, FindOpenTimelineIO fixed for OTIO 0.16/0.19 (the old deps include requirement silently disabled OTIO everywhere), runtime libraries are bundled into packages and copied next to macOS binaries (oak_copy_otio_runtime) - fix ProjectViewModel drag&drop mime read/write size mismatch (segfault) - unify color label naming (k_olive -> "Oak") in the app-side mirror - docs: OTIO required, FFmpeg minimum corrected to 6.0 (en/zh) - gtest suite: 1925 passed, 0 failed
长期计划（plans）
本目录收纳 Oak 的中长期规划文档与并行执行计划。已完成的战役
文档归档在 completed/；进行中的计划在下方目录。
目录
| 文档 | 内容 | 启动前提 |
|---|---|---|
riir.md |
RIIR 绞杀者模式执行计划：C ABI 迁移完成后，把 liboakengine 安全拆成若干小模块，再逐个用 Rust 重写；含 API 冻结保证、模块图、六步流程与验证门禁 | C ABI 迁移战役验收完成 |
riir/ |
模块拆分执行手册（riir.md 第一阶段落地）：00 总览 → 01 双层适配器规范 → 02 依赖矩阵与拆分顺序 → 03 测试规范 → M1-M9 逐模块手册（C API 冻结）；只拆分不重写，模块间 C ABI | 已解锁（R7 完成），随时启动 |
ai-agent-design.md |
AI Agent 设计：多模态 LLM 经 MCP 调用策展工具面自动剪辑，渲染帧回喂形成"编辑→看图→再编辑"视觉闭环；含工具面、回放回路、安全与测试 | RIIR 拆分完成（面对一堆小库） |
gtest-migration-guide.md |
测试统一到 Google Test：把 OAK_ADD_TEST 宏框架、纯 C assert、已有 gtest 三套收敛为单一 Google Test，ctest 仅作运行器 | 已解锁（R5-R7 完成），可与 UI 改版并行 |
ui-redesign-plan.md |
主界面 UI 改版：依据 design/ 三张设计图落地 10 个工作包（工具条、双监看、效果栈检查器、节点编辑器移位、电平条、状态栏等），全部文字精确定义 |
已解锁（R5-R7 完成），可与 GTest 迁移并行 |
已完成（completed/）
C ABI 迁移战役（B1-R7，nm 557→0 + visibility 收口 3486→19）的
全套文档归档在 completed/：
- 交接：
c-abi-migration-handoff.md（v3）、-v4、-v5、-v6 - 战役记录：
facade-migration-roadmap.md - R5：
r5-app-migration-guide.md、r5-phase2-detailed-guide.md、r5-phase3-final-guide.md、r5-final-sprint.md - R6/R7：
r6-cleanup-plan.md、r7-pure-abi-plan.md
其他参考
- 构建：
docs/zh/build.md、docs/zh/build_macos-zh.md - 工程文件：
docs/zh/project-file-reference.md - 代码风格与 Google Test 要求：
CONTRIBUTING.md（仓库根）