docs: update core and debug API docs

docs/api/debug/filelogsink/flush.md

@@ -6,19 +6,22 @@ void Flush() override
 
 刷新文件缓冲区，调用底层 `FileWriter` 的 flush 方法确保所有待写入的日志数据已实际写入磁盘。
 
+**线程安全：** ✅ 线程安全
+
 **复杂度：** O(1)
 
 **示例：**
 
 ```cpp
+#include <XCEngine/Debug/FileLogSink.h>
+
 auto fileSink = std::make_unique<XCEngine::Debug::FileLogSink>("logs/app.log");
-XCEngine::Debug::Logger::Get().AddSink(std::move(fileSink));
-// 关键操作后立即刷新
-XCEngine::Debug::Logger::Get().Info(XCEngine::Debug::LogCategory::General, "Checkpoint saved");
-// 确保写入磁盘
-XCEngine::Debug::Logger::Get().Flush();
+// 关键操作后立即刷新确保写入磁盘
+fileSink->Flush();
 ```
 
+**注意：** `Flush()` 需要直接调用 `FileLogSink` 实例，不能通过 `Logger` 调用。
+
 ## 相关文档
 
 - [FileLogSink 总览](filelogsink.md) - 返回类总览