nonebot-plugin-jrrp4

✨ 基于NoneBot2和OneBot V11的今日人品插件 ✨

📖 介绍

在 QQ 群聊中查询今日人品，返回 0～100 的数值和对应评价。同一账号在同一天得到相同结果，每天按北京时间（Asia/Shanghai）零时更新。

支持查询自己、被 @ 的群成员和机器人，也支持通过配置名单调整指定账号的人品范围。

采用每日稳定的伪随机抽样。节假日、黄道日与黄历吉神中的天赦日会提高高分概率，可叠加，但好日子仍可能抽到低分。分数用于娱乐，不预测现实运气；数学模型、日期来源和概率示例见 算法说明。

仅支持群聊，查询者群等级默认需达到 10 级，可通过 JRRP_MIN_LEVEL 调整，设为 0 可关闭等级限制。

💿 安装

nb plugin install nonebot-plugin-jrrp4

pip install nonebot-plugin-jrrp4

pdm add nonebot-plugin-jrrp4

poetry add nonebot-plugin-jrrp4

conda install nonebot-plugin-jrrp4

plugins = ["nonebot_plugin_jrrp4"]

⚙️ 配置

无需必填配置。在机器人项目的 .env 或实际使用的 .env.prod 等环境配置文件中添加以下可选配置，重启机器人生效。

JRRP_MIN_LEVEL=10
JRRP_HIGH_LIST=["123456789", "987654321"]
JRRP_LOW_LIST=["111222333"]

QQ 号需使用字符串形式的 JSON 数组。账号同时出现在两个列表时，优先应用 JRRP_HIGH_LIST。低名单不会得到 100 分。已经查询过的当天结果会保留，修改名单后仅影响尚未生成结果的账号和未来日期。

插件通过 nonebot-plugin-localstore 保存 luck.sqlite3，包含随机种子和每日结果。重启后分数不变，迁移时需保留数据库；删除数据库会改变结果。不同机器人拥有独立种子，跨机器人分数不保证相同。首次升级到 0.3.0 会采用新算法生成分数。

节假日按中国大陆放假数据识别，普通周末和调休上班日不额外加权。未知年份只应用黄历权重并发出警告，需在官方放假安排公布后更新 chinesecalendar。

🎉 使用

指令表

以下示例假设机器人配置 COMMAND_START=["/"]；实际前缀以机器人配置为准。今日人品 是 jrrp 的别名，可在所有示例中替换使用。

@ 需使用 QQ 的实际 @ 消息，纯文本 QQ 号不会触发查询。查询者等级不足时会提示“你的群聊等级不到{配置阈值}级，不告诉你今日人品！”。限制作用于发起查询的成员，而非被查询的成员。设为 0 时不检查群聊等级；启用限制时，OneBot 实现需返回可转换为整数的 level 字段。当消息被适配器识别为发给机器人（to_me）时，优先查询机器人自身。

回复示例

你今天的人品值是：88/100！为"大吉"，太牛了，您今天人品爆发了！

📦 发布说明

仓库提供 PyPI 发布工作流，使用 PEP 621 格式的 pyproject.toml 构建 wheel 和源码包，并在上传前校验包信息。

需要维护者自行完成的远程配置：

1. 将仓库发布到 HuParry/nonebot-plugin-jrrp4，并将本地 Git remote 指向自己的仓库。
2. 在 PyPI 创建 API Token，并在 GitHub 仓库的 Settings → Secrets and variables → Actions 中添加名为 PYPI_API_TOKEN 的 Repository secret。
3. 发布新版本前修改 pyproject.toml 中的 project.version 和插件 __plugin_meta__.extra 中的 version，保持一致，并提交代码。
4. 创建并推送对应版本的标签，触发工作流。例如当前版本：

git tag v0.3.0
git push origin v0.3.0

标签版本必须与 project.version 一致，允许使用 v 前缀。工作流也可在 GitHub Actions 中手动运行；同一 PyPI 版本不能重复上传。

如需提交 NoneBot 插件商店，维护者还需按 官方发布指引 操作；项目名为 nonebot-plugin-jrrp4，插件模块名为 nonebot_plugin_jrrp4。

📄 开源协议

本项目采用 MIT License。