# 长期计划（plans）

本目录收纳 Oak 的**中长期规划文档与并行执行计划**。已完成的战役
文档归档在 [`completed/`](completed/)；进行中的计划在下方目录。

## 目录

| 文档 | 内容 | 启动前提 |
|---|---|---|
| [`riir.md`](riir.md) | **RIIR 绞杀者模式执行计划**：C ABI 迁移完成后，把 liboakengine 安全拆成若干小模块，再逐个用 Rust 重写；含 API 冻结保证、模块图、六步流程与验证门禁 | C ABI 迁移战役验收完成 |
| [`riir/`](riir/) | **模块拆分执行手册**（riir.md 第一阶段落地）：00 总览 → 01 双层适配器规范 → 02 依赖矩阵与拆分顺序 → 03 测试规范 → M1-M9 逐模块手册（C API 冻结）；只拆分不重写，模块间 C ABI | 已解锁（R7 完成），随时启动 |
| [`ai-agent-design.md`](ai-agent-design.md) | **AI Agent 设计**：多模态 LLM 经 MCP 调用策展工具面自动剪辑，渲染帧回喂形成"编辑→看图→再编辑"视觉闭环；含工具面、回放回路、安全与测试 | RIIR 拆分完成（面对一堆小库） |
| [`gtest-migration-guide.md`](gtest-migration-guide.md) | **测试统一到 Google Test**：把 OAK_ADD_TEST 宏框架、纯 C assert、已有 gtest 三套收敛为单一 Google Test，ctest 仅作运行器 | 已解锁（R5-R7 完成），可与 UI 改版并行 |
| [`ui-redesign-plan.md`](ui-redesign-plan.md) | **主界面 UI 改版**：依据 `design/` 三张设计图落地 10 个工作包（工具条、双监看、效果栈检查器、节点编辑器移位、电平条、状态栏等），全部文字精确定义 | 已解锁（R5-R7 完成），可与 GTest 迁移并行 |

## 已完成（completed/）

C ABI 迁移战役（B1-R7，nm 557→0 + visibility 收口 3486→19）的
全套文档归档在 [`completed/`](completed/)：

- 交接：[`c-abi-migration-handoff.md`](completed/c-abi-migration-handoff.md)（v3）、`-v4`、`-v5`、`-v6`
- 战役记录：[`facade-migration-roadmap.md`](completed/facade-migration-roadmap.md)
- R5：[`r5-app-migration-guide.md`](completed/r5-app-migration-guide.md)、
  [`r5-phase2-detailed-guide.md`](completed/r5-phase2-detailed-guide.md)、
  [`r5-phase3-final-guide.md`](completed/r5-phase3-final-guide.md)、
  [`r5-final-sprint.md`](completed/r5-final-sprint.md)
- R6/R7：[`r6-cleanup-plan.md`](completed/r6-cleanup-plan.md)、
  [`r7-pure-abi-plan.md`](completed/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`（仓库根）