docs: define api doc tree refactor phases

docs/api/XCEngine/Editor/Editor.md

@@ -69,6 +69,12 @@
 - 这套代码整体属于应用层源码，不应误解为已经整理成稳定插件 SDK。
 - 自动审计脚本目前主要覆盖 `engine/include/XCEngine/**` 的 public headers；Editor 这组文档更依赖目录并行约束、链接校验和人工核对源码行为。
 
+## 文档边界更新（2026-04-09）
+
+- `docs/api/XCEngine/Editor/**` 当前严格对应旧 `editor/src/**`。
+- `new_editor/include/XCEditor/**` 与 `new_editor/src/**` 已经形成新的 Editor 基础层主线，不再适合继续并入这棵旧树。
+- 后续会为 `XCEditor` 单独建立新的 API 文档根树，并把 `Collections / Fields / Foundation / Shell / Widgets` 迁到新结构下。
+
 ## 目录
 
 - [Application](Application/Application.md) - 顶层编辑器应用入口。