Axiu Docs

Appearance

Axiu-Plugin / 阿修插件 ​

源码仓库：https://github.com/AxiuCN/Axiu-Plugin

阿修自用 Yunzai-Bot v3 插件（ESM，GPLv3），集合了米游社扫码登录、自动签到、抽卡记录、终局挑战查询与排行、验证码过码、自动入群审核、代发言等实用功能。

指令说明 ​

以下指令说明供 bot 使用者（群友 / 管理员）参考，标「主人」的指令仅机器主人可用。

扫码登录 ​

首次使用米游社相关功能（签到 / 抽卡 / 挑战查询）前，需要先扫码绑定账号。

指令权限说明
#扫码登录所有人生成米游社二维码，扫码后自动绑定 stoken 并注入 CK 到 cookie 池。一次绑定，之后各功能自动使用你的账号
#刷新ck所有人用已绑定的 stoken 刷新 cookie_token 并重新绑定；#获取ck 仅私聊可用

💡 绑定后无需再手动 #刷新ck——CK 过期（retcode 10001）时插件会自动用 stoken 刷新并重试请求。

米游社签到 ​

支持米游社社区 + 游戏（原神 / 星铁 / 绝区零等）每日自动签到，也可手动触发。

指令权限说明
#注册自动签到所有人用已绑定的 stoken 注册当前 QQ 的签到配置，之后每日自动签到
#签到所有人立即手动执行当前账号的签到（兼容 #开始签到 / #手动签到）
#签到状态所有人查看已绑定账号数及每个配置的签到开关
#刷新自动签到所有人用 stoken 刷新当前用户所有签到配置里的 cookie
#删除签到所有人删除当前账号的全部签到配置（删除后需重新 #注册自动签到）
#删除stoken所有人删除当前账号的全部 stoken 条目（删除后需重新 #扫码登录）
#注册本群签到群主/管理员为群内成员增量注册（已有账号更新、新增创建、残留清理）
#注册所有群签到主人为机器人所在全部群的成员增量注册
#初始化签到环境 / #全部签到 / #签到名单列表主人环境安装与批量维护
  • 默认每日 4:30 刷新 cookie、5:00 自动签到，cron 均可配；完成后向主人与配置的群聊发送汇总
  • 一个 QQ 可绑定多个米游社账号（{qq}_1、{qq}_2 …），同一 stuid 自动去重
  • 社区签到触发验证码时自动过码（最多重试 signin.captchaRetries 次）
  • stoken 失效自动清理：#注册自动签到 时 stoken 失效 → 自动删除该 stoken 条目并提示重新扫码；#刷新自动签到 / 每日定时刷新时失效 → 自动删除对应签到配置 {qq}_n.yaml，避免自动签到持续失败空转（仅登录类错误触发，临时网络错误不误删）
  • 锅巴「米游社签到」模块可关闭手动签到开关，关闭后 #签到 / #全部签到 提示"手动签到已关闭"，自动签到不受影响

抽卡记录 ​

整合米游社官方 API 与提瓦特小助手两种来源，统一存入 genshin 插件的本地抽卡存储。

指令权限说明
#更新抽卡记录所有人米游社官方 API 增量更新（近 12 个月数据）
#更新小助手抽卡记录所有人从提瓦特小助手导入全历史 UIGF 记录（已绑定 stoken 时无需提供链接）
#获取抽卡链接所有人（仅私聊）生成米游社抽卡链接供手动使用
  • 三个命令各有独立 5 分钟冷却
  • authkey 获取失败时提示发送 #扫码登录 重新绑定 stoken
  • 导入成功后可配合其他插件的抽卡统计指令查看记录

终局挑战（原神 / 星铁） ​

查询深渊类玩法数据，群聊中查询成功会自动上报成绩并参与群排行。

原神

指令说明
#深渊 / #深境螺旋深境螺旋查询（最高层 + 星数）
#剧诗 / #幻想真境剧诗幻想真境剧诗查询（勋章、角色统计）
#幽境 / #危战幽境危战查询，可指定 单人 / 多人 / 组队 / 合作
#深渊排名 / #剧诗排名 / #幽境排名 / #危战排行查看群内该玩法排行

星铁（* 前缀，# 亦可）

指令说明
*末日 / *虚构 / *忘却 / *仲裁各终局挑战数据
*深渊末日 + 虚构 + 忘却三种深渊一并查询
*最新深渊当前最新一期
*末日排名 / *忘却排名 / *虚构排名 / *仲裁排名查看群内该玩法排行
  • 支持 上期 / 本期（默认本期）、简易（跳过详细 API）修饰符；星铁仲裁额外支持 往期（显示三期历史）
  • 排行按赛季自动分段，综合多维度排序，数据 90 天自动过期
  • 重置 / 开关排行等管理指令为 master 级（如 #重置深渊排名、#开启深渊排行、*开启挑战排名）

代发言 ​

指令权限说明
#代@某人 消息内容主人以目标用户身份重新注入消息到插件流程（仅群聊）

自动功能 ​

  • 自动入群审核：加群申请按群配置黑白名单自动审批，未匹配 @ 管理员人工审核
  • 米游社过码：米游社 API 返回 Geetest 验证码（1034/10035）时自动过码（test_nine / ttocr.com / 2captcha.com + 手动打码回退）

