How wbndmqaq/astrbot_plugin_music_hub works
Music Hub is an AstrBot music-request plugin for QQ Music, KuGou, and NetEase Cloud Music. Its main workflow routes a chat request through handlers and MusicService, searches one or more source clients, presents selectable results, resolves a playable stream, and delivers audio using platform-appropriate channels. Separate branches provide discovery and account features, scheduled subscriptions, and a password-protected WebUI. The README documents the major capabilities and service boundaries; several subsystem implementations were not sampled, so their internal call links are shown only where documented.
Main entry points: service.py MusicService · search.py Search orchestration · handlers Command handlers · registry.py Client registry
Components 24
Chat interaction
- Command handlers
handlers - MusicService
core/service.py
Music services
- Search orchestration
core/search.py - Result matching
core/matching.py - Source selection
core/sources.py - Client registry
core/api/registry.py - NetEase client
core/api/ncm.py - KuGou client
core/api/kg.py - QQ Music client
core/api/qq.py - Discovery catalog
core/catalog.py
Presentation and delivery
- Cards and rendering
core/cards.py - Audio delivery
core/delivery.py - Media processing
core/media.py
Accounts and operations
- QR login flows
core/login.py - Request queue
core/queue.py - Subscriptions
core/subs.py - Scheduled tasks
core/scheduler.py - Session and history
core/registry.py
Management UI
- Web management
core/webui/_server.py - Web authentication
core/webui/_auth.py
Other components
- Chat user
- Music APIs
- Chat platform
- Administrator
Connections 33
- Chat user → Command handlers: issues commands
README.md - Command handlers → MusicService: calls service
README.md - MusicService → Search orchestration: delegates search
README.md - MusicService → Client registry: uses clients
README.md - MusicService → Audio delivery: delegates delivery
README.md - MusicService → Session and history: reads and writes
README.md - Search orchestration → Result matching: groups results
core/search.py - Search orchestration → Source selection: selects sources
core/search.py - Search orchestration → NetEase client: searches
README.md - Search orchestration → KuGou client: searches
README.md - Search orchestration → QQ Music client: searches
README.md - Client registry → NetEase client: creates client
core/api/registry.py - Client registry → KuGou client: creates client
core/api/registry.py - Client registry → QQ Music client: creates client
core/api/registry.py - NetEase client → Music APIs: requests music data
README.md - KuGou client → Music APIs: requests music data
README.md - QQ Music client → Music APIs: requests music data
README.md - Command handlers → Discovery catalog: requests discovery
README.md - Discovery catalog → NetEase client: adapts source data
README.md - Discovery catalog → KuGou client: adapts source data
README.md - Discovery catalog → QQ Music client: adapts source data
README.md - Command handlers → Cards and rendering: builds displays
README.md - MusicService → Cards and rendering: builds display data
README.md - Audio delivery → Media processing: downloads and compresses
core/delivery.py - Audio delivery → Chat platform: sends audio
README.md - Command handlers → QR login flows: starts login
README.md - MusicService → Request queue: manages requests
README.md - MusicService → Subscriptions: manages subscriptions
README.md - MusicService → Scheduled tasks: starts scheduled tasks
README.md - Scheduled tasks → Subscriptions: triggers pushes
README.md - Administrator → Web management: manages plugin
README.md - Web management → Web authentication: authenticates sessions
core/webui/_server.py - Web management → MusicService: uses plugin services
README.md