docs: update math API docs

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

@@ -4,21 +4,35 @@
 bool Intersects(const Ray& ray, float& t) const
 ```
 
-检测盒是否与射线相交。
+检测盒体是否与射线相交。如果相交，通过 `t` 输出射线原点到交点的距离。
 
 **参数：**
-- `ray` - 射线
-- `t` - 输出交点距离
+- `ray` - 要检测的射线
+- `t` - 输出交点距离（如果返回 true）
 
-**返回：** `bool` - true 表示相交
+**返回：** `bool` - 相交返回 true，否则返回 false
+
+**线程安全：** ✅
 
 **复杂度：** O(1)
 
 **示例：**
 
 ```cpp
+#include <XCEngine/Math/Box.h>
+#include <XCEngine/Math/Ray.h>
+
+using namespace XCEngine::Math;
+
+Box box(Vector3(0.0f, 0.0f, 0.0f), Vector3(1.0f, 1.0f, 1.0f));
+Ray ray(Vector3(0.0f, 0.0f, -5.0f), Vector3(0.0f, 0.0f, 1.0f));
 float t;
 if (box.Intersects(ray, t)) {
-    Vector3 hit = ray.GetPoint(t);
+    Vector3 hitPoint = ray.GetPoint(t);
 }
 ```
+
+## 相关文档
+
+- [Box 类总览](box.md) - 返回类总览
+- [Ray::Intersects](../ray/ray.md) - 射线相交检测