https://github.com/molanp/phi-plugin-zhenxun
适用于 zhenxun_bot 的 phigros 辅助插件，支持查询分数信息等功能，以及猜曲目等小游戏（即将完工
https://github.com/molanp/phi-plugin-zhenxun
nonebot nonebot2 phi-plugin phigros plugin zhenxun zhenxun-bot zhenxun-plugin
Last synced: 9 months ago
JSON representation
适用于 zhenxun_bot 的 phigros 辅助插件，支持查询分数信息等功能，以及猜曲目等小游戏（即将完工
- Host: GitHub
- URL: https://github.com/molanp/phi-plugin-zhenxun
- Owner: molanp
- License: gpl-3.0
- Created: 2025-04-11T10:56:58.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-08T17:54:41.000Z (11 months ago)
- Last Synced: 2025-08-08T19:34:15.941Z (11 months ago)
- Topics: nonebot, nonebot2, phi-plugin, phigros, plugin, zhenxun, zhenxun-bot, zhenxun-plugin
- Language: JavaScript
- Homepage:
- Size: 38.3 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/molanp/zhenxun_plugin_phi-plugin/stargazers)
[](https://github.com/zhenxun-org/zhenxun_bot)
当前同步版本号
当前同步的版本
[9d8a6d86ad050382783993536c212a0f11c5a8b8](https://github.com/Catrong/phi-plugin/commit/9d8a6d86ad050382783993536c212a0f11c5a8b8)
[已落后的变更](https://github.com/Catrong/phi-plugin/compare/9d8a6d86ad050382783993536c212a0f11c5a8b8...main)
> [!IMPORTANT]
>
> 当前 `Save -> gameRecord: dict[str, list["LevelRecordInfo | None"]]` 的 `LevelRecordInfo` 补全存在严重的性能问题，正在着手解决但希望渺茫
## 🏃♀️ 我跑路了
由于无法解决性能问题，我跑路了，等有大佬能解决了再说，不写了不写了(˙꒫˙`)
## 长期寻求合作者共同开发
当前插件功能全部移植完成，正在逐步**测试**各个功能，全部测试通过后将会正式上架插件商店
## 任务列表
- [x] 移植依赖
- [x] 移植 `apiSetting` (**已被放逐**)
- [x] 移植 `b19`
- [x] 移植 `Dan`
- [x] 移植 `guessGame`
- [x] 移植 `help`
- [x] 移植 `jrrp`
- [x] 移植 `manage`
- [x] 移植 `money`
- [x] 移植 `phisong`
- [x] 移植 `RankList`
- [x] 移植 `session`
- [x] 移植 `setting` (**不支持**)
- [x] 移植 `update` (**不支持**)
- [x] 移植 `user`
- [ ] 测试功能
- [ ] `b19`
- [ ] `Dan`
- [ ] `guessGame`
- [ ] `help`
- [ ] `jrrp`
- [ ] `manage`
- [ ] `money`
- [ ] `phisong`
- [ ] `RankList`
- [ ] `session`
- [ ] `user`
- [ ] 整理代码逻辑
- [ ] 优化代码性能
### 介绍
`phi-plugin` 为查询 Phigros 信息的插件，包括 b30、score、userinfo 以及更多 Phigros 相关功能，有相关的建议和问题可以在[Issues](./issues)中提出，欢迎[PR](./pulls)。
具体功能可在安装插件后 通过 `/phi help` 查看详细指令
> **以下 `/phi` 为插件默认前缀，可以在配置文件(`/data/config.yaml`)中修改**
>
> 用户输入时，前缀和命令中间的空格**不是必需的**
>
> 括号内斜杠分隔的命令表示别名
## 📚 插件功能
#### **以下为用户功能**
| **功能名称** | **功能说明** |
| :-------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- |
| `/phi帮助` | 获取帮助 |
| `/phi (bind\|绑定)xxx` | 绑定 sessionToken |
| `/phi (unbind\|解绑)` | 删除 sessionToken 和存档记录 |
| `/phi clean` | 删除所有记录 |
| `/phi (update\|更新存档)` | 更新存档 |
| `/phi (rks\|pgr\|b30)` | 查询 rks，会提供得出的 b30 结果 |
| `杠批比三零` | 同上 |
| `/phi info(1\|2)?` | 查询个人统计信息 |
| `/phi lmtacc [0-100]` | 计算限制最低 ACC 后的 RKS |
| `/phi (lvsco(re)\|scolv) <定数范围> <难度>` | 获取区间成绩 |
| `/phi chap <章节名称\|help>` | 获取章节成绩 |
| `/phi list <定数范围> ` | 获取区间每首曲目的成绩 |
| `/phi (score\|单曲成绩)xxx` | 获取单曲成绩及这首歌的推分建议 |
| `/phi (suggest\|推分)` | 获取可以让 RKS+0.01 的曲目及其所需 ACC |
| `/phi (ranklist\|排行榜)` | 获取 RKS 排行榜 |
| `/phi data` | 获取用户 data 数量 |
| `/phi (guess\|猜曲绘)` | 猜曲绘，回答无特殊命令，直接回复，如果不是曲名就不会说话，如果是不正确的曲名会回复。#ans 结束 |
| `/phi (ltr\|开字母)` | 根据字母猜曲名，`/phi 出` `/phi open`... 开指定的字母，`/phi 第n个` `/phi nX.xxx` 进行回答，`/phi ans` 获取答案 |
| `/phi (tipgame\|提示猜曲)` | 根据提示猜曲名，#tip 获得下一条提示，#ans 获取答案，回答直接回复 |
| `/phi (song\|曲) xxx` | 查询 phigros 中某一曲目的图鉴，支持设定别名 |
| `/phi chart <曲名> <难度>` | 查询 phigros 中某一谱面的详细信息 |
| `/phi (addtag\|subtag\|retag) <曲名> <难度> <标签>` | 对某个标签赞成、反对或撤销表态，难度默认为 IN |
| `/phi (comment\|cmt\|评论\|评价) <曲名> <难度?>(换行)<内容>` | 评论曲目，难度默认为 IN |
| `/phi recmt <评论ID>` | 查看并确认是否删评，仅发送者和主人权限，需要二次确认 |
| `/phi mycmt` | 查看自己的全部评论 |
| `/phi (table\|定数表) <定数>` | 查询 phigros 定数表（B 站[@yuhao7370](space.bilibili.com/275661582)） |
| `/phi new` | 查询更新的曲目 |
| `/phi tips` | 随机 tips |
| `/phi jrrp` | 今日人品 |
| `/phi nick xxx` | 查询某一曲目的别名 |
| `/phi (rand\|随机) [定数] [难度]` | 根据条件随机曲目，条件支持难度、定数，难度可以多选，定数以-作为分隔 |
| `/phi randclg [课题总值] [难度] ([曲目定数范围])` | 随机课题 eg: /rand 40 (IN 13-15) |
| `/phi (曲绘\|ill\|Ill) xxx` | 查询 phigros 中某一曲目的曲绘 |
| `/phi (search\|查询\|检索) <条件 值>` | 检索曲库中的曲目，支持 BPM 定数 物量，条件 bpm dif cmb，值可以为区间，以 - 间隔 |
| `/phi (theme\|主题) [0-2]` | 切换绘图主题，仅对 b30, update, randclg, sign, task 生效 |
| `/phi sign/签到` | 签到获取 Notes |
| `/phi task/我的任务` | 查看自己的任务 |
| `/phi retask/刷新任务` | 刷新任务，需要花费 20Notes |
| `/phi (send\|送\|转) <目标> <数量>` | 送给目标 Note，支持@或 QQ 号 |
#### **以下为管理功能**
| 功能名称 | 功能说明 |
| :------------------------------------- | :--------------------------------------------------------------------------------------------------- |
| `/phi backup (back)?` | 备份存档文件，+ back 发送该备份文件，自动保存在 /phi-plugin/backup/ 目录下 |
| `/phi restore` | 从备份中还原，不会丢失已有数据，需要将文件放在 /phi-plugin/backup/ 目录下 |
| `/phi(设置别名\|setnick) xxx ---> xxx` | 设置某一歌曲的别名，格式为 原名(或已有别名) ---> 别名（会自动过滤--->两边的空格） |
| `/phi(删除别名\|delnick) xxx` | 删除某一歌曲的别名 |
| `/phi(强制\|qz)?(更新\|gx)` | 更新本插件 |
| `/phi repu` | 重启 puppeteer |
| `/phi 下载曲绘\|downill` | 下载曲绘到本地 |
| `/phi get <名次>` | 获取排行榜上某一名次的 sessionToken |
| `/phi del ` | 禁用某一 sessionToken |
| `/phi allow ` | 恢复某一 sessionToken |
| `/phi (set\|设置)<功能><值>` | 修改设置，建议先/phi set 查看功能名称，没有空格 |
| `/phi ban <功能>` | 禁用某一类功能，详见 [功能参数说明](/phi-ban-%E5%8A%9F%E8%83%BD%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E) |
功能参数说明
#### `/phi ban` 功能参数说明
| 参数 | 功能 | 影响指令 |
| :-------- | :--------------------------- | :---------------------------------------------------------- |
| 全部 | 全部功能 | 所有 |
| help | 帮助功能 | /help /tkhelp |
| bind | 绑定功能 | /bind /unbind |
| b19 | 图片查分功能 | /pgr /update /info /list /pb30 /score /lvsco /chap /suggest |
| wb19 | 文字查分功能 | /data |
| song | 图鉴功能 | /song /ill /search /alias /rand /randclg /table |
| ranklist | 排行榜功能，不会禁用用户排名 | /ranklist /godlist |
| fnc | 小功能 | /com /tips /lmtacc /new |
| tipgame | tip 猜歌 | /tipgame |
| guessgame | 猜歌 | /guess |
| ltrgame | 猜字母 | /letter /ltr |
| sign | 娱乐功能 | /sign /send /task /retask /jrrp |
| setting | 系统设置 | /theme |
| dan | 段位认证相关 | /dan /danupdate |
---
### 部分功能预览
| **Best30 效果图**
| **单曲成绩效果图**
![]()
**单曲成绩效果图（Legacy）**
![]()
**单曲图鉴效果图**
![]()
|
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| **范围成绩效果图**
![]()
**个人信息效果图**
![]()
| **个人信息效果图（Legacy）**
![]()
|
---
## 💕 感谢
- [Catrong/phi-plugin](https://github.com/Catrong/phi-plugin) 适用于 Yunzai-Bot V3 的 phigros 辅助插件，支持查询分数信息等功能，以及猜曲目等小游戏
- [@Windows10555](https://github.com/Windows10555) LOGO 后期处理
- [nonebot/nonebot2](https://github.com/nonebot/nonebot2) 跨平台 Python 异步机器人框架
- [zhenxun-org/zhenxun_bot](https://github.com/zhenxun-org/zhenxun_bot) 基于 Nonebot2 开发，实现多平台适配和多 Bot 管理的，非常可爱的绪山真寻 Bot
- [Teahouse-Studios/akari-bot](https://github.com/Teahouse-Studios/akari-bot) 茶馆群内机器人（小可）