docs: 重构 API 文档结构并修正源码准确性

- 重组文档目录结构: 每个模块的概述页移动到模块子目录
- 重命名 index.md 为 main.md
- 修正所有模块文档中的错误:
  - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式
  - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节
  - core: 修复 types 链接错误
  - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI
  - memory: 修复头文件路径, malloc vs operator new, 新增方法文档
  - resources: 修复 Shader/Texture 链接错误
  - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接
- 验证: fix_links.py 确认 0 个断裂引用

docs/api/rhi/opengl/swap-chain/swap-chain.md

@@ -0,0 +1,34 @@
+# OpenGLSwapChain
+
+**命名空间**: `XCEngine::RHI`
+
+**描述**: OpenGL 交换链实现，继承自 `RHISwapChain`。
+
+## 方法列表
+
+| 方法 | 文档 |
+|------|------|
+| `Initialize` (vsync) | [详细文档](../../../threading/task-system/initialize.md) |
+| `Initialize` (mode) | [详细文档](initialize-mode.md) |
+| `Shutdown` | [详细文档](../../../threading/task-system/shutdown.md) |
+| `Present` | [详细文档](present.md) |
+| `SwapBuffers` | [详细文档](swap-buffers.md) |
+| `Resize` | [详细文档](../../../containers/array/resize.md) |
+| `SetVSync` | [详细文档](set-vsync.md) |
+| `IsVSync` | [详细文档](is-vsync.md) |
+| `SetFullscreen` | [详细文档](set-fullscreen.md) |
+| `IsFullscreen` | [详细文档](is-fullscreen.md) |
+| `ShouldClose` | [详细文档](should-close.md) |
+| `SetShouldClose` | [详细文档](set-should-close.md) |
+| `PollEvents` | [详细文档](poll-events.md) |
+| `GetCurrentBackBufferIndex` | [详细文档](../../swap-chain/get-current-back-buffer-index.md) |
+| `GetCurrentBackBuffer` | [详细文档](../../swap-chain/get-current-back-buffer.md) |
+| `GetWidth` / `GetHeight` | [详细文档](../../buffer/get-size.md) |
+| `GetFramebufferWidth` / `GetFramebufferHeight` | [详细文档](get-framebuffer-size.md) |
+| `GetWindow` | [详细文档](get-window.md) |
+| `GetNativeHandle` | [详细文档](../../buffer/get-native-handle.md) |
+
+## 相关文档
+
+- [OpenGL 后端总览](../overview.md)
+- [RHISwapChain](../../swap-chain/swap-chain.md) - 抽象交换链接口