/osuv2

基于HoshinoBot V2的osu api v2版查询插件

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

osuv2

基于HoshinoBot v2的osu api v2版本的查询模块

项目地址：https://github.com/Yuri-YuzuChaN/osuv2

使用方法

  1. 将该项目放在HoshinoBot插件目录 modules 下，或者clone本项目 git clone https://github.com/Yuri-YuzuChaN/osuv2
  2. 在token.json填入申请的client_id，client_secret，access_token，refresh_token，如何申请token
  3. pip以下依赖：pillow，matplotlib，traceback
  4. 在config/__bot__.py模块列表中添加osuv2
  5. 重启HoshinoBot

注：pillow需要高于等于8.0.0版本

如何申请token

  1. 打开osu个人设置页面：https://osu.ppy.sh/home/account/edit ，拉到最下面开放授权页面。

  2. 点击新的 OAuth 应用，在弹出的窗口填入应用名称（随意），应用回调链接（第三方网站或自己的网站），点击注册应用程序，此时你已经拥有了OAuth客户端，包括token.json需要的client_id（客户端ID）、client_secret（客户端密钥）、以及申请token使用的应用回调链接。

  3. 在浏览器地址栏输入https://osu.ppy.sh/oauth/authorize?response_type=code&client_id=(客户端ID)&redirect_uri=(应用回调链接)&scope=public（不需要括号）

  4. 在跳转的页面点击授权（该步骤可能没有），授权后将会回调到你申请时填入的应用回调链接，地址栏会出现该链接：https://xxx.com/?code=code，保存code，code为一串非常长的代码，code只能使用一次，使用过后需要重新申请。

  5. 编辑osuv2目录下的get_token.py文件，填入code、client_id、client_secret、redirect_uri，保存并执行该脚本，执行成功后目录下会出现token.json文件，否则为请重新进行第三步.json文件，token.json的内容为：

    {
    "client_id": 0000, //客户端ID
    "client_secret": "string", //客户端密钥
    "access_token": "verylongstring", //访问令牌
    "refresh_token": "anotherlongstring", //刷新令牌
}

    如果内容不是如上内容，请重新进行第三步

指令说明

如果下列表格看不懂可以可以查看 使用说明

指令 功能 可选参数 说明
osuhelp 查看指令大全
更新OAuth 更新token
info 查询信息 无 查询自己
[user] 查询TA人
:[mode] 查询自己其它模式，:为触发词
[user] :[mode] 查询TA人其它模式
bind 绑定 [user] 绑定用户名
unbind 解绑 无
update 更改或更新 mode [mode] 更改模式
pr 查询最近游玩pass记录 无 查询自己最近的游玩pass记录
[user] 查询TA人最近的游玩pass记录
:[mode] 查询自己最近游玩其它模式pass记录
[user] :[mode] 查询TA人最近游玩其它模式pass记录
re 查询最近游玩记录 无 查询自己最近的游玩记录
[user] 查询TA人最近的游玩记录
:[mode] 查询自己最近游玩其它模式记录
[user] :[mode] 查询TA人最近游玩其它模式记录
score 查询成绩 [mapid] 查询该地图成绩
[mapid] +[mods] 查询该地图附加mods成绩
[mapid] :[mode] 查询该地图其它模式成绩
[mapid] :[mode] +[mods] 查询该地图其它模式加mods的成绩
[user] [mapid] 查询TA人该地图成绩
[user] [mapid] :[mode] 查询TA人该地图其它模式成绩
[user] [mapid] +[mods] 查询TA人该地图加mods的成绩
[user] [mapid] :[mode] +[mods] 查询TA人该地图其它模式加mods的成绩
bp 查询bp榜成绩 [num] 查询bp成绩
[num] +[mods] 查询bp附加mods成绩
[num] :[mode] 查询其他模式的bp成绩
[num] :[mode] +[mods] 查询其他模式加mods的bp成绩
[user] [num] 查询TA人bp成绩
[user] [num] +[mods] 查询TA人bp附加mods成绩
[user] [num] :[mode] 查询TA人其他模式bp成绩
[user] [num] :[mode] +[mods] 查询TA人其他模式加mods的bp成绩
pfm 查询bp榜指定范围成绩 [min]-[max] 查询bp范围内成绩，最多10个
[min]-[max] :[mode] 查询其它模式bp范围内成绩
[min]-[max] +[mods] 查询bp范围内加mods的成绩
[min]-[max] :[mode] +[mods] 查询其它模式bp范围内加mods的成绩
[user] [min]-[max] 查询TA人bp，最多10个
[user] [min]-[max] :[mode] 查询TA人其它模式bp
[user] [min]-[max] +[mods] 查询TA人bp
[user] [min]-[max] :[mode] +[mods] 查询TA人其它模式bp范围内加mods的成绩
tbp 查询当天新增bp成绩 无 查询自己当天新增bp成绩
[user] 查询TA人当天新增bp成绩
:[mode] 查询自己其它模式当天新增bp成绩
[user] :[mode] 查询TA人其它模式当天新增bp成绩
tr 查询当天游玩Pass的谱面 无 查询自己当天游玩谱面
[user] 查询TA人当天游玩谱面
:[mode] 查询自己其它模式当天游玩谱面
[user] :[mode] 查询TA人其它模式当天游玩谱面
map 查询地图信息 [mapid] 查询地图信息
[mapid] +[mods] 查询地图加mod的信息，仅计算PP
getbg 提取背景 [mapid] 提取地图背景
bmap 查询图组信息 [setid] 查询图组信息
-b [mapid] 使用地图id查询图组信息
osudl 下载地图上传到群 [setid] 下载地图，setid 为图组id，非单图id

