🐖 RollPig Plus 🐖

围绕「今日小猪」的 NoneBot 群聊收集、成长与互动插件

每天抽一只属于你的小猪，慢慢养成属于自己的猪圈吧！也可以把群友烤了~

快速开始 | 主要功能 | 功能概览 | 常用指令 | 配置 | 资源与扩展

RollPig Plus 最初基于 Bearlele/nonebot-plugin-rollpig 开发。
本项目在保留「每天抽一只小猪」核心功能的基础上，继续扩展了图鉴成长、EX Lv.、烤群友、日报、EX 差分资源与多 Bot 状态同步等能力。

原版 RollPig 现已完成重构并支持 GIF 小猪，同时接入 RollPig 公共资源同步，可持续获取每月更新的完整小猪资源。 如果只需要轻量的「今日小猪 / 随机小猪 / 找猪」体验，可以直接使用原版。

✨ 效果预览

今日小猪	小猪图鉴	烤群友

🐷 主要功能

RollPig Plus 不硬性要求接入 Cloud、AI。普通卡片与图鉴均使用 Pillow 渲染，默认配置即可运行基础功能。

🚀 快速开始

环境要求：

• Python >= 3.10
• NoneBot >= 2.4.0
• OneBot V11

使用 nb-cli

nb plugin install nonebot-plugin-rollpig-plus

使用 pip

pip install -U nonebot-plugin-rollpig-plus

如果你手动管理插件加载，请确认已加载：

nonebot.load_plugin("nonebot_plugin_rollpig_plus")

启动 Bot 后直接发送：

今日小猪

即可开始。

🎮 功能概览

每日抽猪与猪圈

每个用户每天只会生成一次正式抽取结果，发送 今日小猪、今天是什么小猪 或 猪来 均可查看；当天重复触发不会改变结果。

抽到新猪会自动收录进自己的猪圈；重复抽到已解锁小猪时，会继续累计次数并提升 EX Lv.。达到对应等级后会自动切换专属差分图片与文案，如果发现仍没有变化，那是还没做，请狠狠催促赶工。

连续抽到重复小猪时，还会逐步提高后续抽中新猪的概率，避免长期卡在重复收藏。

烤猪与烤群友

今日烤猪 会把自己的今日小猪做成料理。

烤群友 @目标（也支持 @目标 烤群友 或直接回复目标消息）是一套独立的群聊互动玩法：发起者需要先抽取自己的今日小猪；目标已经抽猪时直接开火结算，目标还没抽猪时会自动建立预约烤猪。第一位发起预约的人成为主厨，其他群友可以继续免费烤同一目标，或直接回复预约通知发送 加入 来添柴，等目标抽猪后统一开炉。

前一天在本群被烤次数最多的群友会获得次日保护券。针对受保护的目标发起烧烤时，会自动进入聚众烤猪：单人普通火力烤不动，需要多位群友一起添柴（或动用每日一次的 加急生火 提供双倍火力）凑够火力门槛后才能开炉。

每天第一次通过普通 烤群友 / 随机烤猪 成功，或作为普通成员参与预约成功结算时，自己的今日小猪会蹭到一顿烤猪加餐并成长 1 级。当群友们的普通烧烤次数用尽时，今日活跃玩家还可以发送 烤箱续火 发起表情回应投票，为全群活跃小猪回满烧烤配额。

群聊总结

发送 昨日小猪 可以回顾昨天抽到的小猪、成长变化与互动经历；如果昨天忘了抽猪，还会自动免费补签一次并计入收藏与成长。

发送 本周小猪 会生成个人一周总结长图。

群内发送 猪圈日报 可随时查看本群最近一期已封版的日报卡（汇总当日抽猪、头条事件、三大排行榜与次日保护券得主）。群主或管理员还可以通过 小猪日报 开启 开启每日定时推送；默认关闭自动推送，不影响群友主动查卡。

⌨️ 常用指令

⚙️ 配置

默认就能用

RollPig Plus 自带完整默认值，不写 .env、不创建 JSON 配置文件也能启动。

默认状态：

• 使用本地 JSON 存储；
• AI 烤猪关闭，使用共享文案与本地模板；
• 公有小猪资源与 GIF 小猪 Overlay 自动增量同步；
• 图片版小猪图鉴开启；
• 猪圈日报定时推送默认关闭（主动查卡不受影响）；
• Cloud 关闭。

配置优先级：

.env / NoneBot 配置 > JSON 配置文件 > 插件默认值

完整可用配置示例见 rollpig_config.example.json。默认会尝试读取 Bot 运行目录下的 rollpig_config.json（兼容 config/rollpig.json），也可通过环境变量指定路径：

ROLLPIG_CONFIG_FILE=/path/to/rollpig_config.json

开启 AI 烤猪

只填 Key 不会自动开启 AI，还需要显式启用：

ROLLPIG_AI_ENABLED=true
ROLLPIG_AI_API_KEY=sk-xxxxxxxxxxxxxxxx

支持 OpenAI Chat Completions 兼容接口（仍兼容旧字段 ROLLPIG_DEEPSEEK_KEY）。默认模型与其他参数可在 rollpig_config.example.json 中调整；AI 请求失败时会自动回退共享/本地文案，不影响正常烤猪。

