expose loguru logger to plugins via astrbot.api

Author: xunxiing

astrbot/api/__init__.py

@@ -3,9 +3,12 @@
 from astrbot.core.agent.tool import FunctionTool, ToolSet
 from astrbot.core.agent.tool_executor import BaseFunctionToolExecutor
 from astrbot.core.config.astrbot_config import AstrBotConfig
+from astrbot.core.log import get_loguru_logger
 from astrbot.core.star.register import register_agent as agent
 from astrbot.core.star.register import register_llm_tool as llm_tool
 
+loguru_logger = get_loguru_logger()
+
 __all__ = [
     "AstrBotConfig",
     "BaseFunctionToolExecutor",
@@ -15,5 +18,6 @@
     "html_renderer",
     "llm_tool",
     "logger",
+    "loguru_logger",
     "sp",
 ]

astrbot/core/log.py

@@ -415,3 +415,8 @@ def configure_trace_logger(cls, config: dict | None) -> None:
             backup_count=3,
             trace=True,
         )
+
+
+def get_loguru_logger():
+    """Returns the patched loguru logger for plugin use."""
+    return _loguru