docs: 添加了部分内容

liteyuki/utils/__init__.py

@@ -10,7 +10,8 @@ __VERSION__ = "6.2.4"  # 60201
 
 import requests
 
-from liteyuki.utils.config import load_from_yaml
+from liteyuki.utils.config import load_from_yaml, config
+from .log import init_log
 
 major, minor, patch = map(int, __VERSION__.split("."))
 __VERSION_I__ = major * 10000 + minor * 100 + patch
@@ -51,9 +52,9 @@ def init():
     if sys.version_info < (3, 10):
         nonebot.logger.error("This project requires Python3.10+ to run, please upgrade your Python Environment.")
         exit(1)
-
-    load_from_yaml("config.yml")
-    from .log import logger
+    # 在加载完成语言后再初始化日志
+    init_log()
+    nonebot.logger.info("Liteyuki is initializing...")
 
     if not os.path.exists("data/liteyuki/liteyuki.json"):
         register_bot()
@@ -73,5 +74,4 @@ $$$$$$$$/ $$$$$$/    $$/    $$$$$$$$/     $$/      $$$$$$/  $$/   $$/ $$$$$$/
         f"Run Liteyuki with Python{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro} "
         f"at {sys.executable}"
     )
-
     nonebot.logger.info(f"{__NAME__} {__VERSION__}({__VERSION_I__}) is running")

liteyuki/utils/config.py

@@ -4,7 +4,7 @@ import nonebot
 import yaml
 from pydantic import BaseModel
 
-config = {}
+config = {}  # 全局配置
 
 
 class BasicConfig(BaseModel):
@@ -16,8 +16,8 @@ class BasicConfig(BaseModel):
 
 
 def load_from_yaml(file: str) -> dict:
-    nonebot.logger.debug("Loading config from %s" % file)
     global config
+    nonebot.logger.debug("Loading config from %s" % file)
     if not os.path.exists(file):
         nonebot.logger.warning(f'Config file {file} not found, created default config, please modify it and restart')
         with open(file, 'w', encoding='utf-8') as f:

liteyuki/utils/language.py

@@ -9,8 +9,8 @@ from typing import Any
 
 import nonebot
 
-from liteyuki.utils.config import config
-from liteyuki.utils.data_manager import User, user_db
+from .config import config
+from .data_manager import User, user_db
 
 _default_lang_code = "en"
 _language_data = {
@@ -62,7 +62,6 @@ def load_from_json(file_path: str, lang_code: str = None):
             if lang_code not in _language_data:
                 _language_data[lang_code] = {}
             _language_data[lang_code].update(data)
-            nonebot.logger.debug(f"Loaded language data from {file_path}")
     except Exception as e:
         nonebot.logger.error(f"Failed to load language data from {file_path}: {e}")
 
@@ -113,20 +112,23 @@ class Language:
         Args:
             item:   文本键
             *args:  格式化参数
+            **kwargs: 格式化参数
 
         Returns:
             str: 当前语言的文本
 
         """
+        default = kwargs.pop("default", None)
+
         try:
             if self.lang_code in _language_data and item in _language_data[self.lang_code]:
                 return _language_data[self.lang_code][item].format(*args, **kwargs)
             if self.fallback_lang_code in _language_data and item in _language_data[self.fallback_lang_code]:
                 return _language_data[self.fallback_lang_code][item].format(*args, **kwargs)
-            return item
+            return default or item
         except Exception as e:
             nonebot.logger.error(f"Failed to get language text or format: {e}")
-            return item
+            return default or item
 
 
 def get_user_lang(user_id: str) -> Language:
@@ -150,7 +152,7 @@ def get_system_lang_code() -> str:
 
 def get_default_lang() -> Language:
     """
-    获取默认/系统语言
+    获取配置默认/系统语言
     """
     return Language(config.get("default_language", get_system_lang_code()))
 

liteyuki/utils/log.py

@@ -1,7 +1,8 @@
 import sys
 import loguru
 from typing import TYPE_CHECKING
-from .config import config, load_from_yaml
+from .config import load_from_yaml
+from .language import Language, get_default_lang
 
 logger = loguru.logger
 if TYPE_CHECKING:
@@ -41,20 +42,33 @@ def get_format(level: str) -> str:
         return default_format
 
 
-logger = loguru.logger.bind(get_format=get_format)
+logger = loguru.logger.bind()
 
-logger.remove()
-logger_id = logger.add(
-    sys.stdout,
-    level=0,
-    diagnose=False,
-    filter=default_filter,
-    format=get_format(config.get("log_level", "INFO")),
-)
 
-show_icon = config.get("show_icon", True)
-logger.level("DEBUG", color="<blue>", icon=f"*️⃣==DEBUG")
-logger.level("INFO", color="<white>", icon=f"ℹ️===INFO")
-logger.level("SUCCESS", color="<green>", icon=f"✅SUCCESS")
-logger.level("WARNING", color="<yellow>", icon=f"⚠️WARNING")
-logger.level("ERROR", color="<red>", icon=f"⭕==ERROR")
+def init_log():
+    global logger
+
+    config = load_from_yaml("config.yml")
+
+    logger.remove()
+    logger.add(
+        sys.stdout,
+        level=0,
+        diagnose=False,
+        filter=default_filter,
+        format=get_format(config.get("log_level", "INFO")),
+    )
+    show_icon = config.get("log_icon", True)
+    lang = Language(config.get("default_language", "en"))
+
+    debug = lang.get('log.debug', default="==DEBUG")
+    info = lang.get('log.info', default="===INFO")
+    success = lang.get('log.success', default="SUCCESS")
+    warning = lang.get('log.warning', default="WARNING")
+    error = lang.get('log.error', default="==ERROR")
+
+    logger.level("DEBUG", color="<blue>", icon=f"{'*️⃣' if show_icon else ''}{debug}")
+    logger.level("INFO", color="<white>", icon=f"{'ℹ️' if show_icon else ''}{info}")
+    logger.level("SUCCESS", color="<green>", icon=f"{'✅' if show_icon else ''}{success}")
+    logger.level("WARNING", color="<yellow>", icon=f"{'⚠️' if show_icon else ''}{warning}")
+    logger.level("ERROR", color="<red>", icon=f"{'⭕' if show_icon else ''}{error}")