更新一些自述文件

src/logging.c

@@ -16,9 +16,9 @@
 #define RESET  "\033[0m"
 #define CYAN   "\033[0;36m"
 
-#define LOG_BUFFER_SIZE 1024
+#define LOG_BUFFER_SIZE 1024 // 日志缓冲区大小，单个日志长度不能超过该值
 
-Logger *G_LOGGER = NULL;
+static Logger *G_LOGGER = NULL; // 全局日志对象，唯一实例
 
 /**
  * @brief 为日志添加一个handler
@@ -38,6 +38,10 @@ static bool addHandler(log_Handler *handler) {
     return true;
 }
 
+/**
+ * @brief 为日志添加一个filter
+ * @param filter 过滤器对象
+ */
 static bool addFilter(log_filter *filter) {
     if (G_LOGGER == NULL || filter == NULL) {
         return false;
@@ -58,6 +62,13 @@ static bool addFilter(log_filter *filter) {
     return true;
 }
 
+/**
+ * @brief 输出到handler
+ * @param handler 处理器对象
+ * @param level 日志等级
+ * @param color 应用的颜色
+ * @param message 日志内容
+ */
 static void output_to_handler(log_Handler *handler,
                               char        *level,
                               const char  *color,