Skip to content

About

Axiu-Plugin for TRSS-yunzai

Resources

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

Axiu-Plugin / 阿修插件

阿修自用 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-Plugin

Gitee

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-Plugin

Gitcode

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(可选,自动过码用)

如已有过码平台可跳过。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 — 星铁抽卡记录同步思路参考自荷花重制版

About

Axiu-Plugin for TRSS-yunzai

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages