How gaofeiyang360-create/python-qq-chatbot works
This is a multi-bot QQ AI assistant. Its main workflow receives QQ events over WebSocket, parses and batches messages, decides whether to reply, uses AI and optional tools, then sends a response through QQ. Separate branches provide an authenticated HTTP API, scheduled pushes and wakeups, group events, media handling, and scoped conversation memory. The graph follows documented architecture and indexed imports; some implementation details are unsampled, so uncertain relationships are omitted.
Main entry points: client.py QQ Client · msg.py Message Handling · wakeup_scheduler.py Wakeup Scheduler · core.py Bot Orchestration
Components 17
Bot Runtime
- Bot Entry
bot.py - Bot Orchestration
core.py - QQ Client
client.py - Configuration
config.py - Logging
log.py
Conversation Processing
- Message Handling
msg.py - Media And Web Processing
ai.py
AI And Tools
- AI Conversation
ai.py - Tool Execution
tool.py
Memory And State
- Conversation Memory
memory.py
API And Scheduling
- Task Rules
task_core.py - HTTP API
api_server.py - Push Scheduler
scheduler.py - Wakeup Scheduler
wakeup_scheduler.py
Other components
- QQ Users
- QQ Platform
- AI Model APIs
Connections 35
- QQ Users → QQ Platform: sends messages
README.md - QQ Platform → QQ Client: delivers events
README.md - QQ Client → Message Handling: routes messages
README.md - Message Handling → Media And Web Processing: processes media
README.md - Message Handling → Conversation Memory: records history
msg.py - Message Handling → AI Conversation: requests replies
README.md - AI Conversation → AI Model APIs: calls models
ai.py - AI Conversation → Conversation Memory: uses memory
ai.py - AI Conversation → Tool Execution: dispatches tools
README.md - Tool Execution → QQ Client: sends actions
tool.py - QQ Client → QQ Platform: sends replies
README.md - Bot Entry → Bot Orchestration: starts bots
bot.py - Bot Orchestration → QQ Client: runs clients
core.py - Bot Orchestration → Push Scheduler: starts scheduler
core.py - Bot Orchestration → Wakeup Scheduler: starts scheduler
core.py - Bot Orchestration → HTTP API: starts API
core.py - Bot Orchestration → Configuration: reads settings
core.py - Message Handling → QQ Client: sends replies
README.md - Message Handling → Conversation Memory: updates memories
msg.py - Media And Web Processing → AI Model APIs: requests recognition
README.md - HTTP API → Conversation Memory: reads histories
api_server.py - HTTP API → QQ Client: sends messages
api_server.py - HTTP API → Task Rules: normalizes tasks
api_server.py - HTTP API → Push Scheduler: manages pushes
api_server.py - HTTP API → Wakeup Scheduler: manages wakeups
api_server.py - Push Scheduler → Task Rules: validates tasks
scheduler.py - Push Scheduler → QQ Client: sends pushes
scheduler.py - Wakeup Scheduler → Task Rules: validates tasks
wakeup_scheduler.py - Wakeup Scheduler → AI Conversation: generates replies
wakeup_scheduler.py - Wakeup Scheduler → Conversation Memory: records wakeups
wakeup_scheduler.py - Wakeup Scheduler → QQ Client: sends wakeups
wakeup_scheduler.py - Configuration → Logging: configures logs
log.py - Message Handling → Logging: reports events
msg.py - Tool Execution → Push Scheduler: manages pushes
tool.py - Tool Execution → Wakeup Scheduler: manages wakeups
tool.py