phi-plugin：面向 YunzaiBot 的 Phigros 一站式成绩查询插件

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 插件安装

1. 克隆仓库到机器人目录：git clone --depth=1 https://gitcode.com/gh_mirrors/ph/phi-plugin ./plugins/phi-plugin/
2. 进入插件目录安装依赖：cd plugins/phi-plugin && pnpm install -P
3. 重启机器人，私聊发送/phi bind 你的sessionToken绑定账号，默认国服
4. 发送/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