HypeR Bot

适配OneBot v11协议、功能模块化、易于扩展、高效的QQ机器人及框架

---

🚧 非活跃项目

若您在看hyper-bot，请移步HypeR Core

实质性功能将不再维护，截止2026年6月，他们的绝大多数仍然可以正常工作。后期的API变更也许会改变这一状况。

本人对于传统类型QQ Bot的创意已经燃尽力（悲），加之本人正在面临2027年的高考，该项目内实质性功能（如：网页解析、表情包生成）可能不再会得到积极维护。

框架 / Python Package 部分可能在后期迁移到其他仓库，并继续更新。

接下来的打算

既然已经回来重操旧业了，肯定不能啥也不干嘛。

1. 开始新项目 HyperAG ;
2. 转移该项目核心（即框架 / Python Package 部分），继续维护，在尽可能少改变 API 的前提下重构并完善，重点关注多协议功能和性能;
3. 为核心编写新的完善的文档;
4. 高考加油（）

---

概览

HypeR Bot是一个适配OneBot协议的机器人框架，旨在提供一个简洁、高效、可扩展的机器人运行结构。

点我跳转详细文档 (Old) (Simplified Chinese)

点我跳转详细文档 (New) (English)

使用 hytil 快速开始

hytil 于 HypeR Bot 0.81.0 版本加入，是一个支持您快速配置完整 HypeR Bot 的实用工具。

安装 HypeR Bot

pip install hyper_bot

使用 hytil

$ python -m hytil
usage: hytil.py [-h] [-v] [-i] [-p PATH]

HypeR Bot Utils 版本 0.0.1

options:
  -h, --help            show this help message and exit
  -v, --version         显示版本信息
  -i, --install         安装完整的HypeR Bot到本地
  -p PATH, --path PATH  指定操作路径

在开始前，确认一个空文件夹，该文件夹将用于安装 HypeR Bot。

$ mkdir bot
$ ls
bot ...

现在，使用如下命令将完整的 HypeR Bot 下载到本地：

python -m hytil -i -p ./bot

下载完成后，您将会收到运行 main.py 的提示，此时，请您进入安装目录，在该目录下执行python main.py，配置文件 config.json将随后创建，请根据下方指引编辑配置文件。

配置文件

config.json:

{
  "protocol": "OneBot",
  "owner": [],
  "black_list": [],
  "silents": [],
  "connection": {
    "mode": "FWS",
    "ob_auto_startup": false,
    "ob_exec": "./Lagrange.OneBot/Lagrange.OneBot",
    "ob_startup_path": "./Lagrange.OneBot/",
    "host": "127.0.0.1",
    "port": 5004
  },
  "log_level": "INFO",
  "log_use_nf": true,
  "uin": 0,
  "max_workers": 25,
  "others": { ... }
}

其中：

• owner：机器人主人的QQ号，填写在这个列表中的QQ号所发送的消息会被标记is_owner = True；
• black_list：黑名单，填写在这个列表中的QQ号所发送的的消息会被标记 blocked = True；
• connection：连接信息，包括主机地址、端口以及自动启动OneBot实现的配置；
• log_level：日志等级，可选值为DEBUG、TRACE、INFO、WARNING、ERROR、CRITICAL；
• others：其他配置项；
• log_use_nf：是否为日志输出启用NerdFont;
• protocol：适配的协议，目前仅支持OneBot.

若您正在使用完整的 HypeR Bot 安装，您需要如下设置 others 部分以正常使用 AI 聊天功能：

"others": {
    "enable": "gemini",
    "gemini_key": "",
    "ds_ck": "",
    "ds_auth": "",
    "white": []
  }

直接注册个 AI Studio 用gemini得了，ds我自己逆向的，懒得写文档了（

环境

本人开发和测试均在Python 3.11.7环境进行，其他版本未经测试，理论上支持 Python 3.9 及以上版本。

所需的第三方库陈列在requirements.txt中，使用pip install -r requirements.txt即可。

requirements_optional.txt中包含部分模块所需的其他依赖，可视情况安装。

Finale

大概没什么人能看到这里吧。

我也想对我的一位故友表达我的歉意，不过，都过去了。

瞻顾遗迹，如在昨日，令人长号不自禁。