sagiri-bot 的安装和配置教程

1. 项目基础介绍

sagiri-bot 是一个基于 Mirai 和 Graia-Ariadne 的 QQ 机器人项目。该项目采用 AGPL-3.0 许可协议开源，其名称来源于动漫《埃罗芒阿老师》中的角色和泉纱雾。sagiri-bot 提供了丰富的功能，如异步ORM、权限管理系统、频率限制模块、可视化管理模块（待实现）、日志系统以及数据库版本管理功能。

2. 主要编程语言

该项目主要使用 Python 编程语言开发，同时包含部分 HTML 代码。

3. 关键技术和框架

• Mirai：一个高效率的 QQ 机器人框架。
• Mirai-api-http：Mirai 的 HTTP API 插件，用于与机器人框架进行通信。
• Graia-Ariadne：一个优雅且完备的 Python QQ 自动化框架，基于 Mirai API HTTP v2。
• Sqlalchemy：一个强大的 Python SQL 工具包和对象关系映射（ORM）系统。
• loguru：一个简单且强大的日志系统。
• alembic：一个数据库版本管理工具。

4. 准备工作

在开始安装和配置 sagiri-bot 之前，请确保您的系统中已安装以下软件：

• Python 3.8 或更高版本
• Git

5. 安装步骤

步骤 1：克隆项目

首先，您需要从 GitHub 上克隆 sagiri-bot 项目到本地：

git clone https://github.com/SAGIRI-kawaii/sagiri-bot.git
cd sagiri-bot

步骤 2：安装依赖

使用 pip 安装项目所需依赖：

pip install -r requirements.txt

步骤 3：配置项目

在 config.py 文件中配置您的项目设置，包括但不限于机器人账号信息、数据库连接设置等。

# 示例配置
config = {
    "bot": {
        "account": 123456,  # QQ账号
        "password": "your_password",  # QQ密码
        # 其他配置...
    },
    "database": {
        "url": "sqlite:///sagiri.db",  # 数据库连接URL
        # 其他配置...
    },
    # 其他配置...
}

步骤 4：运行项目

在完成所有配置后，运行以下命令启动您的机器人：

python main.py

按照以上步骤，您应该能够成功安装并配置 sagiri-bot QQ 机器人。如果在安装或配置过程中遇到任何问题，请查阅项目文档或加入项目提供的 QQ 交流群寻求帮助。