How moesnow/march7thassistant works
March7thAssistant automates Honkai: Star Rail tasks through a CLI or graphical interface. The principal runtime path is user-selected task → command dispatch → task implementation → game automation and screen/OCR support; task outcomes can be sent through configured notification channels. The README also documents cloud play, custom workflows, update support, toolbox functions, and scheduled or conditional startup. Source excerpts and the index support the main runtime and several internal links; other documented capabilities are included with only README-backed connections where implementation wiring was not sampled.
Main entry points: main.py CLI dispatcher · automation.py Input automation · weekly Weekly challenges · notification.py Notification routing
Components 27
User interfaces
- Desktop GUI
app.py - CLI dispatcher
main.py
Task automation
- Custom workflows
module/workflow - Daily tasks
tasks/daily - Power farming
tasks/power/power.py - Weekly challenges
tasks/weekly - Challenge modes
tasks/challenge - Activity tasks
tasks/activity - Reward tasks
tasks/reward - Task toolbox
tasks/tool - Task base
tasks/base/base.py
Game runtime
- Input automation
module/automation/automation.py - Screenshot capture
module/automation/screenshot.py - Screen recognition
module/screen/screen.py - OCR engine
module/ocr/ocr.py - Game launchers
module/game/base.py - Cloud game
module/game/cloud.py
Supporting services
- Configuration
module/config/config.py - Notification routing
module/notification/notification.py - Notification channels
module/notification - Update engine
module/update/update_engine.py - Localization
module/localization/languages.py - Logging
utils/logger/logger.py - Telemetry
module/telemetry/telemetry.py
Other components
- Player
- Star Rail
- Push providers
Connections 28
- Player → CLI dispatcher: selects task
- Player → Desktop GUI: opens interface
- CLI dispatcher → Daily tasks: dispatches
main.py - CLI dispatcher → Power farming: dispatches
main.py - CLI dispatcher → Weekly challenges: dispatches
main.py - CLI dispatcher → Challenge modes: dispatches
main.py - CLI dispatcher → Custom workflows: starts workflow
main.py - CLI dispatcher → Notification routing: initializes
main.py - CLI dispatcher → Telemetry: tracks runs
main.py - Custom workflows → Screen recognition: uses screen state
module/workflow/__init__.py - Daily tasks → Input automation: uses input
tasks/daily/tasks.py - Task base → Input automation: uses input
tasks/base/base.py - Task base → Notification routing: sends updates
tasks/base/base.py - Weekly challenges → Input automation: controls game
tasks/weekly/divergent_universe.py - Weekly challenges → Screen recognition: checks screens
tasks/weekly/divergent_universe.py - Weekly challenges → Task base: extends task base
tasks/weekly/divergent_universe.py - Input automation → Screenshot capture: captures frames
module/automation/automation.py - Input automation → OCR engine: recognizes text
module/automation/automation.py - Screen recognition → Input automation: uses input
module/screen/screen.py - Game launchers → Cloud game: provides cloud mode
module/game/__init__.py - Cloud game → Input automation: uses CDP input
module/game/cloud.py - Notification routing → Notification channels: dispatches notifications
module/notification/notification.py - Notification channels → Push providers: sends messages
- Desktop GUI → Configuration: configures tasks
- Update engine → Star Rail: updates game
- Game launchers → Star Rail: launches game
- Configuration → Notification routing: configures channels
- Localization → CLI dispatcher: localizes labels