接入 RollPig Cloud

默认 local 模式完全不需要 Cloud。需要多 Bot 共用状态时，可配置：

{
  "rollpig": {
    "rollpig_storage_backend": "cloud",
    "rollpig_cloud_api_url": "https://your-rollpig-cloud.example.com"
  }
}

Token 建议放在 .env：

ROLLPIG_CLOUD_TOKEN=replace-with-token

Cloud 模式用于同步今日小猪、图鉴成长、烧烤充能、预约与聚众烤猪及日报等核心状态；关键写操作在异常时保持严格一致，不会落回本地造成数据分叉。使用当前版本完整功能（含回复加入预约、昨日补签、聚众烤猪与多人反噬记录）请配合 RollPig Cloud 0.10.0+，升级时建议先升级 Cloud 再升级 Plus。

添加额外 Overlay

GIF Overlay 随公有资源自动启用，无需手动配置。如需额外加载私有或主题扩展包（例如 PJSK 主题包）：

{
  "rollpig": {
    "rollpig_private_resource_manifests": [
      {
        "name": "pjsk",
        "manifest_url": "https://pig.felislab.cc/resources/rollpig-pjsk/manifest.json"
      }
    ]
  }
}

更换卡片字体

猪圈日报已内置固定标题所需的 Noto Serif SC 子集。若希望昵称、事件和排行也使用同款宋体，可下载完整的 Noto Serif SC Bold；昨日回顾卡也可搭配霞鹜文楷等自定义字体。

将字体文件放入 Bot 运行目录并在 rollpig_config.json 中填写（支持绝对路径或相对 Bot 运行目录的路径，留空或不可用时自动回退默认字体）：

{
  "rollpig": {
    "rollpig_card_font_path": "fonts/NotoSerifCJKsc-Bold.otf",
    "rollpig_yesterday_card_title_font_path": null,
    "rollpig_yesterday_card_body_font_path": "fonts/LXGWWenKaiTC-Bold.ttf"
  }
}

📦 资源与扩展

RollPig Plus 的公共资源由独立仓库维护：Felis2026/rollpig-resources

默认情况下，插件会自动按文件增量同步并缓存公有基础小猪、立绘图片、EX 等级差分、GIF 小猪 Overlay 与共享烤猪文案（只下载新增或变化的文件，并在完整 SHA-256 校验通过后原子切换；失败时保留当前可用资源）。

想自行添加或修改小猪素材，可通过 Overlay 追加或覆盖，无需修改插件源码。自建私有包请参考：rollpig-resources / 本地私有包指南。

资源文件的来源、版权和再分发条件以 rollpig-resources 仓库中的授权与来源说明为准；插件代码的 MIT License 不代表所有图片、文案和第三方素材都适用 MIT。

☁️ 多 Bot 同步

RollPig Cloud 是可选组件，不是安装 Plus 的前置条件。 单 Bot 或不需要跨实例共享数据时，保持默认 local 即可。

如果同一套 RollPig 运行在多个 Bot / 多个实例中，可以部署并接入 Felis2026/rollpig-cloud，或直接提 Issue 申请接入现有 Cloud。Cloud 负责将成长与互动状态放在统一后端，图片、PigHub 索引和卡片渲染仍由各实例本地处理。

🔄 原版 RollPig 与 Plus 怎么选

原版 Bearlele/nonebot-plugin-rollpig 与 RollPig Plus 共享同一套持续更新的公共小猪资源池（含 GIF 小猪），区别主要在于插件定位与群聊玩法密度：

🧱 项目与生态

🛠️ 开发与维护

仓库包含自动化测试，核心代码已经按业务职责拆分为：

• 指令与参数解析：handlers/
• 抽猪规则：roll_flow.py
• 烤群友：roast_flow.py
• 预约与聚众烤猪：reservation_flow.py / reservation_delivery.py
• 烤箱续火：roast_refill.py
• 每日保护与日报统计：daily_protection.py / daily_report.py / roast_statistics.py
• 资源同步：resource_manager.py
• PigHub：pighub_service.py
• AI / 共享烤猪文案：roast_manager.py
• 本地 / Cloud 存储：store/
• 卡片、图鉴与日报渲染：card_renderer.py / catalog_renderer.py / daily_report_card_renderer.py

完整版本变更请直接查看 CHANGELOG.md，不再于 README 中重复维护每个版本的更新清单。

📄 许可证与致谢

插件代码使用 MIT License。

Copyright (c) 2025 Bear_lele
Copyright (c) 2025-2026 Felis

本项目最初基于 Bearlele/nonebot-plugin-rollpig 开发，感谢原作者提供 RollPig 的核心创意与基础实现。

内置资源及云端资源并非全部由单一作者创作，也不统一适用插件代码的 MIT License。 资源来源和授权条件请以 rollpig-resources 与 THIRD_PARTY_NOTICES.md 中的实际说明为准。

普通卡片、图鉴、昨日回顾卡正文及猪圈日报动态内容默认使用 Source Han Sans SC Medium，并通过 pilmoji 与 Google Noto Emoji 渲染彩色 Emoji。猪圈日报的固定报头和栏目标题使用内置的 Noto Serif SC 轻量子集；相关第三方许可见 THIRD_PARTY_NOTICES.md。