📖 介绍
在 QQ 群聊中查询今日人品,返回 0~100 的数值和对应评价。同一账号在同一天得到相同结果,每天按机器人运行环境的本地日期更新。
支持查询自己、被 @ 的群成员和机器人,也支持通过配置名单调整指定账号的人品范围。
仅支持群聊,查询者群等级需达到10级。
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-jrrp4
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令pip
pip install nonebot-plugin-jrrp4
pdm
pdm add nonebot-plugin-jrrp4
poetry
poetry add nonebot-plugin-jrrp4
conda
conda install nonebot-plugin-jrrp4
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot_plugin_jrrp4"]
⚙️ 配置
无需必填配置。在机器人项目的 .env 或实际使用的 .env.prod 等环境配置文件中添加以下可选配置,重启机器人生效。示例见 .env.example。
| 配置项 | 必填 | 默认值 | 类型 | 说明 |
|---|---|---|---|---|
JRRP_HIGH_LIST |
否 | [] |
list[str] |
人品偏高的 QQ 号列表,通常调整到 75~100 |
JRRP_LOW_LIST |
否 | [] |
list[str] |
人品偏低的 QQ 号列表,通常调整到 0~40 |
JRRP_HIGH_LIST=["123456789", "987654321"]
JRRP_LOW_LIST=["111222333"]
QQ 号需使用字符串形式的 JSON 数组。账号同时出现在两个列表时,优先应用 JRRP_HIGH_LIST。当原始计算结果直接命中 100 分时,不应用名单调整,因此低人品名单中的账号也可能获得 100 分。
🎉 使用
指令表
以下示例假设机器人配置 COMMAND_START=["/"];实际前缀以机器人配置为准。今日人品 是 jrrp 的别名,可在所有示例中替换使用。
| 指令 | 权限 | 需要 @ | 范围 | 说明 |
|---|---|---|---|---|
/jrrp |
群等级 ≥ 10 的成员 | 否 | 群聊 | 查询自己今日人品 |
/jrrp @成员 |
群等级 ≥ 10 的成员 | 是,@目标成员 | 群聊 | 查询被 @ 成员,可一次 @ 多人 |
/jrrp @机器人 |
群等级 ≥ 10 的成员 | 是,@机器人 | 群聊 | 查询机器人今日人品 |
@ 需使用 QQ 的实际 @ 消息,纯文本 QQ 号不会触发查询。查询者等级不足时会提示“你的群聊等级不到10级,不告诉你今日人品!”。当消息被适配器识别为发给机器人(to_me)时,优先查询机器人自身。
回复示例
你今天的人品值是:88/100!为"大吉",太牛了,您今天人品爆发了!
📦 发布说明
仓库提供 PyPI 发布工作流,使用 PEP 621 格式的 pyproject.toml 构建 wheel 和源码包,并在上传前校验包信息。
需要维护者自行完成的远程配置:
- 将仓库发布到
HuParry/nonebot-plugin-jrrp4,并将本地 Git remote 指向自己的仓库。 - 在 PyPI 创建 API Token,并在 GitHub 仓库的 Settings → Secrets and variables → Actions 中添加名为
PYPI_API_TOKEN的 Repository secret。 - 发布新版本前修改
pyproject.toml中的project.version和插件__plugin_meta__.extra中的version,保持一致,并提交代码。 - 创建并推送对应版本的标签,触发工作流。例如当前版本:
git tag v0.2.3
git push origin v0.2.3
标签版本必须与 project.version 一致,允许使用 v 前缀。工作流也可在 GitHub Actions 中手动运行;同一 PyPI 版本不能重复上传。
如需提交 NoneBot 插件商店,维护者还需按 官方发布指引 操作;项目名为 nonebot-plugin-jrrp4,插件模块名为 nonebot_plugin_jrrp4。
📄 开源协议
本项目采用 MIT License。
Metadata
Release files for nonebot-plugin-jrrp4 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nonebot_plugin_jrrp4-0.2.3.tar.gz | 6.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_jrrp4-0.2.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 14.2 kB
Release files / nonebot_plugin_jrrp4-0.2.3.tar.gz
| Download URL | nonebot_plugin_jrrp4-0.2.3.tar.gz |
|---|---|
| Size | 6.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d06c91a24cfa3102f6a33fc876f5cb9811c96ead170d999790ff1bb4a1929b2
|
|
BLAKE2b-256 checksum How to use checksums |
e2168a0fbf07164744aee8c92f73d83f2a8c6ce0d2ea0c86466ebe3736b6c3ac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / nonebot_plugin_jrrp4-0.2.3-py3-none-any.whl
| Download URL | nonebot_plugin_jrrp4-0.2.3-py3-none-any.whl |
|---|---|
| Size | 7.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
19ad3e16c6bab822d389226e74f33535d190f543f60dcd5b8106631b64582d90
|
|
BLAKE2b-256 checksum How to use checksums |
2b62f4f45eb2d10351a4d1ffa137ba4708cff395d54654fa5adcf504f9e23e81
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|