docs: update core and debug API docs

docs/api/core/refcounted/AddRef.md

@@ -4,34 +4,40 @@
 void AddRef();
 ```
 
-增加引用计数。
+原子地增加引用计数。
 
 **描述**
 
 原子地增加引用计数。在复制 `RefCounted` 指针或传递引用时调用此方法。
 
+**线程安全：** ✅
+
 **复杂度：** O(1)
 
 **示例：**
 
 ```cpp
 #include <XCEngine/Core/RefCounted.h>
+#include <cstdio>
 
-class MyObject : public RefCounted {
+class MyObject : public XCEngine::Core::RefCounted {
 public:
-    void DoSomething() { /* ... */ }
+    void DoSomething() { }
 };
 
-// 创建对象（构造时 refCount = 1）
-MyObject* obj = new MyObject();
-
-// 手动增加引用
-obj->AddRef();  // refCount = 2
-obj->AddRef();  // refCount = 3
-
-// 需要释放额外的引用
-obj->Release();  // refCount = 2
-obj->Release();  // refCount = 1
+int main() {
+    MyObject* obj = new MyObject();
+    printf("After create: %u\n", obj->GetRefCount());
+    
+    obj->AddRef();
+    printf("After AddRef: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    printf("After Release: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    return 0;
+}
 ```
 
 ## 相关文档

docs/api/core/refcounted/GetRefCount.md

@@ -12,28 +12,36 @@ uint32_t GetRefCount() const;
 
 **返回：** `uint32_t` - 当前引用计数
 
+**线程安全：** ✅
+
 **复杂度：** O(1)
 
 **示例：**
 
 ```cpp
 #include <XCEngine/Core/RefCounted.h>
+#include <cstdio>
 
-class MyObject : public RefCounted {
+class MyObject : public XCEngine::Core::RefCounted {
 public:
     void Debug() {
         printf("RefCount: %u\n", GetRefCount());
     }
 };
 
-MyObject* obj = new MyObject();
-printf("After create: %u\n", obj->GetRefCount());  // 1
-
-obj->AddRef();
-printf("After AddRef: %u\n", obj->GetRefCount());  // 2
-
-obj->Release();
-printf("After Release: %u\n", obj->GetRefCount()); // 1
+int main() {
+    MyObject* obj = new MyObject();
+    printf("After create: %u\n", obj->GetRefCount());
+    
+    obj->AddRef();
+    printf("After AddRef: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    printf("After Release: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    return 0;
+}
 ```
 
 ## 相关文档

docs/api/core/refcounted/Release.md

@@ -4,33 +4,40 @@
 void Release();
 ```
 
-减少引用计数。
+原子地减少引用计数。
 
 **描述**
 
 原子地减少引用计数。当引用计数归零时，对象会自动 `delete this`。这是实现自动内存管理的关键方法。
 
-**复杂度：** O(1)（归零时为 O(n)，n 为对象大小）
+**线程安全：** ✅
+
+**复杂度：** O(1)
 
 **示例：**
 
 ```cpp
 #include <XCEngine/Core/RefCounted.h>
+#include <cstdio>
 
-class MyObject : public RefCounted {
+class MyObject : public XCEngine::Core::RefCounted {
 public:
-    void DoSomething() { /* ... */ }
+    void DoSomething() { }
 };
 
-// 创建对象（构造时 refCount = 1）
-MyObject* obj = new MyObject();
-
-// 手动增加引用
-obj->AddRef();  // refCount = 2
-
-// 释放引用
-obj->Release();  // refCount = 1
-obj->Release();  // refCount = 0, 对象被自动 delete
+int main() {
+    MyObject* obj = new MyObject();
+    printf("After create: %u\n", obj->GetRefCount());
+    
+    obj->AddRef();
+    printf("After AddRef: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    printf("After Release: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    return 0;
+}
 ```
 
 ## 相关文档

docs/api/core/refcounted/refcounted.md

@@ -4,6 +4,8 @@
 
 **类型**: `class`
 
+**头文件**: `XCEngine/Core/RefCounted.h`
+
 **描述**: 引用计数基类，提供线程安全的引用计数生命周期管理。
 
 ## 概述
@@ -14,28 +16,39 @@
 
 | 方法 | 描述 |
 |------|------|
-| `RefCounted()` | 构造函数，初始引用计数为 1 |
-| `virtual ~RefCounted()` | 虚析构函数 |
-| [`AddRef`](AddRef.md) | 增加引用计数 |
-| [`Release`](Release.md) | 减少引用计数（归零时自动 delete this） |
-| [`GetRefCount`](GetRefCount.md) | 获取当前引用计数 |
+| [`RefCounted()`](refcounted.md) | 构造函数，初始引用计数为 1 |
+| [`~RefCounted()`](refcounted.md) | 虚析构函数 |
+| [`AddRef()`](AddRef.md) | 增加引用计数 |
+| [`Release()`](Release.md) | 减少引用计数（归零时自动 delete this） |
+| [`GetRefCount()`](GetRefCount.md) | 获取当前引用计数 |
 
 ## 使用示例
 
 ```cpp
-class MyObject : public RefCounted {
+#include <XCEngine/Core/RefCounted.h>
+#include <cstdio>
+
+class MyObject : public XCEngine::Core::RefCounted {
 public:
-    MyObject() { /* ... */ }
-    ~MyObject() { /* ... */ }
+    MyObject() { }
+    virtual ~MyObject() { }
     
-    void DoSomething() { /* ... */ }
+    void DoSomething() { }
 };
 
-// 使用
-MyObject* obj = new MyObject();  // refCount = 1
-obj->AddRef();                   // refCount = 2
-obj->Release();                   // refCount = 1
-obj->Release();                   // refCount = 0, 自动 delete
+int main() {
+    MyObject* obj = new MyObject();
+    printf("After create: %u\n", obj->GetRefCount());
+    
+    obj->AddRef();
+    printf("After AddRef: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    printf("After Release: %u\n", obj->GetRefCount());
+    
+    obj->Release();
+    return 0;
+}
 ```
 
 ## 相关文档