Skip to main content

nonebot-plugin-penguin

✨ 向企鹅物流查询关卡掉落物数据 ✨

license action codecov python

📖 介绍

接入企鹅物流查询明日方舟关卡掉落物信息!

💿 安装

使用 nb-cli 安装 在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
nb plugin install nonebot-plugin-penguin
使用包管理器安装 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
pip 与仓库同步:
pip install git+https://github.com/AzideCupric/nonebot-plugin-penguin.git

PyPi:

pip install nonebot-plugin-penguin
poetry 与仓库同步:
poetry add git+https://github.com/AzideCupric/nonebot-plugin-penguin.git

PyPi:

poetry add nonebot-plugin-penguin

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

plugins = ["nonebot_plugin_penguin"]

⚙️ 配置

在 nonebot2 项目的.env文件中添加下表中的必填配置

配置项 必填 默认值 值类型/可选 说明
penguin_mirrior 否 io io / cn 选择企鹅物流网站镜像
penguin_show_count 否 5 任意正整数 查询结果显示的最大条目数
penguin_id_map_path 否 <空> 任意存在目录 企鹅物流数据库存储路径

🎉 使用

指令

指令名: penguin 或者 企鹅物流

格式:
penguin [-h] {item,stage,exact} names [names ...] [-s {cn,kr,us,jp}] [-l {zh,ko,en,ja}] [-k {percentage,apPPR}] [-f {all,only_open,only_close}] [-t THRESHOLD] [-r]

位置参数:
{item,stage,exact}    查询类型
                        item: 按掉落物名查询
                        stage: 按关卡名查询,
                        exact: 精确查询(需指定关卡名和掉落物名)

names                 关卡/掉落物名称或别名(H12-4 / 紫薯 / 固源岩)
                        type为exact时,关卡在前,空格隔开, 例如: 1-7 固源岩

options:
-h, --help              显示帮助

-s {cn,kr,us,jp}, --server {cn,kr,us,jp}
                        游戏服务器选择, 默认为cn

-l {zh,ko,en,ja}, --lang {zh,ko,en,ja}
                        生成回复时使用的语言, 默认为zh

-k {percentage,apPPR}, --sort {percentage,apPPR}
                        排序方式, 默认为percentage
                        percentage: 掉落率
                        apPPR: 每个掉落物平均消耗理智

-f {all,only_open,only_close}, --filter {all,only_open,only_close}
                        关卡过滤方式,默认为all

-t THRESHOLD, --threshold THRESHOLD
                        掉落物过滤阈值, 默认超过100的样本数才会显示

-r, --reverse         是否反转排序,建议使用apPPR排序时打开

例子:

  1. 查询12-4的掉落物 penguin stage H12-4
  2. 查询紫薯的掉落关卡 penguin item 紫薯
  3. 查询12-4的掉落物, 且只显示开放的关卡 penguin stage 12-4 -f only_open
  4. 查询1-7的固源岩的掉落信息 penguin exact 1-7 固源岩
  5. 按apPPR(单件掉落物消耗理智)排序查询固源岩的掉落关卡(-r: apPPR越小越好) penguin item 固源岩 -k apPPR -r

*请自行添加你给bot设置的命令前缀,如/penguin, #penguin

⚠️ 已知问题

  1. 初次安装时,若之前没有使用过nonebot-plugin-htmlrender, 第一次使用时会开始安装浏览器,可能会比较非常慢
  2. 可能是htmlrender或者网络的原因,有时候图片渲染会非常的慢,甚至超时,请重试

📝 ToDo

  • 可以使用penguin zone <活动名称>查询一系列活动关卡
  • 可以使用penguin item/stage name1 name2 ...批量查询
  • 添加一个本地的缓存数据库,每周更新一次,减少网站访问频率,提高查询效率

Metadata

Release files for nonebot-plugin-penguin 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nonebot-plugin-penguin 0.1.0
File Size Uploaded Provenance
nonebot_plugin_penguin-0.1.0.tar.gz 1.2 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for nonebot-plugin-penguin 0.1.0
File Interpreter ABI Platform
nonebot_plugin_penguin-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 2.4 MB

Release files / nonebot_plugin_penguin-0.1.0.tar.gz

Download URL nonebot_plugin_penguin-0.1.0.tar.gz
Size 1.2 MB
Tags Source
SHA-256 checksum
How to use checksums
8ec989a4007fb5cabd22b3f1eb8402a1c75c479ca7f98c2153ace62237a82888
BLAKE2b-256 checksum
How to use checksums
1ac38cf5b292b044d2d529860b0eab32223da6f78814d54fb58109a96a104811
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.5.1 CPython/3.10.12 Linux/5.15.0-1039-azure

Release files / nonebot_plugin_penguin-0.1.0-py3-none-any.whl

Download URL nonebot_plugin_penguin-0.1.0-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
10350e84293277384459aed126421f899e1040cedf32a8761afdc048d9b95653
BLAKE2b-256 checksum
How to use checksums
c24c53a00863b416aea8823f6b1b05db92812bac382ec60e722f55e571914e98
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.5.1 CPython/3.10.12 Linux/5.15.0-1039-azure

Security for nonebot-plugin-penguin 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page