阿修自用 Yunzai-Bot v3 插件,提供扫码登录、米游社签到、米游社过码、抽卡记录、终局挑战、自动入群审核、代发言等功能。
MCSM 面板管理已迁移至独立插件 MCSM-Plugin。
在 Yunzai 根目录执行:
Github
git clone --depth=1 https://github.com/AxiuCN/Axiu-Plugin.git ./plugins/Axiu-Plugin/
git -C ./plugins/Axiu-Plugin submodule update --init -- tool/MihoyoBBSTools
pnpm install --filter=Axiu-PluginGitee
git clone --depth=1 https://gitee.com/AxiuCN/Axiu-Plugin.git ./plugins/Axiu-Plugin/
git -C ./plugins/Axiu-Plugin submodule update --init -- tool/MihoyoBBSTools
pnpm install --filter=Axiu-PluginGitcode
git clone --depth=1 https://gitcode.com/AxiuCN/Axiu-Plugin.git ./plugins/Axiu-Plugin/
git -C ./plugins/Axiu-Plugin submodule update --init -- tool/MihoyoBBSTools
pnpm install --filter=Axiu-Plugin通过米游社扫码绑定 stoken,支持刷新 cookie。移植自 xiaoyao-cvs-plugin。
#扫码登录— 生成 QR 码,米游社扫码后自动绑定 stoken 并查找游戏角色,同时自动绑定 CK 到 cookie 池(无需手动#刷新ck)#刷新ck— 遍历已绑定的 stoken,刷新 cookie_token 并绑定到 cookie 系统- 可在锅巴后台开关
基于 MihoyoBBSTools(Python,git 子模块)的社区+游戏签到。
环境初始化(首次使用):
#初始化签到环境自动检查 Python、安装依赖、拉取子模块。依赖安装失败时自动处理常见问题,仍失败则透出真实错误便于排查:
- 未检测到 pip → 自动执行
ensurepip --upgrade后重试 - 系统 Python 受 PEP 668 保护(Debian 12+ / Ubuntu 23.04+)→ 自动加
--break-system-packages重试 - 连接 PyPI 失败 → 自动切换清华镜像重试
- 全部重试仍失败 → 返回错误输出尾部(stderr 不再被吞),并提示手动处理
命令:
| 命令 | 说明 |
|---|---|
#初始化签到环境 |
检查 Python、自动安装依赖、拉取 MihoyoBBSTools 子模块(仅 master) |
#注册自动签到 |
用已绑定的 stoken 注册签到,生成个人签到配置(增量:已有账号更新、新增创建、残留清理) |
#注册本群签到 |
为群内成员增量注册(仅群主/管理员) |
#注册所有群签到 |
为机器人所在全部群的成员增量注册(仅 master) |
#签到 |
手动执行当前用户的签到(兼容旧命令 #开始签到 / #手动签到) |
#全部签到 |
执行全部已注册用户的签到(仅 master) |
#签到状态 |
查看已绑定账号数及每个签到配置的开关状态 |
#刷新自动签到 |
用 stoken 刷新所有个人签到配置的 cookie |
#删除签到 |
删除当前账号的全部签到配置(需重新 #注册自动签到) |
#删除stoken |
删除当前账号的全部 stoken 条目(需重新 #扫码登录) |
#签到名单列表 |
列出所有已注册签到用户(仅 master) |
- 每天 4:30 全体刷新 cookie,5:00 自动签到(cron 均可配),完成后向 master 和配置群聊发送汇总
- 签到详细日志写入
log/signin-{date}.log,保留 7 天自动清理 - 支持一个 QQ 绑定多个米游社账号(
{qq}_1.yaml、{qq}_2.yaml…),同一 stuid 自动去重 - 注册为增量语义:重复注册时已有账号原地更新 cookie,新增账号才新建配置;stoken 中已删除的账号对应配置自动清理
- 社区签到触发验证码时自动过码(最多重试 3 次,复用现有过码平台)
- stoken 失效自动清理:
#注册自动签到时 stoken 失效 → 自动删除该 stoken 条目并提示重新扫码;#刷新自动签到/ 每日定时刷新时失效 → 自动删除对应签到配置{qq}_n.yaml,避免自动签到持续失败空转(仅登录类错误触发,临时网络错误不误删) - 个人签到配置存储在
tool/MihoyoBBSTools/MihoyoBBSTools/config/{qq}_n.yaml - 可在锅巴后台配置签到时间、游戏开关、BBS 任务开关、报告群聊等
手动配置:
- 签到主配置(schedule、refreshSchedule、pythonCommand、reportGroups 等):
config/config.yaml→signin:段 - 签到模板(游戏、BBS 任务开关):
config/MihoyoBBSTools_config.yaml
自动处理米游社 API 返回的 Geetest 验证码(retcode 1034/10035),支持三种过码平台 + 手动打码回退。
- 平台:test_nine / ttocr.com / 2captcha.com
- 手动打码:内置 GT-Manual Express 服务,通过浏览器完成验证
- 配置:编辑
config/config.yaml的api:段
整合 Mihoyo 官方 API 和提瓦特小助手两种抽卡记录获取方式,统一保存到 genshin 插件的本地 GachaLog 存储。小助手功能移植自天如插件(TianRu-plugin)。
| 命令 | 说明 |
|---|---|
#更新抽卡记录 |
通过 Mihoyo 官方 API 增量更新原神抽卡记录(可获取近 12 个月数据) |
#更新小助手抽卡记录 [链接] |
从提瓦特小助手(lelaer.com)导入全历史 UIGF 记录 |
#获取抽卡链接 |
生成米游社抽卡链接供手动使用(仅私聊) |
*更新星铁抽卡记录 |
走官方抽卡小程序接口同步(badge login + rpg_gacha_record):cookie 换 e_hkrpg_token → 拉 6 个池的五星列表 / 垫抽 / 池统计,镜像进 genshin 的 srJson(星铁没有可用的外部 authkey,不走全量拉取) |
*获取星铁抽卡链接 |
提示星铁不支持外部抽卡链接,改用 *更新星铁抽卡记录 或手动粘贴游戏内链接导入 |
- 各命令有独立的 5 分钟 CD
- 已绑定 stoken 的用户无需提供链接,自动获取 authkey(仅原神:
#更新抽卡记录/#获取抽卡链接;星铁走上面的 badge login) - 星铁的账号 cookie 必须与目标 UID 配套:先按 UID 查 stoken(精确 UID 或同一米游社账号的条目),再按该 UID 归属的账号取 CK;都没有时提示「未获取到星铁 UID xxx 的账号 cookie」,此时用
#扫码登录绑定该账号(不会退而使用原神账号的凭据) - 可在命令末尾附带目标星铁 UID 指定账号,如
*更新星铁抽卡记录 200000002;不写则使用当前账号的星铁 UID - 星铁查询/统计/渲染复用 genshin gcLog 体系(
*角色记录/*光锥记录/*全部记录/*星铁统计/*导出记录) - 小助手数据与 Mihoyo 官方数据共用同一本地存储,自动去重
原神终局挑战 — 完整自实现深境螺旋、幻想真境剧诗、幽境危战查询。一次 API 调用完成数据采集 + HTML 渲染 + 排行上报,不与 miao-plugin 重复调 API。查询模板移植自 miao-plugin(去掉角色武器圣遗物展示)。
| 命令 | 权限 | 说明 |
|---|---|---|
#深渊 / #深境螺旋 |
all | 深境螺旋查询(楼层星数、各间用时) |
#剧诗 / #幻想真境剧诗 |
all | 幻想真境剧诗查询(勋章、辉彩祝福、神秘收获) |
#幽境 / #幽境危战 |
all | 幽境危战查询(难度、用时、怪物信息) |
#幽境单人 / #幽境多人 |
all | 指定单人/多人模式 |
#深渊排名 / #深境排行 |
all | 排行:层数→星数→战斗次数 |
#剧诗排名 / #幻想排行 |
all | 排行:模式→幕数→星章→用时→借出 |
#幽境排名 / #危战排行 |
all | 排行:难度→用时,徽章仅展示不参与排序 |
#深渊排名 星数 |
all | 指定维度排行(层数/星数/战斗次数/模式/星章/用时/借出/难度) |
#重置深渊排名 |
master | 重置本群该类型排行数据 |
#开启深渊排行 / #关闭深渊排行 |
master | 开关本群排行功能 |
- 支持
上期/本期(默认本期)修饰符 - 查询命令在群聊中自动上报数据到 Redis ZSET 排行,90 天自动过期
- 排行多维度加权复合排序,幽境危战徽章(含虹彩徽章)在排行页展示但不参与排序
#原神前缀可选;查询使用#喵喵深渊等前缀时仍由 miao-plugin 处理
星铁终局挑战 — 查询星穹铁道终局挑战数据(末日幻影、虚构叙事、忘却之庭、异相仲裁),移植自 StarRail-plugin。
| 命令 | 说明 |
|---|---|
*末日 / *末日幻影 |
末日幻影数据 |
*虚构 / *虚构叙事 |
虚构叙事数据 |
*忘却 / *混沌回忆 |
忘却之庭数据 |
*仲裁 / *异相仲裁 |
异相仲裁数据 |
*深渊 |
全部三种深渊(末日+虚构+忘却) |
*最新深渊 / *当期深渊 |
当前最新一期 |
- 支持
上期/本期(默认:本期)、简易(跳过详细API)修饰符 - 仲裁额外支持
往期(显示三期历史) *星铁前缀可选- 查询遇到验证码时自动调用本插件过码平台
- 星铁 API 返回 10001(CK 过期)时自动用已绑定的 stoken 刷新 cookie 并重试(本插件自实现;原神侧同理由 genshin 插件处理)
终局挑战排行 — 在群聊中查询挑战数据时自动上报成绩,支持群内排名。
| 命令 | 权限 | 说明 |
|---|---|---|
#深渊排名 / #深境排行 |
all | 按 层数→星数 排名(战斗次数只展示),同层同星并列、先查到的在前;每行显示层数、星数、战斗次数 |
#剧诗排名 / #幻想排行 |
all | 按 模式→幕数→星章→用时 排名(借出只展示),全同则并列;每行显示模式、幕数、星章、用时、借出 |
#幽境排名 / #危战排行 |
all | 按 难度→用时 排名,全同则并列;每行显示难度、用时、徽章 |
*忘却排名 / *混沌排行 |
all | 按 层数→星数→轮数 排名(战斗只展示),全同则并列;每行显示层数、星数、轮数 |
*末日排名 / *末日幻影排名 |
all | 按 难度→总分 排名,全同则并列;每行显示难度、分数、星数、轮数 |
*虚构排名 / *虚构叙事排名 |
all | 按 层数→星数→分数→轮数 排名,全同则并列;每行显示层数、星数、分数、轮数 |
*仲裁排名 / *异相仲裁排名 |
all | 按 绝境→王棋→骑士→轮数 排名,全同则并列;每行显示模式、王棋、骑士、轮数 |
*末日排名 王棋星数 |
all | 指定维度排行(支持全称:总星数/总分/使用轮数/战斗次数/最深抵达/王棋星数/骑士星数/绝境模式) |
#重置深渊排名 / #重置剧诗排名 / #重置幽境排名 |
master | 重置本群该类型排行数据 |
*重置忘却排名 |
master | 重置本群该类型排行数据 |
#开启深渊排行 / #关闭深渊排行 |
master | 开关本群原神排行功能 |
*开启挑战排名 / *关闭挑战排名 |
master | 开关本群星铁排行功能 |
- 仅群聊可用,基于米游社 API 赛季 ID 自动分段,新旧数据互不干扰
- 名次按各玩法的名次键排序(轮数/用时这类「越小越好」的维度自动取反),战斗次数/借出只展示、不参与名次;名次键相同的玩家并列同名次(密集式 1,1,2),并列组内按首查时间(该期第一次查到成绩的时刻)先后,首查不在榜上显示
- 排行页显示赛季名称(从 Atlas-Plugin 图鉴获取)、期数、赛季时间
- 数据 90 天自动过期,避免 Redis 堆积
gsAbyssRank.enabled/srChallengeRank.enabled关闭后不再上报(不再静默采数):即使查询正常、群排行开关仍开,也不写 ZSET 与 UID 元信息;重新打开后在群里查询一次即可恢复采集
把 miao-plugin 的群排行(圣遗物/遗器评分)摊平成一张榜:不指定角色,一行 = (uid, 角色, 分数),同角色多 uid、同 uid 多角色都会各占一行,按分数降序取前 N(N 取 miao 的「排行人数」)。卡片沿用 miao 的排行卡样式(行首 QQ 头像、命座+角色名+UID、天赋格、武器、圣遗物套装+评分徽章、右侧期望伤害),说明块文字改成总榜口径。
| 命令 | 说明 |
|---|---|
#圣遗物总榜 / #遗器总榜 |
本群总榜 |
*遗器总榜 |
星铁本群总榜 |
#全局圣遗物总榜 / #全局遗器总榜 |
全局总榜(跨群,同一 uid 的同一角色只占一行、保留最高分) |
*全局遗器总榜 |
星铁全局总榜 |
- 数据来源:miao-plugin 的群排行 ZSET(只读评分榜
mark,伤害榜没有统一标准不参与;卡片右侧的期望伤害只展示、不参与排序);本插件不写 miao 的键 - 本群总榜仅群聊,全局总榜私聊也能用;本群已关闭群排名时(
#关闭排名)直接提示不出图,全局榜不受影响 - 数据依赖群内用
#面板/*面板查看过角色面板;miao-plugin 未安装时提示「该功能需要 miao-plugin」 - 可在锅巴后台开启「排行榜定时刷新」(默认关闭),定时重排本插件挑战排行并只刷有数据的群的 miao 排行,完成后私聊主人汇总
收到加群申请时,根据群配置的黑白名单答案自动审批,未匹配则 @通知管理员人工审核。
#代@某人 消息内容 或 #代QQ号 消息内容(仅 master,仅群聊),以目标用户身份重新注入消息到插件匹配流程。
在锅巴后台 → 阿修插件,可视化配置签到、过码、入群审核等。
- 保存时按模板渲染回
config/config.yaml,注释完整保留;写入前会先自检一遍,值写不成合法 YAML 时拒绝保存并说明原因(不会把配置写坏) - 入群审核的群规则两种写法都认(锅巴子表 / 手写的
群号: {...}映射),保存时按原样保留你用的那种;整份规则里没有有效群号时会拒绝保存,而不是把规则清空 config/config.yaml语法坏掉时,面板照常打开(显示的是参考默认值);此时保存会按参考默认值重写其余键,回执里会点明
- 签到配置:编辑
config/config.yaml→signin:段 +config/MihoyoBBSTools_config.yaml - 入群审核:复制
config/group_config.yaml.example→config/group_config.yaml - 过码配置:编辑
config/config.yaml→api:段
如已有过码平台可跳过。test_nine 为本地 AI 过码服务,以子模块提供。
# 1. 拉取子模块
git submodule update --init -- tool/test_nine
# 2. 下载模型文件至 tool/test_nine/test_nine/model/
# https://huggingface.co/luguoyixiazi/model_save/resolve/main/PP-HGNetV2-B4.onnx
# https://huggingface.co/luguoyixiazi/model_save/resolve/main/d-fine-n.onnx
# https://huggingface.co/luguoyixiazi/model_save/resolve/main/yolo11n.onnx
# https://huggingface.co/luguoyixiazi/model_save/resolve/main/dinov3-small.onnx
# https://huggingface.co/luguoyixiazi/model_save/resolve/main/atten.onnx
# 3. 安装依赖
pip install -r tool/test_nine/test_nine/requirements_without_train.txt
# 4. 启动(默认端口 9645)
uvicorn main:app --host 0.0.0.0 --port 9645启动后在 config/config.yaml 的 api: 段设置 type: 0,api 填 http://127.0.0.1:9645/pass_uni。
模型下载地址、训练方法及更多参数详见
tool/test_nine/test_nine/README.md。
- loveMys-plugin — 过码事件处理及配置体系借鉴自此项目
- GT-Manual — 内置手动打码服务引用于此
- test_nine — 九宫格+点选 AI 过码,以子模块引入
- ClassificationCaptchaOcr — resnet 模型及 V4 数据集参考
- xiaoyao-cvs-plugin — 扫码登录、stoken 管理体系移植自此项目
- Lotus-Plugin — 签到架构、过码桥接、计划式调度思路借鉴自此项目
- MihoyoBBSTools — Python 签到引擎,米游社签到及游戏签到核心,以子模块引入
- TianRu-plugin — 提瓦特小助手抽卡记录功能移植自此项目
- StarRail-plugin — 星铁终局挑战功能移植自此项目
- miao-plugin — 原神终局挑战查询模板及 API 调用参考自此项目
- FurinaWai77 — 代码审查与修复建议(审查基准 e9c4dae + 7fa4b3d - 88affaf)
- Lotus-ReFactor — 星铁抽卡记录同步思路参考自荷花重制版