3040000531
本次更新在整个代码库范围内将项目名称 "MaiBot" 及其相关变体（如 "maibot"）统一重命名为 "MoFox-Bot"。 主要变更包括： - 修改配置文件、模板和日志输出中的项目名称。 - 更新文档、注释和用户可见的字符串，以反映新的品牌名称。 - 调整插件元数据和描述。
1.4 KiB
1.4 KiB
配置API
配置API模块提供了配置读取功能，让插件能够安全地访问全局配置和插件配置。
导入方式
from src.plugin_system.apis import config_api
# 或者
from src.plugin_system import config_api
主要功能
1. 访问全局配置
def get_global_config(key: str, default: Any = None) -> Any:
Args:
key: 命名空间式配置键名，使用嵌套访问，如 "section.subsection.key"，大小写敏感default: 如果配置不存在时返回的默认值
Returns:
Any: 配置值或默认值
示例：
获取机器人昵称
bot_name = config_api.get_global_config("bot.nickname", "MoFox-Bot")
2. 获取插件配置
def get_plugin_config(plugin_config: dict, key: str, default: Any = None) -> Any:
Args:
plugin_config: 插件配置字典key: 配置键名，支持嵌套访问如 "section.subsection.key"，大小写敏感default: 如果配置不存在时返回的默认值
Returns:
Any: 配置值或默认值
注意事项
- 只读访问：配置API只提供读取功能，插件不能修改全局配置
- 错误处理：所有函数都有错误处理，失败时会记录日志并返回默认值
- 安全性：插件通过此API访问配置是安全和隔离的
- 性能：频繁访问的配置建议在插件初始化时获取并缓存