nonebot-plugin-ba-tools

📖 介绍

Important

由于学业繁忙(2025)，本项目暂时停止维护，如您有兴趣继续维护本项目，请联系我

QQ: 2969709268

email: hanasakayui2022@gmail.com

目标是做 BlueArchive 最好用的工具箱

💿 安装

使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

    nb plugin install nonebot-plugin-ba-tools

使用包管理器安装

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

pip

  pip install nonebot-plugin-ba-tools

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入

    plugins = ["nonebot_plugin_ba_tools"]

🎉 使用

💡 数据来源

本项目在 Schale DB 的基础上新增了 l2d 文件夹，请在 release 中下载相应文件并解压至相应目录下 v0.1.6 已实现网络请求资源文件，无需再自行配置资源文件

• 默认路径为项目缓存路径，使用nonebot_plugin_localstore进行管理，你可以使用nb localsotre查看默认缓存路径

• A.R.O.N.A API

• 涩图功能使用自建 pixiv 数据库

🔧 插件配置

Caution

在v0.5.0-beta及以上版本中，插件配置方式发生了变动，如配置了旧版本的配置文件，需要手动迁移配置

配置默认路径为：

• macOS: same as user_data_dir
• Unix: ~/.config/nonebot2/nonebot_plugin_ba_tools/
• WinXP (roaming): C:\Documents and Settings\<username>\Local Settings\Application Data\nonebot2\nonebot_plugin_ba_tools\
• Win 7 (roaming): C:\Users\<username>\AppData\Roaming\nonebot2\nonebot_plugin_ba_tools\

Tip

如果你想自定义配置文件路径，可以向nonebot配置文件中添加BA_TOOLS_CONFIG_PATH项，值为你想要的路径

默认插件配置项如下：

pic:
  loading_switch: true
  max_pic_num: 5
  pixiv_nginx: "https://i.pixiv.re"
  send_pic_info: true
  r18_switch: false

chat:
  enable: false
  current_model: "<model_name>"
  models:
    - name: "<model_name>"
      base_url: "<model_endpoint>"
      api_key: "<your_api_key>"
  reply_mode: text

webui:
  enable: true
  path: "/batools"
  api_access_token: ""
  username: "admin"
  password: "admin"

图片配置 (PicConfig)

配置项	默认值	描述
loading_switch	true	是否开启图片加载通知
max_pic_num	5	单次最大获取的图片数量
pixiv_nginx	"https://i.pixiv.re"	pixiv图床反代
send_pic_info	true	发送涩图时是否发送图片信息
r18_switch	false	是否开启R18

聊天配置 (ChatConfig)

配置项	默认值	描述
enable	false	是否开启LLM Chat
current_model	""	当前模型
models	[]	Chat Model列表
reply_mode	"text"	回复模式(text/image)

WebUI配置 (WebUIConfig)

配置项	默认值	描述
enable	true	是否启用 BA Tools WebUI
path	"batools"	WebUI 路径
api_access_token	""	WebUI 访问令牌
username	"admin"	WebUI 用户名
password	"admin"	WebUI 密码

聊天模型配置 (ChatModel)

配置项	类型	描述
name	string	模型名称
base_url	string	模型接口地址
api_key	string	API密钥

✨ 功能介绍

• 每日 00:00 在以订阅的群聊中自动推送学生生日信息
• 获取当月过生日的学生列表
• 获取学生详细信息
• 获取活动列表
• 获取 ba 千里眼
• 获取攻略(关卡攻略/总力战攻略/大决战攻略/竞技场攻略/火力演习攻略)
• 好感度计算
• 获取/抽取 ba 漫画(目前只能获取到（二创？）漫画，将来可能会支持更多的漫画)
• 获取 ba 表情包
• 自动推送总力战/大决战信息 基于 bilibili 动态（目前只做了日服）
• 获取 ba 涩图（基于自建的数据库）
• 获取 ba meme（基于自建的图库，质量尽可能高了）
• 获取 ba 人权
• 获取 ba 总力战信息
• 使用llm进行角色扮演对话
• WebUI 管理界面

🤖 指令表

Warning

此处示例中的"/"为 nb 默认的命令开始标志，若您设置了另外的标志，则请使用您设置的标志作为开头

指令	权限	需要@	说明	示例
ba学生生日订阅 <操作名>	管理员/群主以及 SUPERUSER	无	在此群订阅/取消订阅学生生日推送	/ba学生生日订阅 开启/关闭
ba总力战订阅 <操作名>	管理员/群主以及 SUPERUSER	无	在此群订阅/取消订阅总力战/大决战推送	/ba总力战订阅 开启/关闭
ba千里眼 <服务器名>	无	无	获取 ba 千里眼信息	/ba千里眼 国服/国际服
ba活动一览	无	无	获取 ba 活动信息	/ba活动一览
ba攻略 <攻略名称>	无	无	获取 ba 攻略	/ba攻略 关卡2-1/国服大决战
ba可用攻略	无	无	查询可用的攻略	/ba可用攻略
ba漫画 <参数(见示例)>	无	无	获取 ba（二创？）漫画	/ba漫画 抽取/第104话
ba学生生日表 <参数(见示例)>	无	无	获取某月的学生生日表	/ba学生生日表 当月/9月
ba涩图 [num] [tags] [isAI] [restrict]	无	无	获取 ba 涩图，使用方法详见下方	/ba涩图 num 2或者/ba涩图
ba涩图上传 <pid>	无	无	上传涩图至数据库，参数为图片的 pid	/ba涩图上传 124081225
bameme [num]	无	无	获取 ba meme，参数为要获取的数目，不填默认 1 张	/bameme 2或者/bameme
ba角色简评	无	无	获取角色简评	/ba角色简评
ba人权	无	无	获取 ba 人权	/ba人权
ba学生信息 <学生姓名> [level]	无	无	获取学生信息	/ba学生信息 晴奈
ba学生技能 <学生姓名>	无	无	获取学生技能信息	/ba学生技能 晴奈
/ba学生列表	无	无	获取可用学生列表	/ba学生列表
ba总力战档线 <服务器名>	无	无	获取总力战档线信息	/ba总力战档线 B服
ba总力战档线变化 <服务器名>	无	无	获取总力战档线变化的图表	/ba总力战档线变化 B服
ba总力战人数变化 <服务器名>	无	无	获取总力战参与人数变化的图表	/ba总力战人数变化 B服
ba总力战分数计算 <服务器名>	无	无	计算相应的分数	/ba总力战分数计算
ba可用boss	无	无	获取可用的 boss 名	/ba可用boss
ba学生生日分布	无	无	获取学生生日分布图	/ba学生生日分布
bachat <subcommand> [args]	无	无	调整llm设置	/bachat -h

• 各指令(不支持所有服的指令)参数可用列表如下

ba攻略：关卡<关卡号>/国际服总力战/日服总力战/国际服大决战/日服大决战/国际服火力演习/日服火力演习/竞技场/三一礼物/互动家具/升星一图流/...
ba总力档线：日服/官服/b服/B服

• ba 涩图的具体使用方法

参数名	参数值类型	是否必须	默认值
num	int	否	1
tags	list[str]	否	-
isAI	bool	否	false
restrict	Literal["safe", "r18"]	否	"safe"

例：

/ba涩图
/ba涩图 num 2 tags [BlueArchive] isAI true restrict safe
/ba涩图 num 2
/ba涩图 tags [小鸟游星野, BlueArchive]
/ba涩图 isAI true restrict r18

👥 参与共建

请加入 QQ 群991680169进行交流

🚩 TODO

• 使用 nonebot-plugin-orm 重构插件数据