添加了注释文档

src/Ast/Ast.hpp

@@ -0,0 +1,8 @@
+/*!
+    @file src/Ast/Ast.hpp
+    @brief Ast总链接
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-14
+*/
+
+#pragma once

src/Deps/Deps.hpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Deps/Deps.hpp
+    @brief 依赖库集合
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-13
+*/
+
 #pragma once
 
 #include <Core/CoreInfos.hpp>

src/Deps/HashMap/HashMap.hpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Deps/HashMap/HashMap.hpp
+    @brief 依赖库HashMap定义
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-13
+*/
+
 #pragma once
 
 #include <unordered_map>

src/Deps/String/CharUtils.hpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Deps/String/CharUtils.hpp
+    @brief char32_t type实现
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-13
+*/
+
 #pragma once
 
 namespace Fig::Deps

src/Deps/String/String.hpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Deps/String/String.hpp
+    @brief UTF32/Pure ASCII + SSO优化的字符串实现
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-13
+*/
+
 #pragma once
 
 #include <cstdint>

src/Deps/String/StringTest.cpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Deps/String/StringTest.cpp
+    @brief String类测试代码
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-13
+*/
+
 #include <cassert>
 #include <iostream>
 #include "String.hpp"

src/Error/Error.cpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Error/Error.cpp
+    @brief 错误报告实现
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-14
+*/
+
 #include <Core/Core.hpp>
 #include <Error/Error.hpp>
 

src/Error/Error.hpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Error/Error.hpp
+    @brief Error定义
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-13
+*/
+
 #pragma once
 
 #include <Deps/Deps.hpp>

src/Lexer/Lexer.cpp

@@ -1,3 +1,9 @@
+/*!
+    @file src/Lexer/Lexer.cpp
+    @brief 词法分析器(materialized lexeme)实现
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-14
+*/
 #include <Lexer/Lexer.hpp>
 
 namespace Fig

src/SourceManager/SourceManager.hpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/SourceManager/SourceManager.hpp
+    @brief 源代码管理
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-14
+*/
+
 #pragma once
 
 #include <Deps/Deps.hpp>

src/Token/Token.cpp

@@ -1,3 +1,9 @@
+/*!
+    @file src/Token/Token.cpp
+    @brief Token实现
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-14
+*/
 #include <Token/Token.hpp>
 
 namespace Fig
@@ -87,4 +93,4 @@ namespace Fig
         {String("false"), TokenType::LiteralFalse},
         {String("null"), TokenType::LiteralNull},
     };
-};
+}; // namespace Fig

src/Token/Token.hpp

@@ -1,3 +1,10 @@
+/*!
+    @file src/Token/Token.hpp
+    @brief Token定义
+    @author PuqiAR (im@puqiar.top)
+    @date 2026-02-14
+*/
+
 #pragma once
 
 #include <cstdint>