How nwuww/phi-plugin works
phi-plugin is a Phigros information bot plugin for Yunzai and Koishi. Users issue chat commands for account binding, score and player queries, song/chart lookup, history, rankings, and games; handlers use game metadata and saved records, optionally call the online API, then send textual or rendered results. The README documents these capability branches, while sampled source confirms shared configuration, platform handling, game calculations, API, save, and rendering layers. Some command-handler wiring and several feature implementations were not sampled, so those relationships are shown only where documented or indexed.
Main entry points: Save.js Player Records · getInfo.js Song Metadata · picmodle.js Image Rendering · fCompute.js Score Calculations
Components 20
Chat and Platform
- Plugin Entry
index.js - Platform Adapter
components/platform/index.js - Message Base
components/baseClass.js
Player Features
- Account and Session
apps/session.js - Score Queries
apps/b19.js - Guess Games
apps/guessGame.js - Alias Proposals
apps/aliasProposal.js - Chart Queries
apps/chart.js - Rank Lists
apps/RankList.js
Game Domain
- Song Metadata
model/game/getInfo.js - Score Calculations
model/game/fCompute.js - Player Records
model/save/Save.js
Shared Services
- Configuration
components/Config.js - Filesystem Paths
model/filesystem/path.js - Phi API Client
model/api/makeRequest.js - API Permissions
model/user/apiPermission.js
Results and Themes
- Image Rendering
model/render/picmodle.js - Message Delivery
model/render/send.js - Theme Management
model/theme/manager.js
Other components
- Chat User
Connections 25
- Chat User → Plugin Entry: issues commands
- Plugin Entry → Platform Adapter: loads adapter
components/platform/index.js - Plugin Entry → Message Base: loads handlers
- Account and Session → Player Records: updates records
apps/session.js - Account and Session → Phi API Client: requests account data
apps/session.js - Score Queries → Player Records: queries scores
- Score Queries → Phi API Client: requests online data
- Guess Games → Song Metadata: looks up songs
apps/guessGame/guessIll.js - Guess Games → Score Calculations: compares scores
apps/guessGame/guessIll.js - Alias Proposals → Song Metadata: checks song aliases
- Chart Queries → Song Metadata: queries charts
- Rank Lists → Phi API Client: requests rankings
- Player Records → Score Calculations: calculates ratings
model/save/Save.js - Player Records → Phi API Client: requests statistics
model/save/Save.js - Player Records → API Permissions: checks access
model/save/Save.js - Song Metadata → Filesystem Paths: reads game files
model/game/getInfo.js - Score Calculations → Song Metadata: uses song metadata
model/game/fCompute.js - Configuration → Filesystem Paths: resolves plugin paths
components/Config.js - Message Base → Message Delivery: sends replies
components/baseClass.js - Message Base → Song Metadata: resolves song names
components/baseClass.js - Message Delivery → Player Records: reads saved data
model/render/send.js - Image Rendering → Score Calculations: uses calculations
model/render/picmodle.js - Image Rendering → Theme Management: resolves themes
model/render/picmodle.js - Score Queries → Image Rendering: renders results
- Image Rendering → Message Delivery: produces images