nonebot-plugin-maimaidx

欢迎加入开发交流群：QQGroup

重要更新

2026-11-02

1. 新版本已完全废弃水鱼开发者Token，请前往水鱼 开发者控制台 申请新应用，使用OAuth认证，未配置或者未授权仅可使用 b50 指令
2. 修改了水鱼查分器的请求方式，移除废弃API端点
3. 修复使用水鱼查分器查询b50无法显示 镜 牌的问题，牌子可自行修改 plate_version 文件夹内的所有 镜 牌为繁体字的 鏡。以下压缩包包含新的曲目 魔法仕掛けのファンタジア 曲绘，新的 鏡 牌和 廻 牌文件
   • cloudreve
   • onedrive
   • openlist
4. 修复 我要上分 指令计算问题
5. 修复合并别名的时，出现不存在的曲目ID

2026-08-20

1. 水鱼查分器新增 OAuth 认证，请根据 配置 示例填入相关 后续开发者Token将被废弃
2. 新增 dfbind 指令
3. 使用 SSE 替代 websocket 推送
4. 移除了申请别名通过和拒绝的推送
5. 修改部分绘图

温馨提示

请务必看完 README.MD 所有内容

安装

1. 安装 nonebot-plugin-maimaidx

   • 使用 nb-cli 安装

     nb plugin install nonebot-plugin-maimaidx
     

   • 使用 pip 安装

     pip install nonebot-plugin-maimaidx
     

   • 使用源代码，请自行安装额外依赖

     git clone https://github.com/Yuri-YuzuChaN/nonebot-plugin-maimaidx
     

2. 安装 chromium，相关依赖已安装，请直接使用该指令执行

   playwright install --with-deps chromium
   

3. 安装 微软雅黑 字体，解决使用 ginfo 指令字体不渲染的问题，例如 ubuntu：apt install fonts-wqy-microhei

配置

1. 下载静态资源文件，将该压缩文件解压后，将 static 文件夹复制到随意一个文件夹进行存放。对于先前使用过的开发者，请将原先 static 文件夹内的所有 json 文件放置到 static/data 文件夹，字体文件放置到 static/font 文件夹

   对于美术的声明，请勿将绘图设计署名进行删除

   • Cloudreve私人云盘
   • onedrive
   • openlist

2. 配置可选项，请修改 .env 文件，并根据要求填写

   # maimaidx                           # 基本配置
   MAIMAIDX_PATH=                       # 必填项，静态文件夹路径，必须为绝对路径到 `/static`，例如：e:/SakuraBOT/nbstatic/maimaidx/static
   MAIMAIDX_ALIAS_PUSH=true             # 是否开启别名推送
   MAIMAIDX_ALIAS_PROXY=false           # 是否使用中转访问柚子别名服务器，适用于境内服务器
   SAVE_IN_MEMORY=true                  # 是否将部分图片保存在内存
   ASSETS_ONLINE=true                   # 对于有 `icon` 和 `plate` 资源的可将此项改为 `false`，如果没有请默认，否则使用落雪查分器时无法使用
   
   # diving-fish                        # 水鱼查分器配置
   DIVINGFISH_CLIENT_ID=                # OAuth 应用ID，向水鱼申请应用后获得
   DIVINGFISH_CLIENT_SECRET=            # OAuth 应用秘钥
   DIVINGFISH_SCOPE=""                  # OAuth 权限，根据应用权限进行填写，多个权限用空格隔开，默认值为 `"prober.profile.read"`
   DIVINGFISH_AUTH_URL=                 # 水鱼账号地址，一般不需要填写，默认为 `https://auth.diving-fish.com`
   DIVINGFISH_PROBER_PROXY=false        # 是否使用中转访问水鱼查分器，适用于境外服务器
   DIVINGFISH_TOKEN=                    # 开发者 token，已弃用，见下方说明
   
   # lxns                               # 落雪查分器配置，均未填写将无法使用落雪查分器
   LXNS_DEV_TOKEN=                      # 开发者 token
   LX_CLIENT_ID=                        # OAuth 应用ID，OAuth权限范围请选择前三项，不包括「读取个人API秘钥」
   LX_CLIENT_SECRET=                    # OAuth 应用秘钥
   REDIRECT_URI=                        # OAuth 回调地址
   LXNS_BIND_PRIVATE_ONLY=false         # 是否仅允许私聊完成 OAuth 绑定，默认允许群聊和私聊
   

指令

使用说明图后续再进行更换

更新说明

鸣谢

感谢 蓝色彗星 提供的 牌子条件 指令图片

License

MIT

您可以自由使用本项目的代码用于商业或非商业的用途，但必须附带 MIT 授权协议。