How llonebot/luckylilliabot works
LLBot is a QQ bot runtime that logs into QQ and exposes bot capabilities through OneBot 11, Satori, and Milky interfaces, with a WebUI for login, configuration, and WebQQ. The main runtime selects a QQ protocol implementation, loads the bot core and adapters, then starts the WebUI; clients use an adapter to issue actions or receive events. The tree documents additional message, group, user, and file capabilities. Sampled excerpts confirm runtime startup, Satori-to-OneBot action dispatch, WebUI APIs, and Milky webhook delivery; links between unsampled subsystems are intentionally limited.
Main entry points: main.ts Runtime startup · milky/adapter.ts Milky adapter · client.ts Direct client · onebot11/adapter.ts OneBot adapter
Components 20
Runtime and QQ
- Runtime startup
src/main/main.ts - QQ protocol
src/main/qqProtocol/index.ts - Direct client
src/main/qqProtocol/direct-lib/client.ts
Bot interfaces
- OneBot adapter
src/onebot11/adapter.ts - OneBot actions
src/onebot11/action/index.ts - Satori server
src/satori/server.ts - Milky adapter
src/milky/adapter.ts - Milky APIs
src/milky/api/index.ts - Milky network
src/milky/network/index.ts
Web management
- WebUI server
src/webui/BE/server.ts - WebUI routes
src/webui/BE/routes/index.ts - WebUI app
src/webui/FE/App.tsx
External delivery
- Webhook delivery
src/milky/network/webhook.ts - Email service
src/common/emailService.ts
Other components
- Bot operator
- Bot client
- QQ service
- SMTP server
Connections 22
- Bot operator → WebUI app: configures
- WebUI app → WebUI server: calls APIs
- WebUI server → WebUI routes: routes requests
- Runtime startup → QQ protocol: selects protocol
- Runtime startup → Bot core: loads core
- Runtime startup → OneBot adapter: loads adapter
- Runtime startup → Satori server: loads adapter
- QQ protocol → Direct client: selects direct
- Direct client → QQ service: connects
- QQ service → Direct client: sends packets
- Bot client → OneBot adapter: sends actions
- OneBot adapter → OneBot actions: dispatches actions
- OneBot actions → QQ APIs: invokes APIs
- Satori server → OneBot actions: dispatches actions
- Bot client → Satori server: calls methods
- Bot client → Milky network: connects
- Milky network → Milky adapter: routes requests
- Milky adapter → Milky APIs: handles methods
- Milky adapter → Webhook delivery: broadcasts events
- Webhook delivery → SMTP server: posts webhook
- Email service → SMTP server: sends mail
- WebUI routes → QQ APIs: uses bot services