docs: update math API docs

docs/api/math/ray/intersects-box.md

@@ -4,24 +4,38 @@
 bool Intersects(const Box& box, float& t) const
 ```
 
-检测射线是否与 OBB（有向包围盒）相交。
+检测射线是否与有向包围盒（OBB）相交。使用 slabs 方法计算交点。
 
 **参数：**
-- `box` - 要检测的 OBB 盒体
-- `t` - 输出交点的参数距离
+- `box` - 要检测的有向包围盒（OBB）
+- `t` - 输出交点的参数距离（仅在返回 true 时有效）
 
 **返回：** `bool` - 相交返回 true，否则返回 false
 
+**线程安全：** ✅
+
 **复杂度：** O(1)
 
+**异常：** 无
+
 **示例：**
 
 ```cpp
-Ray ray(cameraPosition, rayDirection);
-Box colliderBox = object.GetWorldBox();
+#include <XCEngine/Math/Ray.h>
+#include <XCEngine/Math/Box.h>
+#include <XCEngine/Math/Vector3.h>
+
+using namespace XCEngine::Math;
+
+Ray ray(Vector3(0.0f, 0.0f, 0.0f), Vector3(1.0f, 0.0f, 0.0f));
+Box box(Vector3(10.0f, 0.0f, 0.0f), Vector3(1.0f, 1.0f, 1.0f));
 float t;
-if (ray.Intersects(colliderBox, t)) {
+if (ray.Intersects(box, t)) {
     Vector3 hitPoint = ray.GetPoint(t);
-    // 处理命中
 }
 ```
+
+## 相关文档
+
+- [Ray 类总览](ray.md) - 返回类总览
+- [Box](../box/box.md) - 包围盒类型