nonebot-plugin-pcr-sign

✨ pcr签到 集印章/邮戳 ✨

📖 介绍

一个从 一个从 hoshino 抄借鉴的 nonebot2 签到插件nonebot-plugin-hoshino-sign 抄借鉴的 nonebot2 签到插件

💿 安装

使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

nb plugin install nonebot-plugin-pcr-sign

使用包管理器安装

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

pip

pip install nonebot-plugin-pcr-sign

pdm

pdm add nonebot-plugin-pcr-sign

poetry

poetry add nonebot-plugin-pcr-sign

conda

conda install nonebot-plugin-pcr-sign

打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入

plugins = ["nonebot_plugin_pcr_sign"]

⚙️ 配置

配置表

在 nonebot2 项目的.env文件中修改配置项

配置项	必填	默认值	说明
sign_argot_expire_time	否	300	暗语过期时间（单位：秒 类型：int）
stamp_path	否	RES_DIR / "stamps"	印章图片路径
sign_background_source	否	"default"	签到背景图来源
album_background_source	否	"default"	收集册背景图来源

background_source

sign_background_source 为签到背景图来源，可选值为字面量 default / LoliAPI / Lolicon / random 或者结构 CustomSource 。LoliAPI 和 Lolicon 均为网络请求获取随机背景图，random为从默认签到背景目录中随机, CustomSource 用于自定义背景图。 默认为 default。

album_background_source 为收集册背景图来源，可选值为字面量 default / kraft / pcr / prev / random 或者结构 CustomSource 。前四者均为预设背景，random为从默认收集册背景目录中随机，CustomSource 用于自定义背景图。 默认为 default。

以下是 CustomSource 用法

在配置文件中设置 xxx_background_source 为 CustomSource结构的字典

CustomSource配置示例

• 网络链接

  • uri 可为网络图片 API，只要返回的是图片即可
  • uri 也可以为 base64 编码的图片，如 data:image/png;base64,xxxxxx （一般也没人这么干）

sign_background_source = '{"uri": "https://example.com/image.jpg"}'

• 本地图片

[!TIP]

• uri 也可以为本地图片路径，如 imgs/image.jpg、/path/to/image.jpg
• 如果本地图片路径是相对路径，会使用 nonebot-plugin-localstore 指定的 data 目录作为根目录
• 如果本地图片路径是目录，会随机选择目录下的一张图片作为背景图

sign_background_source = '{"uri": "/imgs/image.jpg"}'

🎉 使用

Note

记得使用命令前缀哦

🪧 指令表

指令	权限	参数	说明
sign/签到/盖章/妈	所有	无	签到
album/收集册	所有	无 or @	查看自己（或别人）的收集册

🫣 暗语表

Note

🧭 暗语使用指北

暗语消息来自 nonebot-plugin-argot 插件

对暗语对象回复对应的暗语指令即可获取暗语消息

暗语指令	对象	说明
background	签到图	查看背景图
stamp	签到图	获取印章图
raw	签到图	获取原文字消息

Tip

注意暗语消息有过期时间，默认 5min 后失效，可通过配置修改

📸 效果图

🐾 签到图

🎞️ 收集册

💖 鸣谢

• KomoriDev: 优秀的界面风格和设计理念学习
• nonebot-plugin-hoshino-sign：灵感来源
• SonderXiaoming/login_bonus: 灵感来源的来源
• GWYOG-Hoshino-plugins: 灵感来源的来源的来源
• 公主连结吧: 印章素材来源
• nonebot-plugin-argot: 优秀的 NoneBot2 暗语支持
• nonebot-plugin-htmlrender: 优秀的 NoneBot2 HTML 渲染支持
• nonebot-plugin-orm: 优秀的 NoneBot2 数据库支持

📋 TODO

• 数据迁移脚本(从原hoshino_sign插件迁移数据)
• 待补充,欢迎pr