nonebot-plugin-maimaidx

python3 License

欢迎加入开发交流群：QQGroup

重要更新

2026-08-20

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

2026-06-09

现仅支持 Python 3.10+ ！！！

最好在更新 舞萌DX 2026 后再使用该版本

  1. 更新支持 舞萌DX2026，应该是最后一次大改了
  2. 新支持了 落雪查分器
  3. 新功能：
    • 新增 舞，霸者 牌子绘图
    • 新增进度绘图
    • 新增查询曲目过多时的绘图
    • 新增切换主题功能
    • 新增切换查分器功能
    • 新增 ap50 指令（仅限落雪查分器）
    • 新增 lxbind，主题，数据源 指令
    • 新增 牌子条件 指令
  4. 修改了别名推送的发送方式，防止刷屏
  5. 修复了非常多的 BUG

温馨提示

请务必看完 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 文件夹

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

  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_TOKEN=                    # 开发者 token，已弃用，见下方说明
DIVINGFISH_PROBER_PROXY=false        # 是否使用中转访问水鱼查分器，适用于境外服务器

# 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 绑定，默认允许群聊和私聊

指令

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

img

更新说明

Version 3.0 更新日志

2026-08-20

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

2026-06-30

  1. 替换 rating 数字新素材，直接覆盖 mai/pic 目录，增量包：

  2. 恢复查询TA人成绩的功能

  3. 修复15完成表绘图偏移的问题

  4. 修复进度表完成时文字重叠的问题

  5. 优化部分绘图

  6. 修复部分bug

2026-06-09

  1. 更新支持 舞萌DX2026，应该是最后一次大改了
  2. 新支持了 落雪查分器
  3. 新功能：
    • 新增 舞，霸者 牌子绘图
    • 新增进度绘图
    • 新增查询曲目过多时的绘图
    • 新增切换主题功能
    • 新增切换查分器功能
    • 新增 ap50 指令（仅限落雪查分器）
    • 新增 lxbind，主题，数据源 指令
    • 新增 牌子条件 指令
  4. 修改了别名推送的发送方式，防止刷屏
  5. 修复了非常多的 BUG

鸣谢

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

License

MIT

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

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.1.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for yuzuchan from gravatar.com yuzuchan

Credits

Author: Yuri-YuzuChaN

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

Metadata

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.1.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for yuzuchan from gravatar.com yuzuchan

Credits

Author: Yuri-YuzuChaN

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

Release files for nonebot-plugin-maimaidx 3.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nonebot-plugin-maimaidx 3.1.1
File Size Uploaded
nonebot_plugin_maimaidx-3.1.1.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for nonebot-plugin-maimaidx 3.1.1
File Interpreter ABI Platform
nonebot_plugin_maimaidx-3.1.1-py3-none-any.whl 1.1 MB Python 3 none any Details

Total release size: 2.2 MB

Release files / nonebot_plugin_maimaidx-3.1.1.tar.gz

Download URL nonebot_plugin_maimaidx-3.1.1.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums 		b4565ca683012b3bf2ba4590e420a5b0cb5148689653b7665ada3e3c9c522ba9
BLAKE2b-256 checksum
How to use checksums 		edc3d9e11ed0e5a3304269c5c2e10c2a11c290d85a9c9afd73711adc21cfe997
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/6.1.0 CPython/3.11.0

Release files / nonebot_plugin_maimaidx-3.1.1-py3-none-any.whl

Download URL nonebot_plugin_maimaidx-3.1.1-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums 		f26e7433ea597f0f6719a58ff07785e0cdb426f2fc1a71ca32cd5479df7fca72
BLAKE2b-256 checksum
How to use checksums 		d71f94fb94da6aca6374d5f210709ed85dbac015ed1b95f4179e4eb043a1aacb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/6.1.0 CPython/3.11.0

Release history Release notifications | RSS feed

3.1.3

2 release files

3.1.2

2 release files

This release

3.1.1 This release

2 release files

3.1.0

2 release files

3.0.14

2 release files

3.0.13

2 release files

3.0.12

2 release files

3.0.11

2 release files

3.0.10

2 release files

3.0.9

2 release files

3.0.8

2 release files

3.0.7

2 release files

3.0.6

2 release files

3.0.5

2 release files

3.0.4

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.1.11

2 release files

2.1.10

2 release files

2.1.9

2 release files

2.1.8

2 release files

2.1.7

2 release files

2.1.6

2 release files

2.1.5

2 release files

2.1.4

2 release files

2.1.3

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.7

2 release files

2.0.6

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

Pre-release

2.0.0b1

2 release files

1.0.15

2 release files

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.10

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.13

2 release files

0.0.12

2 release files

0.0.11

2 release files

0.0.10

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page