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.0

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.0
File Size Uploaded
nonebot_plugin_maimaidx-3.1.0.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for nonebot-plugin-maimaidx 3.1.0
File Interpreter ABI Platform
nonebot_plugin_maimaidx-3.1.0-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.0.tar.gz

Download URL nonebot_plugin_maimaidx-3.1.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums 		c6041061865a554e05a5ea4e92e97e81abb9a1ab05857652a465254da9d11f85
BLAKE2b-256 checksum
How to use checksums 		c692fe86b2cdc0f9ad7db7d7b9734f48ddcb29069872d083664134fcfb87f0c4
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.0-py3-none-any.whl

Download URL nonebot_plugin_maimaidx-3.1.0-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums 		501111876b1fb82125fb046b7580dad5df33f9b1bd8cd112419f97d59a359734
BLAKE2b-256 checksum
How to use checksums 		265ce73c4a54a48bf5f42c2db74f984f4921fc19d19e7109d39c9a7bbee1326f
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

3.1.1

2 release files

This release

3.1.0 This release

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