How monster-qianmu/qxbanxiaozhu works
QX班小助 is a Windows desktop tool for classroom and dormitory administration. The main workflow imports student records and matches photos, then supports record editing and produces seating charts, dormitory assignments, printable tags, and processed portraits. The README also documents Excel/PDF exports, a downloadable background-removal model, and operational logs. The sampled implementation is concentrated in main.py; feature boundaries below describe documented responsibilities, not independently verified modules. Packaging and manual-generation code are excluded.
Main entry points: main.py Desktop App
Components 17
Student Workflow
- Desktop App
main.py - Student Import
main.py - Student Records
main.py - Photo Matching
main.py - Photo Processing
main.py
Classroom Outputs
- Seat Layout Editor
main.py - Seat Chart PDF
main.py
Dormitory Outputs
- Dorm Assignment
main.py - Dorm Roster Excel
main.py - Dorm Name Tags
main.py - Bed Cabinet Tags
main.py
App Support
- Model Download
- App Configuration
main.py - Operation Logs
main.py
Other components
- School Staff
- Student Excel
- Updated Roster
Connections 18
- School Staff → Desktop App: uses
README.md - Desktop App → Student Import: opens
README.md - Student Import → Student Excel: reads
README.md - Student Import → Student Records: loads records
README.md - Desktop App → Student Records: edits
README.md - Desktop App → Photo Matching: matches photos
README.md - Photo Matching → Student Records: binds portraits
README.md - Desktop App → Photo Processing: opens
README.md - Photo Processing → Model Download: downloads model
README.md - Student Records → Updated Roster: exports
README.md - Desktop App → Seat Layout Editor: opens
README.md - Seat Layout Editor → Seat Chart PDF: exports
README.md - Desktop App → Dorm Assignment: opens
README.md - Dorm Assignment → Dorm Roster Excel: exports
README.md - Desktop App → Dorm Name Tags: opens
README.md - Dorm Name Tags → Bed Cabinet Tags: exports
README.md - Desktop App → App Configuration: stores settings
main.py - Desktop App → Operation Logs: records activity
README.md