docs: Fix memory module documentation discrepancies

- Add missing PoolAllocator class overview with methods table
- Add missing LinearAllocator class overview with methods table
- Add missing ProxyAllocator class overview with methods table
- Fix PoolAllocator::Allocate example code and comments
- Clarify ProxyAllocator::Free totalFreed calculation behavior
- Fix CreateLinearAllocator complexity from O(size) to O(1)
- Add note about Reallocate thread safety in ProxyAllocator

docs/api/memory/proxy-allocator/proxy-allocator.md

@@ -1,4 +1,38 @@
-# ProxyAllocator::ProxyAllocator
+# ProxyAllocator
+
+**命名空间**: `XCEngine::Memory`
+
+**类型**: `class`
+
+**描述**: 代理分配器，用于统计和跟踪底层分配器的分配情况。
+
+## 概述
+
+`ProxyAllocator` 包装一个底层分配器，转发所有分配请求，同时记录详细的统计信息。它线程安全（使用互斥锁保护统计数据），适合需要监控内存使用的场景。
+
+## 公共方法
+
+### 生命周期
+
+| 方法 | 描述 |
+|------|------|
+| `ProxyAllocator` | 构造代理分配器 |
+
+### 内存操作
+
+| 方法 | 描述 |
+|------|------|
+| `Allocate` | 分配内存并记录统计 |
+| `Free` | 释放内存并记录统计 |
+| `Reallocate` | 转发到底层分配器 |
+
+### 统计查询
+
+| 方法 | 描述 |
+|------|------|
+| `GetStats` | 获取详细统计信息 |
+
+## 构造函数
 
 ```cpp
 ProxyAllocator(IAllocator* underlying, const char* name);
@@ -33,4 +67,6 @@ proxy.Free(ptr);
 
 ## 相关文档
 
-- [ProxyAllocator 总览](proxy-allocator.md) - 返回类总览
+- [Memory 模块总览](../memory.md) - 返回模块总览
+- [IAllocator](../allocator/allocator.md) - 分配器接口
+- [MemoryManager](../manager/manager.md) - 内存管理器