nonebot-plugin-endfield

March 6, 2026 · View on GitHub

nonebot-plugin-endfield 是一个基于 NoneBot2 的《明日方舟：终末地》插件，支持扫码绑定、账号切换、信息卡、森空岛签到、公告获取与抽卡记录分析。

功能特性

  • 扫码绑定终末地账号（自动轮询二维码状态）
  • 单 QQ 多账号管理与快速切换
  • 生成终末地信息卡图片
  • 森空岛签到
  • 获取最新终末地公告（图片化展示）
  • 抽卡记录同步 / 分页查看 / 抽卡分析 / 全服抽卡统计

环境要求

  • Python >=3.9
  • NoneBot2 >=2.0.0,<3.0.0
  • 适配器：nonebot-adapter-onebot

安装

使用 nb-cli

nb plugin install nonebot-plugin-endfield

使用包管理器

pip install nonebot-plugin-endfield
# 或
pdm add nonebot-plugin-endfield
# 或
poetry add nonebot-plugin-endfield

在 NoneBot 项目的 pyproject.toml 中启用插件：

[tool.nonebot]
plugins = ["nonebot_plugin_endfield"]

配置

https://end.shallow.ink/ 取得API Key后 在 .env 文件中配置：

配置项必填默认值说明
endfield_api_key是无终末地 API 服务密钥，未配置时插件核心功能不可用
endfield_api_baseurl否https://end-api.shallow.ink/API 服务基地址

示例：

endfield_api_key=your_api_key_here
endfield_api_baseurl=https://end-api.shallow.ink/

指令说明

账号与基础功能

指令别名/说明
终末地帮助别名：终末地；查看插件帮助与指令列表
终末地绑定别名：endfield绑定、终末地扫码绑定
终末地切换账号别名：endfield切换账号、终末地账号切换；可带序号或角色 ID
终末地信息卡别名：终末地名片、终末地卡片、endfield信息卡
签到执行森空岛签到（需先绑定）
终末地公告获取最新公告并以图片发送

抽卡相关

指令说明
抽卡记录 [页码]查看本地缓存抽卡记录；无记录时会先自动同步
抽卡分析生成抽卡分析图；无记录时会先同步
全服抽卡统计 [卡池关键词]查看全服统计，支持关键词筛选卡池
同步全部抽卡仅 Bot superusers 可用，批量触发已绑定账号同步

当出现多账号选择时，按提示发送数字序号（1-999）即可继续。

数据存储

插件使用 nonebot-plugin-localstore 管理数据目录，并在插件专属 data 目录下写入数据（可通过 localstore 配置项自定义）：

  • endfield_bindings_v3.db：账号绑定与当前激活账号
  • gacha/*.json：抽卡缓存数据
  • gacha_pending_select.json：抽卡同步中的临时选择状态

注意事项

  • 可通过环境变量覆盖字体路径：ENDFIELD_FONT_BOLD_PATH、ENDFIELD_FONT_PATH、ENDFIELD_FONT_REGULAR_PATH。
  • 若提示 API 请求失败，请优先检查 endfield_api_key 与 endfield_api_baseurl。
  • 本插件依赖外部终末地 API 服务，服务可用性会直接影响功能。

其他框架插件

许可证

AGPL v3