phi-plugin 上手指南：3 步在 QQ 群查 Phigros 成绩与推分建议
【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件，支持查询分数等信息统计，以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin
phi-plugin 是一个跑在 Yunzai-Bot 框架上的 Phigros 信息查询插件：把游戏账号绑定到机器人后，在群里发一条指令就能完成成绩查询、曲目标识检索和 RKS 排行查询，适合想把 Phigros 数据搬进群聊的玩家和群主。
开黑前，群里问一句"这周还能推多少分"
晚上开黑前，朋友问你 b30 多少、哪首歌值得再推。不用翻网页，发#phi b30出成绩图，发#phi 推分会直接告诉你哪首歌打到多少 ACC 能让 RKS 涨 0.01。另一种常见场景是群里讨论某首曲目的定数、物量，发#phi 曲名就能调出图鉴卡片，BPM、曲绘、难度一次看全。
绑定 sessionToken，成绩图自动渲染
插件基于 Yunzai-Bot V3 开发，数据入口是 sessionToken：发#phi 绑定 <token>即可关联自己的存档，默认国服、加 gb 参数切国际服，解绑只清理机器人本地数据。查分结果不是文字堆砌，而是由 Puppeteer 渲染成带曲绘的图片，发出来就是一张能直接晒的成绩卡。
三步跑起来
在 Yunzai 的 plugins 目录下安装插件本体：
git clone --depth=1 https://gitcode.com/gh_mirrors/ph/phi-plugin.git ./phi-plugin/ cd ./phi-plugin/ pnpm install -P然后在群里发#phi 绑定 <sessionToken>完成绑定；拿不准某条指令时，发#phi 帮助会列出全部功能。完整说明见 README，猜曲绘等小游戏的实现集中在 apps/guessGame 目录，想深挖的可以翻一翻。
这三类人比较合适
- 想随时看成绩的玩家：b30、区间成绩、定数表都是单条指令，不用再切应用查网页。
- 运营 Phigros 群的群主：图鉴、排行榜、曲绘下载一次部署全群可用，还能按功能分类禁用指令。
- 喜欢群内小游戏的玩家：猜曲绘、字母猜曲、提示猜曲都内置，不用额外装插件。
先绑个账号跑一轮试试
它把 Phigros 的成绩查询、曲库检索和小游戏收进了群聊里的同一个指令入口，日常查分基本不用再离开 QQ。建议先绑定自己的账号，发一条 b30 指令看看出图效果，值不值得长期挂在群里，跑一轮就有答案。
【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件，支持查询分数等信息统计，以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
