一个基于 HoshinoBot 的 Pixiv 插件，包含 画师订阅 和 Pixiv工具 两个独立的服务，支持自动推送、作品预览、pixiv排行榜查询等功能。

• 自动推送: 定时检查订阅画师的最新作品并推送到群聊。
• 权限管理: 支持群管理员设置订阅、屏蔽规则等。
• R18 控制: 可选择是否推送 R18 内容。
• 标签屏蔽: 支持屏蔽包含特定标签的作品。

• 作品预览: 通过画师id或者URL预览画师最新作品。
• 作品获取: 通过作品ID或URL获取指定插画。
• 排行榜: 获取Pixiv日、周、月、男性向、女性向、原画等多种排行榜。
• 防刷屏: 排行榜和画师预览默认使用合并转发消息，避免刷屏。

• 2025.11.25 添加图片扰动避免风控, 添加带合并转发模式的多图发送, 添加发送GIF的逻辑, 优化订阅列表显示, 添加画师名缓存
  • 感谢 @Virgo41 提交的 PR #3
  • 修改了 pixiv_tools.py, config.py, pixiv.py 文件, 新增 utils.py 文件
• 2025.11.23 给排行榜功能添加频率限制
  • 修改了 pixiv_tools.py, config.py 文件
• 2025.11.18 插件拆分为 pixiv-subscription 和 pixiv-tools 两个服务
  • 将 pget 命令从pixiv-subscription 移动到 pixiv-tools 服务中
  • 修改了 pixiv.py 文件, 新增 pixiv_tools.py 文件
• 2025.11.11 让输入画师主页URL也可以订阅和取消订阅, pget可以使用URL获取插图
  • 修改了 pixiv.py 文件
• 2025.10.14 添加了 pixiv获取插画|pget 命令
  • 可以使用插画的id获取指定插画, 并且有每日调用上限可在配置中修改。
  • 修改了 config.py和pixiv.py两个文件。

• 安装必要的依赖库：
  • 依赖库：

    pip install -r requirements.txt

  • 或者手动安装：

    pip install pixivpy3==3.7.5 aiohttp

• 下载或者clone本插件项目，并将pixiv-subscription 文件夹放入 HoshinoBot 的 modules 目录下。
• 在 MODULES_ON 列表中，添加 pixiv-subscription 并重启 HoshinoBot 使配置生效

在 config.py 中进行配置：

# 代理设置（可选）
PROXY_URL = None  # 例如: "http://127.0.0.1:10808"

# 每次推送时最多展示的作品数量，当画师连投（检查时间间隔内发布多个独立作品）时生效，多图作品仅展示首图
MAX_DISPLAY_WORKS = 3

# 可选值: 'square_medium', 'medium', 'large', 'original' (可以大致理解为从小到大)
# 注意: original质量的图片体积较大，可能导致发送失败
IMAGE_QUALITY = 'large'

# 是否启用“轻微修改图片像素以避免图片被风控”的功能
ENABLE_PIXEL_NOISE = True

CHECK_INTERVAL_HOURS = 3  # 检查更新的时间间隔，单位为小时

# 单用户pixiv获取插画命令每日获取作品的上限
PGET_DAILY_LIMIT = 10  

# 单用户预览画师信息命令每日使用上限
PREVIEW_ILLUSTRATOR_LIMIT = 10  

# 是否启用合并转发回复模式
CHAIN_REPLY = True  

# 每次推送排行榜时最多展示的作品数量
RANK_LIMIT = 5  

# 是否启用“推送机器人账号关注的画师”功能
# 开启后，各群管理员才能通过指令选择是否接收推送
# 出于隐私和性能考虑，默认关闭
ENABLE_FOLLOWING_SUBSCRIPTION = False

# 发送的动图的文件格式, 可选值: 'GIF', 'WEBP', WEBP格式在手机上可能是静态的
# 但是GIF通常较大, 可能会超过文件大小限制导致发送失败
UGOIRA_IMAGE_MODE = "GIF"

# 发送的动图的文件大小限制, 单位: MB, 超过限制将不发送动图而改为发送静态封面图
UGOIRA_IMAGE_SIZE_LIMIT = 30

# 动图最大帧数限制
UGORIA_MAX_FRAMES = 600

1. 下载并运行认证脚本：

   bash python pixiv_auth.py login
   

   脚本会自动打开浏览器进入Pixiv登录页面

2. 打开开发者工具(F12)，切换到网络(Network)标签页

3. 启用持久日志记录 ("Preserve log")

4. 在过滤器字段中输入：callback?

5. 完成Pixiv登录流程

6. 登录成功后，你会看到一个空白页面和类似这样的请求： https://app-api.pixiv.net/web/v1/users/auth/pixiv/callback?state=...&code=... 复制code参数的值到脚本提示中并按回车

   如果操作正确，会显示auth_token和refresh_token

   ⚠️ 注意：code的有效期极短，请尽量减少步骤5和6之间的延迟。如果失败，请从步骤1重新开始。

7. 将获取到的 refresh_token 填入 refresh-token.json 文件中

   {
     "refresh_token": "你的_refresh_token_值"
   }

   更多信息请参考 pixivpy3 仓库, 以及 @ZipFile Pixiv OAuth Flow

此服务默认开启，主要用于自动推送画师更新。

注意: 此服务默认关闭，手动在需要群中开启

• ⚠️ refresh_token 为账号的登录凭证，请妥善保管, 不要上传到公共仓库, 不清楚频繁请求会不会账号收到限制, 目前未发现有这种情况
• refresh_token的过期时间较长, 没有明确的过期时间, 但如果发现bot出现登录失败, 可以尝试重新获取并更新token
• 图片质量选择original质量时文件较大，可能导致发送失败

pixiv-subscription/
├── config.py           # 配置文件
├── requiements.txt     # 依赖列表
├── pixiv_auth.py       # 用于获取refresh_token的脚本
├── pixiv_tools.py      # pixiv-tools服务主文件
├── pixiv.py            # pixiv-subscription服务主文件
├── refresh-token.json  # Pixiv 认证信息, 需要在这里填写 refresh_token
└── subscriptions.json  # 群组订阅数据以及设置（启动后自动生成）

• pixivpy3会通过refresh_token来获取access_token, 后续的请求都是携带access_token进行的, 但access_token 的有效期只有1+小时, 所以在不做任何处理的情况下, 过一段时间后就会出现登陆失效的情况. 目前采用的策略是直接进行api的请求, 如果发现请求失败则使用api.login(refresh_token)来重新登陆, 但是作为时长大于3小时的定时任务来说, 每次必定会出现一次失败请求, 后续可以考虑优化一下这个地方

欢迎提交 Issue 和 Pull Request 来改进这个插件。

如有问题或建议，请在项目仓库中提交 Issue。