How mimokit/todaywaifu works
TodayWaifu is a GsCore chat plugin for daily character and member draws, image delivery, and related social commands. The main user flow is a chat command selecting a feature, resolving candidates from local resources or the optional remote gallery, recording daily results where applicable, and sending text or images. The README documents feature-specific image-source settings and local fallback for gallery mode. The graph retains documented feature branches; several implementation links are dashed because the available excerpts do not show their runtime call sites.
Main entry points: daily.py Daily draws · gallery.py Remote gallery · roles.py Role candidates · senders.py Image senders
Components 23
Chat features
- Daily draws
TodayWaifu/daily.py - Normal draws
TodayWaifu/normal_wife.py - Loli and shota
TodayWaifu/loli.py - PGR draws
TodayWaifu/pgr.py - Role actions
TodayWaifu/gift.py - Custom roles
TodayWaifu/custom_role.py - Help command
TodayWaifu/help.py
Candidate sources
- Role candidates
TodayWaifu/roles.py - Member candidates
TodayWaifu/members.py - Remote gallery
TodayWaifu/gallery.py - Folder gallery
TodayWaifu/folder_gallery.py
Records and state
- Domain records
TodayWaifu/domain.py - Daily persistence
TodayWaifu/daily_store.py - Context registry
TodayWaifu/daily_repository.py
Image delivery
- Image senders
TodayWaifu/senders.py - File cache
TodayWaifu/file_cache.py
Shared runtime
- Shared services
TodayWaifu/shared.py - Runtime state
TodayWaifu/state.py - IO executor
TodayWaifu/executor.py - Feature config
daily_wife_config.py
Other components
- Chat user
- GsCore bot
- Gallery service
Connections 25
- Chat user → GsCore bot: sends command
README.md - GsCore bot → Daily draws: routes commands
- Daily draws → Normal draws: offers feature
- Daily draws → Role candidates: resolves roles
- Daily draws → Member candidates: draws members
- Normal draws → Role candidates: resolves roles
- Loli and shota → Role candidates: resolves candidates
- PGR draws → Folder gallery: uses folders
TodayWaifu/pgr.py - Role candidates → Remote gallery: loads candidates
TodayWaifu/gallery.py - Remote gallery → Gallery service: requests images
README.md - Remote gallery → Folder gallery: falls back locally
README.md - Daily draws → Daily persistence: records results
- Daily persistence → Context registry: coordinates contexts
TodayWaifu/daily_store.py - Context registry → Runtime state: uses registry
TodayWaifu/state.py - Daily draws → Image senders: delivers results
- Image senders → Remote gallery: downloads images
TodayWaifu/senders.py - Image senders → File cache: uses image cache
TodayWaifu/senders.py - Image senders → GsCore bot: sends messages
- Role actions → Daily persistence: updates records
- Custom roles → Role candidates: adds candidates
- Help command → GsCore bot: returns help
- Shared services → Runtime state: exposes state
TodayWaifu/shared.py - Remote gallery → File cache: caches downloads
TodayWaifu/gallery.py - Remote gallery → IO executor: offloads IO
TodayWaifu/gallery.py - Daily draws → Feature config: reads settings