Skip to content

模块 nonebot_plugin_marshoai.models

class MarshoContext


func __init__(self)

源代码在GitHub上查看
python
def __init__(self):
    self.contents = {'private': {}, 'non-private': {}}

func append(self, content, target_id: str, is_private: bool)

说明: 往上下文中添加消息

源代码在GitHub上查看
python
def append(self, content, target_id: str, is_private: bool):
    target_dict = self._get_target_dict(is_private)
    target_dict.setdefault(target_id, []).append(content)

func set_context(self, contexts, target_id: str, is_private: bool)

说明: 设置上下文

源代码在GitHub上查看
python
def set_context(self, contexts, target_id: str, is_private: bool):
    self._get_target_dict(is_private)[target_id] = contexts

func reset(self, target_id: str, is_private: bool)

说明: 重置上下文

源代码在GitHub上查看
python
def reset(self, target_id: str, is_private: bool):
    self._get_target_dict(is_private).pop(target_id, None)

func reset_all(self)

说明: 重置所有上下文

源代码在GitHub上查看
python
def reset_all(self):
    self.contents = {'private': {}, 'non-private': {}}

func build(self, target_id: str, is_private: bool) -> list

说明: 构建返回的上下文,不包括系统消息

源代码在GitHub上查看
python
def build(self, target_id: str, is_private: bool) -> list:
    return self._get_target_dict(is_private).setdefault(target_id, [])

class MarshoTools


func __init__(self)

源代码在GitHub上查看
python
def __init__(self):
    self.tools_list = []
    self.imported_packages = {}

func load_tools(self, tools_dir)

说明: 从指定路径加载工具包

源代码在GitHub上查看
python
def load_tools(self, tools_dir):
    if not os.path.exists(tools_dir):
        logger.error(f'工具集目录 {tools_dir} 不存在。')
        return
    for package_name in os.listdir(tools_dir):
        package_path = os.path.join(tools_dir, package_name)
        if package_name in config.marshoai_disabled_toolkits:
            logger.info(f'工具包 {package_name} 已被禁用。')
            continue
        if os.path.isdir(package_path) and os.path.exists(os.path.join(package_path, '__init__.py')):
            self._load_package(package_name, package_path)
        else:
            logger.warning(f'{package_path} 不是有效的工具包路径,跳过加载。')

async func call(self, full_function_name: str, args: dict)

说明: 调用指定的函数

源代码在GitHub上查看
python
async def call(self, full_function_name: str, args: dict):
    parts = full_function_name.split('__')
    if len(parts) != 2:
        logger.error('函数名无效')
        return
    package_name, function_name = parts
    if package_name in self.imported_packages:
        package = self.imported_packages[package_name]
        try:
            function = getattr(package, function_name)
            return await function(**args)
        except Exception as e:
            errinfo = f"调用函数 '{function_name}'时发生错误:{e}"
            logger.error(errinfo)
            return errinfo
    else:
        logger.error(f"工具包 '{package_name}' 未导入")

func has_function(self, full_function_name: str) -> bool

说明: 检查是否存在指定的函数

源代码在GitHub上查看
python
def has_function(self, full_function_name: str) -> bool:
    try:
        return any((t['function']['name'].replace('-', '_') == full_function_name.replace('-', '_') for t in self.tools_list))
    except Exception as e:
        logger.error(f"检查函数 '{full_function_name}' 时发生错误:{e}")
        return False

func get_tools_list(self)

源代码在GitHub上查看
python
def get_tools_list(self):
    if not self.tools_list or not config.marshoai_enable_tools:
        return None
    return self.tools_list

文档完善中,欢迎提出建议或帮助我们完善。