phi-plugin：Phigros 成绩查询与曲目查询助手

phi-pluginPhigros 成绩查询与曲目查询助手【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件支持查询分数等信息统计以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin如果你正在维护 Yunzai-Botv3机器人phi-plugin 是一个可以直接接入的 Phigros 信息查询插件它读取玩家的存档数据帮你查询 RKS、best30、单曲成绩也能查谱面、曲绘和定数表再配上几个猜曲小游戏玩家不用离开群聊就能完成大部分查询。它解决什么使用痛点群里经常有人问“我的 b30 是多少”“下一首推哪首歌”。绑定后机器人直接基于存档计算并回复省去了手动导出统计的麻烦。曲目信息比较分散谱面详情、定数表、随机选曲、猜曲互动被收进同一个指令入口减少来回翻资料。多人使用的机器人有管理需求可以按功能开关ban禁用某类指令也可以备份、还原存档数据。核心能力与常见用法玩家首次使用需要先绑定 sessionToken支持国服与国际服token 只保存在 Bot 本地。常用的几类动作成绩查询#phi pgr或 b30算出 RKS 与 best30#phi lmtacc可以模拟“限制最低 ACC 后”的 RKS#phi lvsco、#phi chap查看区间和章节成绩。曲目工具#phi song看曲目图鉴#phi table查定数表#phi search按 BPM、定数、物量检索曲库#phi rand按条件随机选曲。推分建议#phi suggest告诉你“哪首歌、打到多少 ACC”能让 RKS 0.01。群内小游戏猜曲绘、开字母、提示猜曲三种玩法直接回复作答#ans结束。管理侧自定义指令头、功能禁用、备份还原存档、切换绘图主题等。适合哪些场景Phigros 玩家群作为群机器人承担查分、查曲、排行榜展示配合签到、任务等轻互动活跃气氛。推分期的玩家绑定后反复查看区间成绩与推分建议规划练习曲目。机器人运营者把它当作 Yunzai-Bot v3 的一个插件部署如果打算自己写插件它的目录划分apps 放指令、model 放数据逻辑、components/platform 放平台适配也值得参考。快速上手路径把插件放进 Yunzai-Bot 的 plugins 目录克隆地址为 https://gitcode.com/gh_mirrors/ph/phi-plugin用 pnpm 安装依赖网络慢时可切换到国内镜像源。用主人权限执行/phi downill下载曲绘否则曲绘无法正常展示。私聊机器人执行#phi bind sessionToken完成绑定再用#phi pgr验证查询。输入/phihelp查看全部指令按需调整指令头和功能开关。技术实现上的关键取舍图表渲染使用 Puppeteer 驱动 ECharts 生成成绩图观感比纯文本好代价是运行时有浏览器开销机器配置低时可关注内存占用。平台适配components/platform 层抽象了 Yunzai 与 Koishi 的差异指令逻辑与平台解耦换框架时改动较小。凭据处理sessionToken 仅保存在 Bot 本地“解绑”只清理本地数据不影响 API 平台侧的绑定两者边界划分得比较清楚。API 模式开启后会把使用记录和历史成绩同步到 API 端部分功能如单曲推分建议依赖该开关属于可选项而非默认行为。使用边界与注意事项项目定位为内部交流与小型场景使用请勿用于盈利目的。曲绘下载、排行榜名次查询、禁用/恢复 token 等命令需要主人权限群成员无权限执行。备份文件里包含 token 与存档数据转发时注意范围。依赖 API 的功能如果未开启会提示不可用遇到报错先确认openPhiPluginApi相关设置项。小结与下一步动作phi-plugin 把 Phigros 的成绩统计和曲目资料变成了群聊里的一条指令。建议你先搭好 Yunzai-Bot v3安装插件并完成一次绑定查询再根据群的需求关闭用不到的功能模块。完整命令清单可参考 README。【免费下载链接】phi-plugin适用于 Yunzai-Bot V3 的 phigros 信息查询插件支持查询分数等信息统计以及猜曲目等小游戏项目地址: https://gitcode.com/gh_mirrors/ph/phi-plugin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考