基于 Mirai Console 的 Pixiv 插件
基于 Kotlin Pixiv库 PixivClient ，通过清除ServerHostName 绕过SNI审查，免代理
使用前应该查阅的相关文档或项目
Pixiv Helper 2 重构进行中，部分功能还不可用. 需要重新登录Pixiv 账号，你可以使用之前登录得到的 Token
目前没有自动缓存清理，请使用 #删除指令 手动清理
R18图会按照Pixiv所给信息过滤
群聊模式使用默认账号，私聊模式Pixiv账号和QQ号关联，初次使用请先 /pixiv 指令登陆账号
然后使用 /cache recommended 缓存系统推荐作品，然后再使用色图相关指令
推荐使用 /task cache recommended 定时自动缓存
Gif图片需要由机器人自己合成，如果设备性能不足，请调整相关参数
自 1.9.0 起将数据库部分功能拆分
需要 Mirai Hibernate Plugin 做前置插件
这是必要的
MCL安装指令 ./mcl --update-package xyz.cssxsh.mirai:mirai-hibernate-plugin --channel maven-stable --type plugins
打开浏览器，登录PIXIV 需要 Mirai Selenium Plugin 做前置插件 并且需要代理配置（可以打开浏览器后，在浏览器中配置），浏览器登录只是其中一种登录方法，不必要安装 Selenium 插件
群聊默认输出最少作品信息，需要增加请使用 /setting 指令修改
发送模式可以使用 /setting 指令修改为闪照或撤销或转发
注意, 闪照等模式 并不会降低 机器人被封禁 的风险。
机器人被封禁的主要风险来自
- QQ号是新注册的
- Bot挂在服务器上，但是服务器IP被腾讯列为风险IP(腾讯通过IP确定 登录地区)
- Bot被高频使用，(另外，
高频发图再高频撤销属于不打自招，正常用户有这个手速吗？) - 发送大量违规链接，或者触发关键词
注意: 使用前请确保可以 在聊天环境执行指令
带括号的/前缀是可选的
<...>中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如/色图
[...]表示参数，当[...]后面带?时表示参数可选
{...}表示连续的多个参数
本插件指令权限ID 格式为 xyz.cssxsh.mirai.plugin.pixiv-helper:command.*, * 是指令的第一指令名
例如 /pixiv sina 的权限ID为 xyz.cssxsh.mirai.plugin.pixiv-helper:command.pixiv
| 指令 | 描述 |
|---|---|
/<pixiv> <sina> |
扫码登录关联了PIXIV的微博账号，以登录PIXIV |
/<pixiv> <cookie> |
通过Cookie，登录PIXIV |
/<pixiv> <selenium> |
打开浏览器，登录PIXIV |
/<pixiv> <refresh> [token] |
登录 通过 refresh token |
/<pixiv> <bind> [uid] [contact]? |
绑定 Pixiv 账户 |
/<pixiv> <pool> |
账户池详情 |
/<follow> <user> {uid} |
为当前助手关注指定用户 |
/<follow> <copy> [uid] |
关注指定用户的关注 |
/<mark bookmark> <add> [uid] {words}? |
添加指定作品收藏 |
/<mark bookmark> <delete> [pid] |
删除指定作品收藏 |
/<mark bookmark> <random> [tag]? |
随机发送一个收藏的作品 |
/<mark bookmark> <list> |
显示收藏列表 |
Pixiv helper 2 重构中，follow 和 mark 暂不可用
Pixiv helper 2 中 新加入 /pixiv bind 指令，此指令用于为一个联系人（群/用户）绑定一个 pixiv 账号（已登录）
cookie 文件为工作目录下的 cookie.json
内容 为 浏览器插件 EditThisCookie 导出的Json
EditThisCookie 安装地址
Chrome
Firefox
Edge
| 指令 | 描述 |
|---|---|
(/)<ero 色图 涩图> |
缓存中随机一张色图 |
(/)<get 搞快点 gkd> [pid] [flush]? |
获取指定ID图片 |
(/)<tag 标签> [word] [bookmark]? [fuzzy]? |
随机指定TAG图片 |
(/)<boom 射爆 社保> [limit]? [word]? |
随机一组色号图，默认30张 |
(/)<illustrator 画师> <uid id user 用户> [uid] |
根据画师UID随机发送画师作品 |
(/)<illustrator 画师> <name 名称 名字 推特> [name] |
根据画师name或者alias随机发送画师作品 |
(/)<illustrator 画师> <alias 别名> [name] [uid] |
设置画师alias |
(/)<illustrator 画师> <list 列表> |
显示别名列表 |
(/)<illustrator 画师> <info 信息> [uid] |
获取画师信息 |
(/)<illustrator 画师> <search 搜索> [name] [limit]? |
搜索画师 |
(/)<search 搜索 搜图> [image]? |
saucenao、ascii2d 搜索图片 |
Pixiv helper 2 重构中，illustrator 暂不可用
色图指令基于缓存信息，使用前请先缓存一定量的作品，推荐使用 /cache recommended 指令
使用色图指令时 指令后附带 更好, 可以使收藏数比前一张更高, 如果两次色图指令间隔小于触发时间(默认时间10s)也会触发这个效果
tag指令检索结果过少时，会自动触发缓存
tag指令可以尝试按照格式 角色名(作品名) 检索角色, 举例 红(明日方舟)
tag指令多keyword时，请使用 _，|，,, + 等符号将keyword连接起来，不要使用空格，举例 明日方舟+巨乳
[image]? 为空时会从回复消息，最近图片获取
bookmark 参数指收藏数过滤
fuzzy 参数指模糊搜索
boom指令使用时
无 word 会随机给出色图
word 为数字时会查找对应uid画师的色图
其余情况则按 tag 处理
画师别名的uid为0时表示删除指定别名
搜图使用 https://saucenao.com 的 api，无KEY时，每天限额 100次， KEY参数在设置中添加
举例:
1.9.1 开始，添加 通过At来搜索头像的功能
当 saucenao 的 搜索结果不足时，会自动补充 ascii2d 的搜索结果
| 指令 | 描述 |
|---|---|
/<cache> <follow> |
缓存关注推送 |
/<cache> <rank> [mode] [date]? |
缓存指定排行榜信息 |
/<cache> <recommended> |
缓存推荐作品 |
/<cache> <bookmarks> [uid] |
缓存用户的收藏中缓存色图作品 |
/<cache> <following> [fluhsh]? |
缓存关注画师作品 |
/<cache> <fwm> [jump]? |
缓存关注画师收藏 |
/<cache> <user> [uid] |
缓存指定画师作品 |
/<cache> <tag> [word] |
缓存搜索tag得到的作品 |
/<cache> <ero> [range]? |
缓存色图画师的作品 |
/<cache> <ewm> [range]? |
缓存色图画师的收藏 |
/<cache> <search> |
缓存搜索记录 |
/<cache> <stop> [name] |
停止缓存任务 |
/<cache> <detail> |
缓存任务详情 |
Pixiv helper 2 重构中，部分缓存指令 暂不可用
[uid]? 会自动填充当前用户
mode 可选值: MONTH, WEEK, WEEK_ORIGINAL, WEEK_ROOKIE, DAY, DAY_MALE, DAY_FEMALE, DAY_MANGA
| 指令 | 描述 |
|---|---|
/<task> <user> [uid] [cron] [target]? |
推送用户新作品 |
/<task> <rank> [mode] [cron] [target]? |
推送排行榜新作品 |
/<task> <follow> [cron] [target]? |
推送关注用户作品 |
/<task> <recommended> [cron] [target]? |
推送推荐作品 |
/<task> <trending> [cron]? [target]? |
推送热门标签 |
/<task> <cache> [uid] [cron] {args} |
数据自动缓存 |
/<task> <cron> [id] [cron] |
查看任务详情 |
/<task> <detail> |
查看任务详情 |
/<task> <delete> [id] |
删除任务 |
Pixiv helper 2 重构中，部分任务指令 暂不可用
备份文件优先推送到群文件，其次百度云
duration 单位分钟，默认3小时
/task cache {args} 是 task 和 cache 指令的组合，举例，/task cache recommended
| 指令 | 描述 |
|---|---|
/<setting> <interval> [sec] |
设置连续发送间隔时间, 单位秒 |
/<setting> <forward> |
设置Task发送模式 |
/<setting> <link> |
设置是否显示Pixiv Cat 原图链接 |
/<setting> <tag> |
设置是否显示TAG INFO |
/<setting> <attr> |
设置是否显示作品属性 |
/<setting> <cooling> |
|
/<setting> <max> [num] |
设置显示最大图片数 |
/<setting> <model> [type] [ms]? |
设置发送模式 |
Pixiv helper 2 重构中，部分设置指令 暂不可用
发送模式 有三种 NORMAL, FLASH, RECALL, ms 是Recall的延迟时间，单位毫秒
注意：FLASH, RECALL 这两种模式 并不会降低 机器人被封禁 的风险
forward, link, tag, attr 使用指令后会对当前值取反
| 指令 | 描述 |
|---|---|
/<info> <user> [target]? |
获取用户信息 |
/<info> <group> [target]? |
获取群组信息 |
/<info> <top> [limit]? |
获取TAG指令统计信息 |
/<info> <cache> |
获取缓存信息 |
| 指令 | 描述 |
|---|---|
/<delete> <artwork> [pid] [record]? |
删除指定作品 |
/<delete> <user> [uid] [record]? |
删除指定用户作品 |
/<delete> <bookmarks> [max] [record]? |
删除小于指定收藏数作品 |
/<delete> <page> [min] [record]? |
删除大于指定页数作品 |
/<delete> <manga> [record]? |
删除漫画作品 |
/<delete> <record> |
删除已记录作品 |
第二参数 record 表明是否写入数据库，默认为否，只删除图片文件
Pixiv helper 2 重构中，部分自动解析 暂不可用
权限 id: xyz.cssxsh.mirai.plugin.pixiv-helper:url
匹配一下正则表达式的URL将会被解析
val URL_ARTWORK_REGEX = """(?<=pixiv\.net/(i|artworks)/|illust_id=)\d+""".toRegex()
val URL_USER_REGEX = """(?<=pixiv\.net/(u/|users/|member\.php\?id=))\d+""".toRegex()
val URL_PIXIV_ME_REGEX = """(?<=pixiv\.me/)[\w-]{3,32}""".toRegex()
cache_path缓存目录backup_path备份目录temp_path临时目录ero_chunk色图分块大小 和自动触发TAG缓存有关ero_up_expire色图自动触发更高收藏数的最大时间，单位毫秒ero_work_types涩图标准 内容类型ILLUST, UGOIRA, MANGA, 为空则全部符合ero_bookmarks涩图标准 收藏ero_page_count涩图标准 页数ero_tag_exclude涩图标准 排除的正则表达式ero_user_exclude涩图标准 排除的UIDpximg反向代理, 若非特殊情况不要修改这个配置，保持留空，可选代理i.pixiv.re, i.pixiv.catproxyAPI代理proxy_downloadDOWNLOAD代理图片下载器会对代理产生很大的负荷，请十分谨慎的开启这个功能timeout_apiAPI超时时间, 单位mstimeout_downloadDOWNLOAD超时时间, 单位msblock_sizeDOWNLOAD分块大小, 单位B, 默认 523264, 为零时, 不会分块下载tag_sfwtag 是否过滤r18 依旧不会放出图片ero_sfwero 是否过滤r18 依旧不会放出图片cache_capacity下载缓存容量，同时下载的任务上限cache_jump缓存是否跳过下载upload压缩完成后是否上传百度云，不上传百度云则会尝试发送文件
keyKEY 不是必须的，无KEY状态下，根据IP每天可以搜索 100 次，有KEY状态下搜索次数依据于账户
KEY 参数请到 https://saucenao.com/ 注册账号，
在用户页面 https://saucenao.com/user.php?page=search-api 获得的KEY填入
信息只在启动时读取，修改后需重启limit显示的搜索结果数bovwascii2d 检索类型，false色合検索 true特徴検索wait图片等待时间，单位秒forward转发方式发送搜索结果
quantizer编码器,com.squareup.gifencoder.ColorQuantizer的实现
目前可选值，图片质量和所需性能按顺序递增, 推荐使用OctTreeQuantizer
com.squareup.gifencoder.UniformQuantizer
com.squareup.gifencoder.MedianCutQuantizer
com.squareup.gifencoder.OctTreeQuantizer
com.squareup.gifencoder.KMeansQuantizer
xyz.cssxsh.pixiv.tool.OpenCVQuantizer(需要 安装 OpenCV, 对应jar放进plugins文件夹)ditherer抖动器,com.squareup.gifencoder.Ditherer的实现
目前可选值, 推荐使用AtkinsonDitherer
com.squareup.gifencoder.FloydSteinbergDitherer
com.squareup.gifencoder.NearestColorDitherer
xyz.cssxsh.pixiv.tool.AtkinsonDitherer
xyz.cssxsh.pixiv.tool.JJNDitherer
xyz.cssxsh.pixiv.tool.SierraLiteDitherer
xyz.cssxsh.pixiv.tool.StuckiDithererdisposal切换方法
可选值UNSPECIFIED,DO_NOT_DISPOSE,RESTORE_TO_BACKGROUND,RESTORE_TO_PREVIOUSmax_countOpenCVQuantizer 最大迭代数
pixiv.rate.limit.delay默认3 * 60 * 1000Lmspixiv.download.async默认32
如果不是特殊需要，使用默认的 SQLite 配置就好
配置 mysql 举例 (字符集要设置为utf8mb4_bin)，其他数据库类推
配置 文件
hibernate.connection.url=jdbc:mysql://localhost:3306/pixiv?autoReconnect=true
hibernate.connection.driver_class=com.mysql.cj.jdbc.Driver
hibernate.connection.CharSet=utf8mb4
hibernate.connection.useUnicode=true
hibernate.connection.username=username
hibernate.connection.password=password
hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
hibernate.connection.provider_class=org.hibernate.hikaricp.internal.HikariCPConnectionProvider
hibernate.hbm2ddl.auto=none
hibernate-connection-autocommit=true
hibernate.connection.show_sql=false
hibernate.autoReconnect=true
关于表的自动创建可以查看 model
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent