docs: sync api and planning docs

docs/api/XCEngine/Editor/Viewport/SceneViewportMath/BuildSceneViewportViewMatrix.md

@@ -18,11 +18,25 @@ Math::Matrix4x4 BuildSceneViewportViewMatrix(const SceneViewportOverlayData& ove
 
 ## 当前实现行为
 
-- 会把 `cameraRight / cameraUp / cameraForward` 全部归一化。
-- 矩阵前三行分别使用右、上、前方向和相机位置的点积偏移组装。
-- 当前实现不额外检查 `overlay.valid`，默认由调用方保证输入有效。
+- 会先把 `cameraRight / cameraUp / cameraForward` 全部归一化。
+- 然后用这三条基向量和 `cameraPosition` 的点积偏移组装出 view matrix 的前三行。
+- 当前实现不额外检查 `overlay.valid`；默认由调用方保证输入语义有效。
+
+## 当前语义
+
+- 该矩阵遵循当前 editor 相机的 transform 约定。
+- 从测试看，它应当与 `cameraObject.GetTransform()->GetWorldToLocalMatrix()` 保持一致。
+- 对位于相机前方的世界点，当前矩阵会把它变换到正向 view-space 深度。
+
+## 测试覆盖
+
+`tests/Editor/test_scene_viewport_overlay_renderer.cpp` 当前验证了：
+
+- 位于相机前方的世界点会保持正向 view-space 深度。
+- 返回矩阵与 Scene View 相机 transform 的 `WorldToLocalMatrix` 约定一致。
 
 ## 相关文档
 
 - [SceneViewportMath](SceneViewportMath.md)
+- [BuildSceneViewportProjectionMatrix](BuildSceneViewportProjectionMatrix.md)
 - [BuildSceneViewportViewProjectionMatrix](BuildSceneViewportViewProjectionMatrix.md)