Pixiv Helper

基于 Mirai Console 的 Pixiv 插件

基于 Kotlin Pixiv库 PixivClient ，通过清除ServerHostName 绕过SNI审查，免代理

使用前应该查阅的相关文档或项目

• User Manual
• Permission Command
• Chat Command

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 stable --type plugin

打开浏览器，登录PIXIV 需要 Mirai Selenium Plugin 做前置插件 并且需要代理配置（可以打开浏览器后，在浏览器中配置），浏览器登录只是其中一种登录方法，不必要安装 Selenium 插件

百度云上传功能 需要 Netdisk FileSync Plugin 做前置插件
但不必要，如果不使用上传功能请忽略，上传功能 在 Pixiv Helper 2 重构计划中，暂时不可用

群聊默认输出最少作品信息，需要增加请使用 /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相关操作指令

Pixiv helper 2 重构中，follow 和 mark 暂不可用
Pixiv helper 2 中 新加入 /pixiv bind 指令，此指令用于为一个联系人（群/用户）绑定一个 pixiv 账号（已登录）

cookie 文件为工作目录下的 cookie.json
内容 为 浏览器插件 EditThisCookie 导出的Json
EditThisCookie 安装地址 Chrome Firefox Edge

色图相关指令

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 的搜索结果

缓存指令

Pixiv helper 2 重构中，部分缓存指令 暂不可用

[uid]? 会自动填充当前用户

mode 可选值: MONTH, WEEK, WEEK_ORIGINAL, WEEK_ROOKIE, DAY, DAY_MALE, DAY_FEMALE, DAY_MANGA

任务指令

Pixiv helper 2 重构中，部分任务指令 暂不可用

备份文件优先推送到群文件，其次百度云
duration 单位分钟，默认3小时
/task cache {args} 是 task 和 cache 指令的组合，举例，/task cache recommended

设置指令

Pixiv helper 2 重构中，部分设置指令 暂不可用

发送模式 有三种 NORMAL, FLASH, RECALL, ms 是Recall的延迟时间，单位毫秒
注意：FLASH, RECALL 这两种模式 并不会降低 机器人被封禁 的风险
forward, link, tag, attr 使用指令后会对当前值取反

备份指令

Pixiv helper 2 重构中，备份指令 暂不可用

reload 的 mode 可选 有以下几种 EXCEPTION, IGNORE, OVERWRITE, LATEST_VERSION
reload 的 chunk 为分段提交数量的大小, 默认 8196
使用百度云服务需要的准备详见配置

统计信息指令

播放指令

Pixiv helper 2 重构中，播放指令 暂不可用

删除指令

第二参数 record 表明是否写入数据库，默认为否，只删除图片文件

URL 自动解析

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()

设置

PixivHelperSettings.yml

• 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 涩图标准 排除的UID
• pximg 反向代理, 若非特殊情况不要修改这个配置，保持留空，可选代理 i.pixiv.re, i.pixiv.cat
• proxy API代理
• proxy_download DOWNLOAD代理 图片下载器会对代理产生很大的负荷，请十分谨慎的开启这个功能
• timeout_api API超时时间, 单位ms
• timeout_download DOWNLOAD超时时间, 单位ms
• block_size DOWNLOAD分块大小, 单位B, 默认 523264, 为零时, 不会分块下载
• tag_sfw tag 是否过滤r18 依旧不会放出图片
• ero_sfw ero 是否过滤r18 依旧不会放出图片
• cache_capacity 下载缓存容量，同时下载的任务上限
• cache_jump 缓存是否跳过下载
• upload 压缩完成后是否上传百度云，不上传百度云则会尝试发送文件

~~NetdiskOauthConfig.yml~~

从 1.7.2 开始 百度云上传功能需要 Netdisk FileSync Plugin 作前置插件
该配置作废，改由前置插件配置，并且需要重新验证
或者将 PixivConfig.yml 中的 token 手动迁移 到 前置插件的 user.yml

插件上传文件功能需要百度网盘API支持，但这个配置(备份文件)是可选的，不影响其他功能的使用。
请到 https://pan.baidu.com/union/main/application/personal 申请应用，并将获得的APP信息填入
信息只在启动时读取，修改后需重启，并使用 /backup auth 认证百度账号

ImageSearchConfig.yml

• key KEY 不是必须的，无KEY状态下，根据IP每天可以搜索 100 次，有KEY状态下搜索次数依据于账户
  KEY 参数请到 https://saucenao.com/ 注册账号，
  在用户页面 https://saucenao.com/user.php?page=search-api 获得的KEY填入
  信息只在启动时读取，修改后需重启
• limit 显示的搜索结果数
• bovw ascii2d 检索类型，false色合検索 true特徴検索
• wait 图片等待时间，单位秒
• forward 转发方式发送搜索结果

PixivGifConfig.yml

• 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.StuckiDitherer
• disposal 切换方法
  可选值 UNSPECIFIED, DO_NOT_DISPOSE, RESTORE_TO_BACKGROUND, RESTORE_TO_PREVIOUS
• max_count OpenCVQuantizer 最大迭代数

System.getProperty

• pixiv.rate.limit.delay 默认 3 * 60 * 1000L ms
• pixiv.download.async 默认 32

hibernate.properties

如果不是特殊需要，使用默认的 SQLite 配置就好
配置 mysql 举例 (字符集要设置为utf8mb4_bin)，其他数据库类推
~~下载 mysql-connector-java , 然后放进 plugins 文件夹~~ (1.8.3+，mirai-hibernate-plugin 自带 mysql 此步骤不再需要)
配置 文件

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