From 51e831cc6a56de79acf50fec75124d37816940c1 Mon Sep 17 00:00:00 2001
From: PuqiAR <PuqiAR@qq.com>
Date: Sat, 14 Feb 2026 15:32:11 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E4=BA=86=E6=B3=A8=E9=87=8A?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/Ast/Ast.hpp                     | 8 ++++++++
 src/Deps/Deps.hpp                   | 7 +++++++
 src/Deps/HashMap/HashMap.hpp        | 7 +++++++
 src/Deps/String/CharUtils.hpp       | 7 +++++++
 src/Deps/String/String.hpp          | 7 +++++++
 src/Deps/String/StringTest.cpp      | 7 +++++++
 src/Error/Error.cpp                 | 7 +++++++
 src/Error/Error.hpp                 | 7 +++++++
 src/Lexer/Lexer.cpp                 | 6 ++++++
 src/SourceManager/SourceManager.hpp | 7 +++++++
 src/Token/Token.cpp                 | 8 +++++++-
 src/Token/Token.hpp                 | 7 +++++++
 12 files changed, 84 insertions(+), 1 deletion(-)
 create mode 100644 src/Ast/Ast.hpp

diff --git a/src/Ast/Ast.hpp b/src/Ast/Ast.hpp
new file mode 100644
index 0000000..1bdffcd
--- /dev/null
+++ b/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
diff --git a/src/Deps/Deps.hpp b/src/Deps/Deps.hpp
index 25bd1fc..57033d7 100644
--- a/src/Deps/Deps.hpp
+++ b/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>
diff --git a/src/Deps/HashMap/HashMap.hpp b/src/Deps/HashMap/HashMap.hpp
index bc74f88..a1a3cc5 100644
--- a/src/Deps/HashMap/HashMap.hpp
+++ b/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>
diff --git a/src/Deps/String/CharUtils.hpp b/src/Deps/String/CharUtils.hpp
index acf82bd..7280812 100644
--- a/src/Deps/String/CharUtils.hpp
+++ b/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
diff --git a/src/Deps/String/String.hpp b/src/Deps/String/String.hpp
index c5cf6c1..4ba073d 100644
--- a/src/Deps/String/String.hpp
+++ b/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>
diff --git a/src/Deps/String/StringTest.cpp b/src/Deps/String/StringTest.cpp
index a633859..aff81b6 100644
--- a/src/Deps/String/StringTest.cpp
+++ b/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"
diff --git a/src/Error/Error.cpp b/src/Error/Error.cpp
index 551f592..8228504 100644
--- a/src/Error/Error.cpp
+++ b/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>
 
diff --git a/src/Error/Error.hpp b/src/Error/Error.hpp
index 75748ca..189ab3e 100644
--- a/src/Error/Error.hpp
+++ b/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>
diff --git a/src/Lexer/Lexer.cpp b/src/Lexer/Lexer.cpp
index 290a7c9..b472a5f 100644
--- a/src/Lexer/Lexer.cpp
+++ b/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
diff --git a/src/SourceManager/SourceManager.hpp b/src/SourceManager/SourceManager.hpp
index fed79a3..a49db27 100644
--- a/src/SourceManager/SourceManager.hpp
+++ b/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>
diff --git a/src/Token/Token.cpp b/src/Token/Token.cpp
index 7524959..960f05e 100644
--- a/src/Token/Token.cpp
+++ b/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},
     };
-};
\ No newline at end of file
+}; // namespace Fig
\ No newline at end of file
diff --git a/src/Token/Token.hpp b/src/Token/Token.hpp
index a62f25c..dc982b1 100644
--- a/src/Token/Token.hpp
+++ b/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>