docs: update RHI API docs

docs/api/rhi/command-queue/command-queue.md

@@ -2,49 +2,73 @@
 
 **命名空间**: `XCEngine::RHI`
 
-**类型**: `class` (abstract)
+**类型**: `class` (抽象基类)
+
+**头文件**: `XCEngine/RHI/RHICommandQueue.h`
 
 **描述**: GPU 命令队列抽象接口，负责提交和执行命令列表，以及 GPU/CPU 同步。
 
+## 概述
+
+`RHICommandQueue` 是 RHI（Render Hardware Interface）系统中的核心抽象接口之一，封装了底层图形 API（D3D12/Vulkan/Metal 等）的命令队列功能。
+
+主要职责：
+- **命令提交**：将准备好的命令列表提交到 GPU 执行
+- **GPU/CPU 同步**：通过栅栏（Fence）机制协调 CPU 和 GPU 的执行顺序
+- **队列类型管理**：区分直接队列、计算队列和复制队列
+
+使用场景：
+- 渲染循环中提交绘制命令
+- 资源在 GPU 和 CPU 之间传输时的同步
+- 多线程渲染时的命令生成和提交
+
 ## 公共方法
 
 | 方法 | 描述 |
 |------|------|
 | [`Shutdown`](shutdown.md) | 关闭并释放资源 |
 | [`ExecuteCommandLists`](execute-command-lists.md) | 执行命令列表 |
-| [`Signal`](signal.md) | 信号栅栏 |
-| [`Wait`](../../threading/task-group/wait.md) | 等待栅栏 |
-| [`GetCompletedValue`](get-completed-value.md) | 获取完成值 |
-| [`WaitForIdle`](wait-for-idle.md) | 等待空闲 |
+| [`Signal`](signal.md) | 向栅栏发送信号 |
+| [`Wait`](wait.md) | 等待栅栏达到指定值 |
+| [`GetCompletedValue`](get-completed-value.md) | 获取栅栏已完成的值 |
+| [`WaitForIdle`](wait-for-idle.md) | 等待队列所有操作完成 |
 | [`GetType`](get-type.md) | 获取队列类型 |
 | [`GetTimestampFrequency`](get-timestamp-frequency.md) | 获取时间戳频率 |
 | [`GetNativeHandle`](get-native-handle.md) | 获取原生句柄 |
 
-## 命令队列类型 (CommandQueueType)
-
-| 枚举值 | 描述 |
-|--------|------|
-| `Direct` | 直接队列，用于图形和计算命令 |
-| `Compute` | 计算队列，专门用于计算着色器 |
-| `Copy` | 复制队列，专门用于资源复制 |
-
 ## 使用示例
 
 ```cpp
-CommandQueueDesc queueDesc;
-queueDesc.queueType = (uint32_t)CommandQueueType::Direct;
-RHICommandQueue* commandQueue = device->CreateCommandQueue(queueDesc);
+#include "RHICommandQueue.h"
+#include "RHIDevice.h"
+#include "RHIFence.h"
+#include "RHICommandList.h"
 
-FenceDesc fenceDesc;
-RHIFence* fence = device->CreateFence(fenceDesc);
+void RenderLoop(RHIDevice* device, RHICommandQueue* cmdQueue) {
+    CommandQueueDesc queueDesc;
+    queueDesc.queueType = (uint32_t)CommandQueueType::Direct;
+    RHICommandQueue* commandQueue = device->CreateCommandQueue(queueDesc);
 
-commandQueue->ExecuteCommandLists(1, (void**)&commandList);
-commandQueue->Signal(fence, 1);
-fence->Wait(1);
+    FenceDesc fenceDesc;
+    RHIFence* fence = device->CreateFence(fenceDesc);
+
+    RHICommandList* commandList = device->CreateCommandList();
+    commandList->Begin();
+    commandList->DrawInstanced(vertices, vertexCount, 0);
+    commandList->End();
+
+    void* lists[1] = { commandList };
+    commandQueue->ExecuteCommandLists(1, lists);
+    commandQueue->Signal(fence, 1);
+    fence->Wait(1);
+
+    commandQueue->WaitForIdle();
+    commandQueue->Shutdown();
+}
 ```
 
 ## 相关文档
 
-- [../rhi/rhi.md](../rhi.md) - RHI 模块总览
+- [RHI 模块](../rhi.md) - RHI 模块总览
 - [RHICommandList](../command-list/command-list.md) - 命令列表
 - [RHIFence](../fence/fence.md) - 同步栅栏