JianerCore
面向 Jianer_QQ_bot 的可扩展 QQ 机器人框架
项目介绍
JianerCore 是 SRInternet-Studio/Jianer_QQ_bot 使用的 QQ 机器人框架，负责连接 OneBot 实现、接收和分发事件，并向机器人业务代码提供消息发送及群管理等接口。
JianerCore 基于 HypeR Core 开发。除代码基础外，本项目是独立维护的项目，与 HypeR Core 没有其他联系。
JianerCore 本身不负责登录 QQ。运行机器人时，还需要使用支持 OneBot v11 的实现，例如 NapCat 或 Lagrange.OneBot。
主要功能
- 通过正向 WebSocket 或 HTTP 连接 OneBot v11 实现
- 订阅并异步处理群消息、私聊消息、通知和请求事件
- 使用 Loguru 提供分级、彩色和异常日志
- 发送、回复和撤回消息
- 支持文字、图片、语音、视频、At、回复、转发和 JSON 等消息段
- 提供禁言、踢出群成员、设置精华消息和群头衔等操作
- 使用适配器结构隔离协议实现与机器人业务逻辑
- 支持机器人主人、黑名单和静默名单配置
环境要求
- Python 3.9 或更高版本
- 一个可用的 OneBot v11 实现
本项目当前使用 Python 3.12.7 进行开发。首次配置本地开发环境：
D:\Python3127\python.exe -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
.\.venv\Scripts\python.exe -m pip install -e .
发行包名为 jianer-bot：
pip install jianer-bot
快速开始
jianer-bot 是安装和发布时使用的发行包名，Python 导入包名为 jianer。下面的示例会在收到群消息 ping 时回复 pong：
from jianer import configurator
from cfgr.manager import Serializers
configurator.BotConfig.load_from(
"config.json",
Serializers.JSON,
"jianer-bot",
)
from jianer.adapters import builtins as adapters
adapters.load_configured()
from jianer import Client
from jianer.events import GroupMessageEvent
async def handle_group_message(event, actions):
if str(event.message) == "ping":
await actions.send("pong", group_id=event.group_id)
with Client() as client:
client.subscribe(handle_group_message, GroupMessageEvent)
client.run()
加载配置后再加载 OneBot 适配器和事件模块。完整示例可查看 test.py。
配置
在项目运行目录创建 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/",
"ob_log_output": false,
"host": "127.0.0.1",
"port": 5004,
"retries": 5,
"token": "",
"auth": ""
},
"log_level": "INFO",
"log_use_nf": false,
"uin": 0,
"max_workers": 25,
"others": {}
}
主要配置项：
owner：机器人所有者的 QQ 号列表black_list：需要标记为已屏蔽的用户或群列表silents：需要静默处理的用户或群列表connection.mode：连接模式，FWS表示正向 WebSocket，HTTPC表示 HTTPconnection.host：OneBot 服务地址connection.port：OneBot 服务端口connection.retries：连接失败后的最大重试次数connection.ob_auto_startup：是否由框架启动 OneBot 实现log_level：日志等级
项目结构
jianer/
├── adapters/ 适配器接口与加载逻辑
├── LecAdapters/ OneBot、Milky 和 Kritor 适配代码
├── utils/ 通用工具
├── events.py 事件定义与转换
├── listener.py 监听器入口
├── network.py WebSocket 和 HTTP 连接
└── segments.py 消息段定义
当前主要使用 OneBot v11 适配器。Milky 和 Kritor 相关代码仍处于开发阶段，部分功能尚未实现。
许可证
本项目采用 GPL-3.0 许可证。
1 maintainer
Release files for jianer-bot 0.91.1.post1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| jianer_bot-0.91.1.post1.tar.gz | 106.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| jianer_bot-0.91.1.post1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 224.5 kB
Release files / jianer_bot-0.91.1.post1.tar.gz
| Download URL | jianer_bot-0.91.1.post1.tar.gz |
|---|---|
| Size | 106.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c1b08d078aa096fd524cec02438245f99302bafac190ff8f3f68a483eafa125b
|
|
BLAKE2b-256 checksum How to use checksums |
c78b149afcc445fdd3dca0a21579796127b5d99e85430d734bdf0b49adba4ff0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 11, 2026.
Transparency logRelease files / jianer_bot-0.91.1.post1-py3-none-any.whl
| Download URL | jianer_bot-0.91.1.post1-py3-none-any.whl |
|---|---|
| Size | 118.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a5f1c973f423b1210ac4dabf40a5acd8762b97f2a376aeba7efcdef04099a15d
|
|
BLAKE2b-256 checksum How to use checksums |
fe6e4a1249395899fe80e5231a9259e9ab3adb93213acfeb3b3ac1d41a1682b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 11, 2026.
Transparency log