*[]内为需要填的参数

*mode：0-3分别为std，taiko，ctb，mania

即将实现

  1. pp+数据

更新说明

2022-10-12

  1. 重写画图，指令 score 和 bp 的逻辑
  2. 修复acc画图内存泄漏的问题
  3. 新增指令 pr，查询最近的游玩pass记录
  4. 新增指令 tr，查询当天游玩Pass的谱面
  5. 查询成绩不再下载整个地图谱面，只下载单一谱面且不保存，节省时间和空间
  6. 再次修改PP计算器api地址及PP请求源码，现已提供api使用说明：PP计算器API

2022-01-07

  1. 修改PP计算器api地址及PP请求源码，现已提供api使用说明：PP计算器API

2021-11-22

  1. 修复更新token失败时一直重复更新导致死循环的问题

2021-11-19

  1. 修复update指令无法更改查询模式的问题
  2. 修复pfm指令查询个别玩家bp不足100个的问题
  3. 修复新版本pp计算器返回结果不一致的问题

2021-11-11

  1. 新增tbp指令，查询当天新增的BP成绩，时间范围为当天的00:00到23:59
  2. 修复pfm指令无法查询TA的问题
  3. token的更新方式已修改为检测到token过期时自动更新，不在定时更新，手动更新的指令保留
  4. 优化不存在的用户的返回结果

2021-10-17

  1. 修复info指令无法查询未游玩过的模式

2021-10-16

  1. 修改数据库结构
  2. 修改token请求，不再重复读取文件
  3. 修改图片发送方式为base64编码，不再保存输出图片，以节省空间
  4. 修改bp指令的参数
  5. 修改std成绩图片，新增aim，acc，speed，if fc，if ss pp的计算
  6. 移除bp指令查询指定范围成绩的功能，修改为单独的指令pfm
  7. 移除smap指令，不再支持搜索地图
  8. 不再保存头像和头图，.osu文件，仅保留背景图片
  9. 新增全模式PP计算，提供api接口，无文档
  10. 新增指令pfm指令，查询指定范围成绩

2021-08-06

  1. 修复图版本获取失败的问题

2021-07-29

  1. 更新新版渐变色难度模式图标

2021-07-09

  1. 修复ctb和taiko模式pp变量错误

2021-07-08

  1. 修复无法自动更新个人信息的问题

2021-07-06

  1. 数据处理移动到data.py
  2. 修改部分函数名称
  3. 不再保存cover及badges图片
  4. 修改所有成绩图

2021-06-11

  1. 为区分图组与单图，已将图组bmapid修改为setid
  2. 修复地图在没有背景制图错误的问题
  3. 修复get_token.py无法申请token的问题
  4. 修改报错提示
  5. 将draw.py文件的FILEHTTP字符串移至http.py

2021-05-29

  1. 新增查询图组功能，指令：bmap [bmapid]，bmapid为图组id，或者使用地图idmapid查询图组，在指令加-b，例：bmap -b [mapid]
  2. 修改map指令，并增加音乐分享，音乐分享需使用http服务，请自行修改draw.py文件中的FILEHTTP字符串，将地址改为自己的服务器IP或域名，:{PORT}/map请勿删除
  3. 完善api请求，准确返回无法查询的错误
  4. 修复所有指令无法查询TA人的问题
  5. 修复指令@人无法查询的问题

2021-05-23

  1. 修改bp指令，改用图片的形式发送
  2. info，recent，score指令可使用@方式查询群友的成绩或信息

2021-05-16

  1. 修改map指令，改用图片的形式发送
  2. 修复smap指令搜索个别ranked地图没有背景的问题

2021-05-06

  1. 新增地图搜索功能，指令：[smap keyword]，keyword为关键词，可多个，默认搜索std模式ranked状态
  2. 新增地图下载功能，指令：[osudl bmapid]，bmapid为地图组id，非单图id

2021-05-04

  1. 支持mania模式pp计算

2021-05-02

  1. 修复map指令查询非ranked图时出错的问题
  2. 修复map指令查询mania图时无max combo的问题

2021-04-27

  1. 修复撒泼特错位
  2. 修复info的游玩时间
  3. 对比信息无法更新

2021-04-23

  1. 船新版本的osu插件