配置 ​

锅巴后台「阿修插件」可视化配置签到、过码、入群审核等；也可手动编辑 config/config.yaml（签到 / 过码 / 挑战开关）、config/group_config.yaml（入群审核）、config/MihoyoBBSTools_config.yaml（签到模板）。

指令列表 ​

[Axiu-Plugin] 代发言 ​

  • 描述：代替指定用户发言，让其他插件处理消息
  • 事件：message
正则表达式处理函数
/^#代/proxySpeak

[Axiu-Plugin] 米游社验证码处理 ​

  • 描述：无
  • 事件：message
  • 优先级：1

[Axiu-Plugin] 终局挑战 ​

  • 描述：星铁终局挑战查询 + 星铁/原神终局挑战排行
  • 事件：message
  • 优先级：1
正则表达式处理函数
^(#?星铁|\[\*＊\])?(上期|本期)?(简易)?(末日|末日幻影)$challengeBoss
^(#?星铁|\[\*＊\])?(上期|本期)?(简易)?(虚构|虚构叙事)$challengeStory
^(#?星铁|\[\*＊\])?(上期|本期)?(简易)?(忘却|忘却之庭|混沌|混沌回忆)$challengeForgottenHall
^(#?星铁|\[\*＊\])?(往期|上期|本期)?(简易)?(异乡|异相|异向|仲裁|异相仲裁)$challengePeak
^(#?星铁|\[\*＊\])?(上期|本期)?(简易)?(深渊)$challenge
^(#?星铁|\[\*＊\])?(最新|当期)(简易)?(深渊)$challengeCurrent
^(#?星铁|\[\*＊\])?(末日幻影|末日|虚构叙事|虚构|叙事|忘却之庭|忘却|混沌回忆|混沌|异相仲裁|异相|仲裁|异乡)(排名|排行)challengeRank
^(#?星铁|\[\*＊\])?重置(末日幻影|末日|虚构叙事|虚构|叙事|忘却之庭|忘却|混沌回忆|混沌|异相仲裁|异相|仲裁|异乡)(排名|排行)challengeRankReset
^(#?星铁|\[\*＊\])?(开启|关闭)(挑战)(排名|排行)challengeRankManage
^#(原神)?(上期|本期)?(深境|深渊|深境螺旋)$gsSpiralAbyssQuery
^#(原神)?(上期|本期)?(幻想|剧诗|幻想真境剧诗)$gsRoleCombatQuery
^#(原神)?(上期|本期)?(幽境|危战|幽境危战)(单人|单挑|组队|多人|合作|最佳|数据)?$gsHardChallengeQuery
^#(原神)?(深境螺旋|深境|深渊|幻想真境剧诗|幻想|剧诗|幽境危战|幽境|危战)(单人|单挑|多人|组队|合作)?(排名|排行)gsAbyssRank
^#(原神)?重置(深境螺旋|深境|深渊|幻想真境剧诗|幻想|剧诗|幽境危战|幽境|危战)(单人|单挑|多人|组队|合作)?(排名|排行)gsAbyssRankReset
^#(原神)?(开启|关闭)(深渊)(排名|排行)gsAbyssRankManage

[Axiu-Plugin] 自动入群审核 ​

  • 描述：根据黑白名单自动处理加群申请，否则@其他管理员
  • 事件：request.group.add
  • 优先级：10

[Axiu-Plugin] 抽卡记录管理 ​

  • 描述：更新抽卡记录、提瓦特小助手全历史导入、获取抽卡链接
  • 事件：message
  • 优先级：500
正则表达式处理函数
^#更新抽卡记录$gachaLog
^#?(获取|更新)(提瓦特)?小助手(抽卡|祈愿)?(记录|历史)( \*|(\\r|\\n)\*)(https.\*)?gachaLogAssistant
^#获取抽卡链接$getGachaUrl

[Axiu-Plugin] 帮助 ​

  • 描述：查看 Axiu-Plugin 帮助
  • 事件：message
  • 优先级：500
正则表达式处理函数
/^#(axiu|Axiu|阿修)(帮助|菜单|指令|命令|help)$/ihelp

[Axiu-Plugin] 扫码登录 ​

  • 描述：QR扫码登录、刷新CK
  • 事件：message
  • 优先级：500
正则表达式处理函数
^#扫码(登录|登陆|绑定)$qrCodeLogin
^#(刷新|更新|获取)(ck|cookie)$updCookie

[Axiu-Plugin] 米游社签到 ​

  • 描述：米游社自动签到（社区+游戏+云游戏）
  • 事件：message
  • 优先级：500
正则表达式处理函数
^#初始化签到环境$initEnv
^#注册自动签到$register
^#注册本群签到$groupRegister
^#注册所有群签到$registerAllCmd
^#签到名单列表$listProfiles
^#(开始|手动|测试)?签到$startSignin
^#全部签到$signinAll
^#刷新自动签到$refreshCookieCmd
^#签到状态$signinStatus
^#删除签到$deleteSigninCmd
^#删除stoken$deleteStokenCmd

鸣谢 ​

  • 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 调用参考自此项目

← 返回插件列表

© 2026 阿修Axiu · Axiu Network · 闽ICP备2026017611号-1