phi-plugin 为查询Phigros信息的插件，包括b30、score、userinfo以及更多Phigros相关功能，有相关的建议和问题可以在Issues中提出，欢迎PR。
具体功能可在安装插件后 通过 /phihelp 查看详细指令
在Yunzai目录下运行
使用Github
#安装插件本体
git clone --depth=1 https://github.com/Catrong/phi-plugin.git ./plugins/phi-plugin/ #进入插件目录
cd ./plugins/phi-plugin/ #安装插件所需依赖
pnpm install -P
使用Gitee
#安装插件本体
git clone --depth=1 https://gitee.com/catrong/phi-plugin.git ./plugins/phi-plugin/
#进入插件目录
cd ./plugins/phi-plugin/
#安装插件所需依赖
pnpm install -P Warning
请使用主人权限执行该指令以下载曲绘，否则相关曲绘将无法正常展示！（可以是标准输入或者其他平台）
/phi downill
Tip
如果安装依赖时速度过慢，运行：
pnpm config set registry https://registry.npmmirror.com
优化界面设计
加入收集品、头像等的图鉴
点phi的歌
优化扫码获取sessionToken
指令修改部分设置
曲目历史定数查询
谱面标签
适配TapTap国际版
……
以下#均可用/代替，命令头可自定义
| 功能名称 | 功能说明 |
|---|---|
#phi帮助 | 获取帮助 |
#phi (cn|gb)?(bind|绑定)xxx | 绑定sessionToken，支持国服/国际服，默认为国服 |
#phi (unbind|解绑) | 仅清除当前 Bot 本地保存的 sessionToken、API ID、存档和历史，不修改 API 平台绑定 |
#phi clean | 删除所有记录 |
#phi (update|更新存档) | 更新存档 |
#phi (rks|pgr|b30) | 查询rks，会提供得出的b30结果 |
#phi x30 | 查询1Good b30 |
#phi fc30 | 查询Full Combo b30 |
杠批比三零 | 同上 |
#phi info(1|2)? | 查询个人统计信息 |
#phi lmtacc [0-100] | 计算限制最低 ACC 后的 RKS |
#phi (lvsco(re)|scolv) <定数范围> <难度> | 获取区间成绩 |
#phi chap <章节名称|help> | 获取章节成绩 |
#phi ahv <定数>[-v 版本] | 获取定数成绩表 |
#phi list <-dif 定数范围> <-acc ACC范围> <EZ|HD|IN|AT> <NEW|C|B|A|S|V|FC|PHI> | 获取区间每首曲目的成绩 |
#phi hisb30 | 根据历史记录计算B30变化情况 |
#phi best1(+) | 查询文字版b30（或更多），最高b99 |
#phi (score|单曲成绩)xxx [-dif 难度] [-or acc|score|fc|time] [-unrank] | 获取单曲成绩及这首歌的推分建议，参数为对分数排行的参数，目前仅开启API后有效 |
#phi (suggest|推分) | 获取可以让RKS+0.01的曲目及其所需ACC |
#phi (ranklist|排行榜) [名次] | 获取 RKS 排行榜 |
#phi rankfind <rks> | 获取有多少人大于查询 RKS |
#phi data | 获取用户data数量 |
#phi (guess|猜曲绘) [-l <0-3>] | 猜曲绘，回答无特殊命令，直接回复，如果不是曲名就不会说话，如果是不正确的曲名会回复。#ans 结束 |
#phi (ltr|开字母) | 根据字母猜曲名，#出/#open... 开指定的字母，#第n个/#nX.xxx 进行回答，#ans 获取答案 |
#phi (tipgame|提示猜曲) | 根据提示猜曲名，#tip获得下一条提示，#ans 获取答案，回答直接回复 |
#phi (song|曲) xxx | 查询phigros中某一曲目的图鉴，支持设定别名 |
#phi chart <曲名> [难度=IN] | 查询phigros中某一谱面的详细信息 |
#phi tag <曲名> [难度=IN] <标签> | 查看谱面标签，标签可选项见回复说明，难度默认为IN |
#phi settag <曲名> [难度=IN] <标签> | 给谱面打标签，推荐先使用/tag查询标签列表，难度默认为IN |
#phi (comment|cmt|评论|评价) <曲名> [难度=IN](换行)<内容> | 评论曲目，难度默认为IN |
#phi recmt <评论ID> | 查看并确认是否删评，仅发送者和主人权限，需要二次确认 |
#phi mycmt | 查看自己的云端评论 |
#phi (table|定数表) <定数> | 查询phigros定数表 |
#phi (difHis|历史定数) | 查询曲目历史定数 |
#phi new | 查询更新的曲目 |
#phi tips | 随机tips |
#phi jrrp | 今日人品 |
#phi alias xxx | 查询某一曲目的别名 |
#phi (rand|随机) [定数] [难度] | 根据条件随机曲目，条件支持难度、定数，难度可以多选，定数以-作为分隔 |
#phi randclg [课题总值] [难度] ([曲目定数范围]) | 随机课题 eg: /rand 40 (IN 13-15) |
#phi (曲绘|ill|Ill) xxx | 查询phigros中某一曲目的曲绘 |
#phi (search|查询|检索) <条件 值> | 检索曲库中的曲目，支持BPM 定数 物量，条件 bpm dif cmb，值可以为区间，以 - 间隔 |
#phi (theme|主题) [编号] | 切换绘图主题，页面级样式按主题包配置生效 |
#phi (myset|个人设置) | 查看和修改用户设置，参数为设置项名称，值支持使用序号选择，建议先查看设置项列表 |
sign/签到 | 签到获取Notes |
task/我的任务 | 查看自己的任务 |
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 |
#下载曲绘|down ill | 下载曲绘到本地 |
#phi get <名次> | 获取排行榜上某一名次的sessionToken |
#phi del <sessionToken> | 禁用某一sessionToken |
#phi allow <sessionToken> | 恢复某一sessionToken |
#phi (set|设置)<功能><值> | 修改设置，建议先/phi set查看功能名称，没有空格 |
#phi ban <功能> | 禁用某一类功能，详见 功能参数说明 |
#phi 获取Bot认领链接 | 主人命令 获取 15 分钟内有效的 Bot 平台认领链接，建议私聊发送 |
#phi 重置API Bot身份 | 主人命令 重新申请一套 API Bot 身份，仅用于凭据丢失、被撤销或主动更换身份 |
功能参数说明
| 参数 | 功能 | 影响指令 |
|---|---|---|
| 全部 | 全部功能 | 所有 |
| help | 帮助功能 | /help /tkhelp /myset |
| bind | 绑定功能 | /bind /unbind |
| b19 | 图片查分功能 | /pgr /update /info /list /pb30 /p30 /lmtacc /score /lvsco /chap /suggest |
| wb19 | 文字查分功能 | /data /best |
| song | 图鉴功能 | /song /chart /ill /search /alias /rand /randclg /table /cmt /recmt /addtag /subtag /retag |
| ranklist | 排行榜功能，不会禁用用户排名 | /ranklist /godlist |
| fnc | 小功能 | /com /tips /new |
| tipgame | tip猜歌 | /tipgame |
| guessgame | 猜歌 | /guess |
| ltrgame | 猜字母 | /letter /ltr |
| sign | 娱乐功能 | /sign /send /task /retask /jrrp |
| setting | 系统设置 | /theme |
| dan | 段位认证相关 | /dan /danupdate |
可在设置项手动设置打开与关闭，开启后，将自动同步用户在Phi-Plugin系列应用（网页、云崽，暂不含koishi）使用记录与历史成绩到API端，且部分功能需要开启API后才能使用
| 功能名称 | 功能说明 |
|---|---|
#phi (bind|绑定) <userId> | 开启查分API可用，绑定API账号 |
#phi setApiToken <token> | 设置API Token |
#phi tokenList | 获取当前绑定的平台列表 |
#phi auth <api Token> | 通过API Token 获取 sessionToken |
#phi alias submit 曲目 | 别名 | 备注 | 私聊提交曲目别名提案 |
#phi alias mine | 查询自己的别名提案 |
#phi alias appeal 提案ID | 理由 | 私聊申请公开评审 |
#phi alias public | 查询正在公开投票的提案 |
#phi alias vote 提案ID 赞成/反对 | 参与公开投票或改票 |
#phi alias unvote 提案ID | 撤回公开投票 |
#phi clearApiData | 永久注销 phi-api 账号并清除云端数据，需要 Phigros SSTK 权限及二次确认 |
#phi updateHistory | 将BOT端的历史成绩更新到API端 |
#phi updateUserToken | 主人命令 上传当前BOT端的用户Token到API端 |
认领用于把当前 phi-plugin 部署关联到已登录的网页账号，以便在网页控制台查看 Bot 状态、绑定统计和进行管理。Bot 在 API 注册成功后已经可以正常工作，未认领不会影响 Bot 激活或用户查分。
认领步骤：
- 将 phi-plugin 更新到支持 Bot 平台认证的版本，并确认配置项
openPhiPluginApi已开启。 - 启动或重启一次 Bot。插件缺少 API Bot 身份时会自动向 API 注册，并将凭据写入本地配置；请勿公开或手工发送
apiBotClientSecret。 - Bot 主人在私聊中发送
#phi 获取Bot认领链接（也可使用#phi botClaimLink）。 - 在 15 分钟内打开 Bot 返回的认领链接。若网页尚未登录，请先完成登录，随后继续原认领页面。
- 核对页面显示的 Bot 名称和
clientId，确认认领。完成后可在网页控制台的 Bot 管理页面查看和管理该 Bot。
认领链接为一次性链接，过期或使用后需重新发送命令获取。在群聊中执行时，插件不会把链接发到群内，而会将链接输出到 Bot 控制台；建议改为私聊执行。
#phi 重置API Bot身份（别名 #phi resetApiBot）会申请全新的 clientId 和 secret，并替换当前 Bot 身份。该命令不是正常认领步骤，只应在本地凭据丢失、身份被 API 撤销或确定要更换 Bot 身份时使用；重置后需要重新认领。为避免敏感信息泄露，在群聊中执行时，新的身份信息和认领链接只会输出到 Bot 控制台。
仅通过查分ID即可绑定与获取存档，首次使用sessionToken绑定时会将API Token设置为sessionToken，且用户绑定时若提供sessionToken，bot端本地会保存。
感谢您的支持，您的支持就是我创作的最大动力！
感谢以下赞助者对本项目的支持，鸣谢名单可能更新不及时，欢迎来QQ催我！
@Loser_X 🌸 20 🌸 | @Steve~ɘvɘɈƧ 🌸 40 🌸 |  溯洌RIPPLE 🌸 35 🌸 |  祈 🌸 15 🌸 |  茗亿 🌸 30 🌸 |  ... 🌸 50 🌸 |  夏夏肃炎 🌸 5 🌸 |  Bluerosion 🌸 52.0 🌸 |  铃 🌸 5 🌸 |
| Best30效果图 效果图来自@Steve喵~ | 单曲成绩效果图 效果图来自@Steve喵~ 单曲成绩效果图（Legacy） 效果图来自@Steve喵~ 单曲图鉴效果图 |
|---|---|
| 范围成绩效果图 效果图来自@东城Eastown 个人信息效果图 效果图来自@Steve喵~ | 个人信息效果图（Legacy） 效果图来自@东城Eastown |
感谢以下贡献者对本项目做出的贡献
- 功能仅限内部交流与小范围使用，请勿将
Yunzai-Bot及phi-Plugin用于任何以盈利为目的的场景. - 图片与其他素材均来自于网络，仅供交流学习使用，如有侵权请联系，会立即删除.
- 云存档由 7aGiven/PhigrosLibrary 改写而来
| Yunzai-Bot 相关内容索引 | Yunzai-Bot | Miao-Yunzai | TRSS-Yunzai |