phi-plugin：面向 YunzaiBot 的 Phigros 一站式成绩查询插件
【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件，支持查询分数等信息统计，以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin
想查 RKS，得打开官网、输 ID、等加载。群里总有人问 b19 怎么查。phi-plugin 是一个跑在 Yunzai-Bot（QQ 机器人框架）里的 Phigros 成绩查询插件：发一条消息，它就回你一张 b19 成绩单和账号统计。
phi-plugin 是什么：Phigros 查询插件
它是 Yunzai-Bot V3 生态下的功能插件，装进机器人的plugins/目录即可使用。核心能力：
- 查询个人 RKS、b19、b30 与单曲成绩
- 绑定 sessionToken 拉取存档，支持国服与国际服
- 把 b19、区间成绩渲染成图片卡片
- 查曲目图鉴、谱面详情与历史定数
- 内置猜曲绘、开字母、提示猜曲等小游戏
技术底座：Yunzai-Bot V3 插件技术栈
主框架是 Yunzai-Bot V3，YunzaiBot 插件安装流程很简单：放入目录即自动加载。依赖用pnpm（Node.js 包管理器）一条命令装完，仓库同时提供 GitHub 与镜像源，网络不佳也能装。
- sessionToken 鉴权：机器人只拉取你自己账号的存档，解绑时只清理本地数据
- 指令头可自定义：改一个配置项就能换命令前缀，避免和其他插件撞指令
能解决什么问题：从查成绩到猜曲绘
单人玩家
发送/phi b19，它会把你前 30 首歌的成绩渲染成卡片发回，含 Perfect 数和总分。再发/phi suggest，它会列出接下来推哪首歌、需要多少 ACC 才能 RKS +0.01。
社区运营
管理员用/phi ban可以按群禁用某类功能，防止刷屏。玩家可以在群里互查成绩、分享成绩单。猜曲绘、提示猜曲这些小游戏，很适合用来维持群活跃。
二次开发参考
每个功能都是apps/下的独立文件，加一条指令只需增加一个文件。model/里放着存档解析、谱面解析等逻辑，结构清晰，适合照着学。
快速上手：四步完成 YunzaiBot 插件安装
- 克隆仓库到机器人目录：
git clone --depth=1 https://gitcode.com/gh_mirrors/ph/phi-plugin ./plugins/phi-plugin/ - 进入插件目录安装依赖：
cd plugins/phi-plugin && pnpm install -P - 重启机器人，私聊发送
/phi bind 你的sessionToken绑定账号，默认国服 - 发送
/phihelp查看全部指令，再发/phi b19拿到第一张成绩单
扩展与定制：加一条指令只要改一个文件
phi-plugin 的功能全部模块化，新增查询维度只需在apps/下加文件并注册匹配规则。成绩单主题可以用/phi theme切换，渲染精度、并发数等参数都写在配置文件里，按需调整即可。
今晚就可以把 phi-plugin 装进你的 YunzaiBot，发一条/phihelp试试。一条消息，一张 Phigros b19 成绩单。
【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件，支持查询分数等信息统计，以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
