KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

pixiv-helper

★ 117 Open GitHub ↗

Mirai Console 插件开发计划

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# [Pixiv Helper](https://github.com/cssxsh/pixiv-helper)

> 基于 [Mirai Console](https://github.com/mamoe/mirai-console) 的 [Pixiv](https://www.pixiv.net/) 插件

基于 Kotlin Pixiv库 [PixivClient](https://github.com/cssxsh/pixiv-client) ，通过清除ServerHostName 绕过SNI审查，免代理

[![Release](https://img.shields.io/github/v/release/cssxsh/pixiv-helper)](https://github.com/cssxsh/pixiv-helper/releases)
![Downloads](https://img.shields.io/github/downloads/cssxsh/pixiv-helper/total)
[![MiraiForum](https://img.shields.io/badge/post-on%20MiraiForum-yellow)](https://mirai.mamoe.net/topic/289)

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

* [User Manual](https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md)
* [Permission Command](https://github.com/mamoe/mirai/blob/dev/mirai-console/docs/BuiltInCommands.md#permissioncommand)
* [Chat Command](https://github.com/project-mirai/chat-command)

**Pixiv Helper 2 重构进行中，部分功能还不可用. 需要重新登录Pixiv 账号，你可以使用之前登录得到的 Token**

目前没有自动缓存清理，请使用 [#删除指令](#删除指令) 手动清理  
R18图会按照Pixiv所给信息过滤  
群聊模式使用默认账号，私聊模式Pixiv账号和QQ号关联，初次使用请先 `/pixiv` 指令登陆账号  
然后使用 `/cache recommended` 缓存系统推荐作品，然后再使用色图相关指令  
推荐使用 `/task cache recommended` 定时自动缓存

Gif图片需要由机器人自己合成，如果设备性能不足，请调整相关参数

自 `1.9.0` 起将数据库部分功能拆分  
需要 [Mirai Hibernate Plugin](https://github.com/cssxsh/mirai-hibernate-plugin) 做前置插件  
这是**必要**的  
MCL安装指令 `./mcl --update-package xyz.cssxsh.mirai:mirai-hibernate-plugin --channel maven-stable --type plugins`

**打开浏览器，登录PIXIV** 需要 [Mirai Selenium Plugin](https://github.com/cssxsh/mirai-selenium-plugin) 做前置插件
并且需要代理配置（可以打开浏览器后，在浏览器中配置），浏览器登录只是其中一种登录方法，不必要安装 Selenium 插件

群聊默认输出最少作品信息，需要增加请使用 `/setting` 指令修改

发送模式可以使用 `/setting` 指令修改为闪照或撤销或转发  
注意, 闪照等模式 并不会降低 `机器人被封禁` 的风险。  
机器人被封禁的主要风险来自

* QQ号是新注册的
* Bot挂在服务器上，但是服务器IP被腾讯列为风险IP(腾讯通过IP确定 登录地区)
* Bot被高频使用，(另外，`高频发图再高频撤销`属于不打自招，正常用户有这个手速吗？)
* 发送大量违规链接，或者触发关键词

## 指令

注意: 使用前请确保可以 [在聊天环境执行指令](https://github.com/project-mirai/chat-command)  
带括号的`/`前缀是可选的  
`<...>`中的是指令名，由空格隔开表示或，选择其中任一名称都可执行例如`/色图`  
`[...]`表示参数，当`[...]`后面带`?`时表示参数可选  
`{...}`表示连续的多个参数

本插件指令权限ID 格式为 `xyz.cssxsh.mirai.plugin.pixiv-helper:command.*`, `*` 是指令的第一指令名  
例如 `/pixiv sina` 的权限ID为 `xyz.cssxsh.mirai.plugin.pixiv-helper:command.pixiv`

### 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](http://www.editthiscookie.com/) 导出的Json  
EditThisCookie 安装地址
[Chrome](https://chrome.google.com/webstore/detail/editthiscookie/fngmhnnpilhplaeedifhccceomclgfbg)
[Firefox](https://addons.mozilla.org/firefox/downloads/file/3449327/editthiscookie2-1.5.0-fx.xpi)
[Edge](https://microsoftedge.microsoft.com/addons/getproductdetailsbycrxid/ajfboaconbpkglpfanbmlfgojgndmhmc?hl=zh-CN&gl=CN)

### 色图相关指令

| 指令                                                | 描述                      |
|:--------------------------------------------------|:------------------------|
| `(/)<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参数在设置中添加  
举例:  
![从指令参数中获取](https://raw.githubusercontent.com/cssxsh/pixiv-helper/dev/image/search_1.png)  
![从回复消息中获取](https://raw.githubusercontent.com/cssxsh/pixiv-helper/dev/image/search_2.png)  
![从最近图片中获取](https://raw.githubusercontent.com/cssxsh/pixiv-helper/dev/image/search_3.png)  
![从输入等待中获取](https://raw.githubusercontent.com/cssxsh/pixiv-helper/dev/image/search_4.png)

`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>`            | ~~设置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 表明是否写入数据库，默认为否，只删除图片文件

## 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~~ 压缩完成后是否上传百度云，不上传百度云则会尝试发送文件

### 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)，其他数据库类推
配置 文件

```
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](/src/main/resources/xyz/cssxsh/mirai/pixiv/model)

pixiv-helper

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README