docs: rebuild Debug API content

docs/api/XCEngine/Debug/LogEntry/LogEntry.md

@@ -6,32 +6,34 @@
 
 **头文件**: `XCEngine/Debug/LogEntry.h`
 
-**描述**: 定义 `XCEngine/Debug` 子目录中的 `LogEntry` public API。
+**描述**: 承载单条日志记录的结构体。
 
 ## 概述
 
-`LogEntry.h` 是 `XCEngine/Debug` 子目录 下的 public header，当前页面作为平行目录中的 canonical 总览，用于汇总该头文件暴露的主要声明。
+`LogEntry` 是 `Logger` 与各类 sink 之间传递日志数据的统一载体。调用方通常不会手动构造它，而是通过 `Logger::Log` 或便捷方法间接生成；sink 实现则读取其中的字段决定如何格式化输出。
 
-## 声明概览
+## 字段说明
 
-| 声明 | 类型 | 说明 |
+| 字段 | 类型 | 说明 |
 |------|------|------|
-| `LogEntry` | `struct` | 头文件中的公开声明。 |
+| `level` | `LogLevel` | 日志严重级别。 |
+| `category` | `LogCategory` | 日志功能域。 |
+| `message` | `Containers::String` | 最终日志文本。 |
+| `file` | `Containers::String` | 源文件路径；只有显式传入时才有值。 |
+| `line` | `int32_t` | 源码行号；便捷方法通常保留为 `0`。 |
+| `function` | `Containers::String` | 源函数名；只有显式传入时才有值。 |
+| `timestamp` | `uint64_t` | 当前实现中为 Unix epoch 秒数。 |
+| `threadId` | `uint32_t` | 当前实现中为 `std::thread::id` 哈希后的 32 位值。 |
 
-## 结构体成员
+## 当前实现说明
 
-| 成员 | 类型 | 描述 | 默认值 |
-|------|------|------|--------|
-| `level` | `LogLevel` | 结构体公开字段。 | - |
-| `category` | `LogCategory` | 结构体公开字段。 | - |
-| `message` | `Containers::String` | 结构体公开字段。 | - |
-| `file` | `Containers::String` | 结构体公开字段。 | - |
-| `line` | `int32_t` | 结构体公开字段。 | - |
-| `function` | `Containers::String` | 结构体公开字段。 | - |
-| `timestamp` | `uint64_t` | 结构体公开字段。 | - |
-| `threadId` | `uint32_t` | 结构体公开字段。 | - |
+- `Logger::Log` 会为 `timestamp` 与 `threadId` 自动填值。
+- `Logger::Verbose`、`Info` 等便捷方法调用的是带默认参数的 `Log`，因此默认不会填充 `file`、`line` 和 `function`。
+- 如果希望保留源码位置，推荐使用 `XE_LOG` 宏而不是直接调用这些便捷方法。
 
 ## 相关文档
 
-- [当前目录](../Debug.md) - 返回 `Debug` 平行目录
-- [API 总索引](../../../main.md) - 返回顶层索引
+- [当前模块](../Debug.md)
+- [Logger](../Logger/Logger.md)
+- [ILogSink](../ILogSink/ILogSink.md)
+- [Logging Architecture](../../../_guides/Debug/Logging-Architecture.md)