How gsjsjzhznsz/bandqq works
BandQQ is a two-endpoint QQ messaging assistant: an Android synchronizer connects to a OneBot-compatible QQ gateway, preprocesses messages and contact data, then forwards them over Xiaomi’s interconnect channel to a Vela wearable client for viewing, replying, and history browsing. The README documents wearable features such as @me and poke indicators, mute controls, quick replies, and image receipt; the supplied tree exposes only the wearable client’s common API, protocol, and store modules, not its screens. Android wiring is based on the sampled SyncService and OneBot client excerpts; unsampled subsystem links are omitted where ownership is uncertain.
Main entry points: MessageBroker.kt Message broker · SyncService.kt Sync service · OneBotClient.kt OneBot client · InterconnectBridge.kt Interconnect bridge
Components 17
Android synchronizer
- Sync service
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/sync/SyncService.kt - Message broker
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/sync/MessageBroker.kt - Message history
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/sync/MessageStore.kt - Contact cache
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/sync/ContactCache.kt - Interconnect bridge
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/sync/InterconnectBridge.kt
QQ gateway
- OneBot parser
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/onebot/OneBotParser.kt - OneBot client
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/onebot/OneBotClient.kt
Wearable client
- Vela client
band-qq/src/common/store.js - Frame protocol
band-qq/src/common/protocol.js - Wearable API
band-qq/src/common/api.js
App operations
- Sync settings
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/config/ConfigManager.kt - Live log bus
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/sync/LogBus.kt - File logger
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/sync/FileLogger.kt - Sync app UI
android-sync/app/src/main/java/io/github/gsjsjzhznsz/bandqq/ui/BandQQApp.kt - DevTools simulator
android-sync/devtools/src/main/java/io/github/gsjsjzhznsz/bandqq/devtools/MainActivity.kt
Other components
- Wearable user
- QQ gateway
Connections 19
- Wearable user → Vela client: views and replies
- Sync service → Sync settings: loads settings
- Sync service → OneBot client: starts client
- Sync service → Message broker: assembles
- Sync service → Interconnect bridge: registers broker
- QQ gateway → OneBot client: events and API
- OneBot client → OneBot parser: delivers events
- OneBot parser → Message broker: parses messages
- Message broker → OneBot client: requests and sends
- Message broker → Message history: persists history
- Message broker → Contact cache: resolves contacts
- Message broker → Interconnect bridge: pushes frames
- Interconnect bridge → Wearable API: transfers frames
- Wearable API → Frame protocol: encodes and decodes
- Vela client → Message history: updates and reads
- Message broker → Live log bus: emits diagnostics
- Live log bus → File logger: records logs
- Sync app UI → Sync settings: edits settings
- DevTools simulator → QQ gateway: simulates OneBot