nonebot-plugin-arkrecord 1.7.0

Nonebot plugin for fetching and analyzing gacha records of arknights

nonebot_plugin_arkrecord

欢迎使用明日方舟抽卡分析NoneBot2插件!

本插件为基于python3.9开发的NoneBot2插件，NoneBot2适配器为OneBotV11，当前版本V1.6.2.2

若对插件安装、使用有疑问，或在使用中遇到BUG，欢迎在issue区发问；或直接联系作者：QQ 812325695。我将尽可能地排查并解决问题

丨特别说明

如遇报错“token保存”失败，请检查你的数据库是否为空（大小为0kb）。目前已经出现多例由于数据库由于变空，导致的“token保存失败”错误。

已经查明，数据库变空是在数据库被从./resource/复制到数据库存放位置的过程中发生的。可能是shutil.copy()的问题，具体触发原因及触发条件未知。

如果你遭遇此问题，请尝试以下两种解决方法

• 删除数据库文件存放路径中的arkgacha_record16.db，然后重启启动nonebot机器人
• 如果依然无法运行，请下载本github仓库中的./nonebot_plugin_arkrecord/resource/arkgacha_record16.db，数据库存放路径下的数据库进行替换

数据库文件存放位置：

C://USERS/{USER_NAME}/.arkrecord (Windows)

或

/root/.arkrecord (Linux)

v1.6.3版本 已经将复制命令由shutil.copy()更换为系统命令，但仍无法完全保证此现象未来不会重现。如出现无法解决的问题请联系开发者处理解决。

丨插件部署方法

1、安装nonebot2

如果你还没有安装NoneBot2，可以参考NoneBot2官网配置NoneBot2后再安装本插件

2、配置sqlite

本插件依赖于sqlite数据库。 如果在Linux环境下部署机器人，一般无需配置sqlite环境。

如果在Windows环境下部署机器人，请参考网络资源（如菜鸟教程）安装SQLite数据库，但无需控制数据库用户、创建数据库表等操作。

3、安装插件

在命令行（cmd）中

pip install nonebot_plugin_arkrecord

4、配置数据库储存路径

运行本插件前，需要在机器人的 .env.prod 文件中配置数据库储存路径，如 arkrecord_db_path = "/root/.arkrecord"

如果你是1.7版本之前就在使用本插件的老用户，可以直接该路径为arkrecord_db_path = "/root/.arkrecord"以保证与此前版本保持一致

5、载入插件

载入插件方式与载入其他插件方式相同，即在NoneBot2的bot.py中添加一行

nonebot.load_plugin('nonebot_plugin_arkrecord')

丨插件使用方法

步骤1：token设置

每个用户第一次使用时，需要设置token。

1.1 token获取方法：在官网登录后，根据你的服务器，选择复制以下网址中的内容

官服：https://web-api.hypergryph.com/account/info/hg

B服：https://web-api.hypergryph.com/account/info/ak-b

1.2 token设置方法：使用插件命令方舟抽卡token 页面内容(自动识别B服、官服token) 或方舟寻访token 页面内容进行设置

如网页中内容为

{"status":0,"msg":"OK","data":{"token":"example123456789"}}

则使用命令 方舟抽卡token {"status":0,"msg":"OK","data":{"token":"example123456789"}}， 如果间隔超3天再次使用，建议重新使用上述方式设置token

步骤2：寻访记录分析

设置token后，直接使用方舟抽卡分析或方舟寻访分析即可

还可以使用方舟抽卡分析 数字，分析最近一定抽数的寻访情况

如方舟抽卡分析 100分析最近100抽的情况

插件维护：更新卡池信息与干员头像

全局更新

使用方舟卡池更新命令，自动从PRTS更新卡池信息及干员头像文件

手动添加卡池

在卡池开放后，往往需要在数个小时才能从PRTS上获取正确的卡池名称与内容。此时若希望使用本插件，可以使用手动添加卡池功能，命令格式为

手动添加卡池|卡池名称|限定类型（限定 非限定）|添加者QQ号

如

手动添加卡池|万象伶仃|限定|4008208820

导出记录

使用方舟抽卡导出命令，可以在群聊中导出你当前关联token的储存于插件数据库中的寻访记录。请注意，目前只支持在群聊中导出

获取帮助

使用方舟寻访帮助或方舟抽卡帮助命令，可以获取插件帮助

其他功能

使用随机干员命令，随机给出一张干员头像

丨更新日志

• v1.6.0 - v1.6.3 更新内容已隐去，详情请查看既往版本的md文件
• v1.6.4 修复了由于sqlite版本差异导致的抽卡记录可能无法保存的问题，感谢@
• v1.6.4 调整了命令优先级，出现命令无法响应的概率降低了
• v1.7.0 调整了关键参数配置方式
• v1.7.0 调整了token输入方式，现在可以输入整个token网页内容以设置token
• v1.7.0 新增了日志系统，现在可以在arkrecord_db_path文件夹下获取运行报错日志
• v1.7.0 新增了手动卡池更新命令，再也不用为更新后无法及时获取寻访分析发愁了！（也许）
• v1.7.0 优化了数据库读写的逻辑

| 更新计划

• 敬请期待win-exe版方舟抽卡分析小工具

| 参考

作图代码参考于

• nonebot-plugin-gachalogs

• nonebot_plugin_gamedraw

| 开发人员信息

主体开发本人

美术资源及需求设计 @Alnas1