phi-plugin 完整指南：如何在 QQ 群里快速查询 Phigros 分数与曲绘
【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件，支持查询分数等信息统计，以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin
一个专给 Bot 群的 Phigros 查询助手
想在 QQ 群里随口说一句"帮我查查 b30"，然后甩出一张排版好看的分数图？或者想知道自己 RKS 排到多少名、哪首歌最该去练？phi-plugin 就是干这个的：一个适用于 Yunzai-Bot V3 的 Phigros 信息查询插件。发一条类似/phi rks的指令，它会自动拉取你的存档、算好成绩，再把结果渲染成直观的分数图发回群里。
三步装好并绑定账号
插件安装不需要写代码。先在 Yunzai-Bot 目录下克隆插件并安装依赖：
git clone --depth=1 https://gitcode.com/gh_mirrors/ph/phi-plugin.git ./plugins/phi-plugin/ cd ./plugins/phi-plugin/ && pnpm install -P装完后，在群里发#phi 绑定并跟上你的 sessionToken，Bot 就会记下你的账号。默认绑国服，加gb前缀则绑国际服。绑定后查分、排名就都能用了。另外官方建议用主人权限发一次#phi downill把曲绘缓存下载到本地，否则曲绘展示可能不完整；如果 pnpm 装依赖太慢，切换成国内镜像源一般就能解决。
核心功能：b30 查分、曲库图鉴与随机抽题
b30 查分。发#phi b30会拿到一张排版好的 b30 图，包含总分和每首曲目的定数与评级，还支持 3 套绘图主题切换。想查"1Good b30"或"FC b30"就发#phi x30、#phi fc30；再发#phi suggest能直接告诉你练哪首歌、要打到多少 ACC 才能让 RKS 提升 0.01。
曲库图鉴与曲绘。#phi song 曲名出曲目图鉴，#phi chart出谱面详情，#phi 曲绘 曲名出高清曲绘大图。还能给谱面打自定义标签、写评论，用#phi search按 BPM、定数、物量检索曲库。练歌拿不定主意时，#phi rand可以按难度和定数区间随机抽曲。
小游戏与社区玩法。猜曲绘、字母猜曲、提示猜曲都能在群里开局，答对答错 Bot 都会回应。再加上签到、送 Notes、民间段位认证等功能，群里的气氛会活跃不少；所有指令发/phihelp就能看全。
值得留意的技术细节
- 分数图由 Puppeteer 实时渲染 HTML 生成，不是死模板，主题和数据布局都自动适配，卡住了还能用
#phi repu重启渲染进程； - 存档记录保存在 Bot 本地，支持一键备份和还原，换机器迁移不丢数据；
- API 功能可选开启，开启后成绩历史会同步到云端，部分高级功能（如单曲成绩排行）也依赖它。
适合谁来用
如果你正在跑 Yunzai-Bot，想给群里加一个 Phigros 查分助手，或者自己就是喜欢查分、看排行的 Phigros 玩家，phi-plugin 基本是现成的选择。功能还在持续更新中，感兴趣可以去仓库点个 Star，顺便看看更新日志里排上的新功能。
【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件，支持查询分数等信息统计，以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
