Skip to content

cssxsh/mirai-selenium-plugin

Repository files navigation

Mirai Selenium 前置插件

Mirai-Console 的前置插件,用于使用 Selenium 调用浏览器进行截图等

maven-central Setup and Build Codacy Badge

运行平台支持

OS Browser Driver Setup
Windows Chrome Yes Yes
Windows Firefox Yes No
Windows Edge Yes ~
Linux Chrome Yes Yes
Linux Firefox Yes Yes
MacOS Chrome Yes Yes
MacOS Firefox Yes Yes

Linux 下以 headless 模式运行时, 请安装 Xvfb 或其他虚拟窗口服务 #8
可以通过 xvfb-run -h 测试是否已经安装

在插件项目中引用

repositories {
    mavenCentral()
}

dependencies {
    compileOnly("xyz.cssxsh.mirai:mirai-selenium-plugin:${version}")
}

mirai {
    jvmTarget = JavaVersion.VERSION_11
}

示例代码

使用本前置插件的项目

管理指令

  • /selenium setup 安装驱动文件
  • /selenium clear 清理驱动文件
  • /selenium destroy 清理驱动进程
  • /selenium status 驱动进程状态
  • /selenium firefox 下载解压 firefox
  • /selenium chromium 下载解压 chromium
  • /selenium chrome 下载解压 chrome
  • /selenium chart 测试 图表绘制功能,将以群员入群事件和发言时间为数据集

配置

  • expires 驱动文件过期时间,默认一星期 (单位:天)
  • user_agent 浏览器 UA
  • width 浏览器宽度
  • height 浏览器高度
  • pixel_ratio 浏览器像素比
  • headless 无头模式(后台模式)
  • proxy 代理地址
  • log 启用日志文件
  • browser 指定使用的浏览器: Chrome,Chromium,Firefox,Edge
  • factory 指定使用的Factory: netty (ktor 不再可用)
  • arguments 自定义 arguments, 可以尝试加入 --no-sandbox, --disable-dev-shm-usage, 解决兼容性问题
  • preferences 自定义 preferences,浏览器配置
  • chrome Chrome/Chromium 二进制文件路径
  • edge Edge 二进制文件路径
  • firefox Firefox 二进制文件路径

本插件提供了 一个类似 mirai-login-solver-selenium 的 登陆处理器
需要在 mirai 运行时中添加 JVM 属性 mirai.slider.captcha.supported (添加参数 -Dmirai.slider.captcha.supported) 启用

v2.2.2 提供了方便调用 ECharts 进行表格绘制的工具类, 使用方法详见示例代码
/selenium chart 测试结果示例
chart

安装

MCL 指令安装

请确认 mcl.jar 的版本是 2.1.0+
./mcl --update-package xyz.cssxsh.mirai:mirai-selenium-plugin --channel maven-stable --type plugin

手动安装

  1. Releases 或者 Maven 下载 mirai2.jar
  2. 将其放入 plugins 文件夹中

afdian