这是一个简单插件，它可以从指定的UptimeKuma展示页面抓取消息并且发送出去。
📖 介绍
这个插件在触发指令时从指定UptimeKuma网站的指定状态页面抓取内容，返回各项在线情况并且写出钉选的通知
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-uptime-kuma-puller
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令pip
pip install nonebot-plugin-uptime-kuma-puller
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot-plugin-uptime-kuma-puller"]
⚙️ 配置
在 nonebot2 项目的.env文件中添加下表中的必填配置
| 配置项 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| upk__query_url | 是 | 无 | UptimeKuma 地址 |
| upk__proj_name_list | 是 | 无 | 需要监控的项目名称列表（需与 UptimeKuma 项目名称完全匹配） |
| upk__status_mapping | 否 | {0 : "🔴",1 : "🟢",2 : "🟡",3 : "🔵","unknow" : "❓"} | 状态标识 |
| upk__show_ping | 否 | True | 是否在结果中显示 Ping 测试结果 |
| upk__show_incident | 否 | True | 是否在结果中显示公告信息 |
| upk__error_prompt | 否 | 查询过程中发生错误，查询终止！ | 当发生致命错误时返回的提示信息（后附带错误信息） |
| upk__suggest_proj_prompt | 否 | 请选择需查项目 | 当未指定项目时，交互式选择的引导提示 |
| upk__no_arg_prompt | 否 | 由于用户未能提供有效参数，请重新触发指令 | 当参数缺失时返回的错误提示 |
| upk__incident_update_time_text | 否 | 🕰本通知更新于 | 公告信息中显示更新时间的前缀文本 |
| upk__show_incident_update_time | 否 | True | 是否在公告信息中显示最后更新时间 |
| upk__show_incident_type | 否 | True | 是否在公告信息中显示事故类型（如：信息/重要/危险） |
| upk__show_tags | 否 | True | 是否在结果中显示标签信息 |
| upk__show_maintenance | 否 | 是否显示维护信息 | |
| upk__timeout | 否 | 30 | 超时时间（单位：秒） |
| upk__retry | 否 | 0 | 询问参数失败时的重试次数 |
| upk__incident_type_trans | 否 | {"info":"信息","primary":"重要","danger":"危险"} |
事故类型映射表，用于将英文类型关键词转换为中文描述 |
| upk__maintenance_strategy_trans | 否 | {"single":"单一时间窗口","manual":"手动","cron":"命令调度"} |
维护策略类型映射表，用于将英文类型关键词转换为中文描述 |
| upk__maintenance_time_template_list | 否 | {"cron":"\n⊢${cron} 周期${duration}分钟（每${interval_day}天一次）\n⊢时区 ${timezone} ${timezone_offset}"} |
维护策略描述模板映射表，支持变量替换 |
| upk__query_template | 否 | ***${title}***\n统计：${status_statistics_msg}\n${ping_statistics_msg}\n------${maintenance_msg}\n------\n${proj_msg}\n${incident_msg}\n******${took_time} |
查询结果模板，支持变量替换 |
| upk__maintenance_template | 否 | ⚠️🔵ID${id} ${title}（${strategy}）\n⊢${description}${maintenance_time} |
否 |
| upk__incident_template | 否 | ————\n📣${incident_style}${title}\n${content}${incident_update_time_ret}\n———— |
公告信息模板，支持变量替换 |
| upk__status_statistics_template | 否 | ${icon}:${number} |
状态统计模板，支持变量替换 |
| upk__ping_statistics_template | 否 | 最大${max}ms 最小${min}ms 平均${argv}ms |
PING统计模板，支持变量替换 |
| upk__ava_template | 否 | 目前支持查询项目的有：${list} |
可用项查询模版，支持变量 |
🎉 使用
指令表
| 指令 | 权限 | 需要@ | 范围 | 说明 |
|---|---|---|---|---|
| /健康 需查询项目 | 任何人 | 否 | 私聊&群聊 | 别名/uptime、/ukp |
效果图
暂无
🗺️Roadmap路线图
- 永不收费永不分版本
- 支持核心指令查询功能
- 支持配置文件配置目标站点
- 上架Nonebot商店
- 用指令更改设置
- 重构优化，解耦代码
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-uptime-kuma-puller 0.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nonebot_plugin_uptime_kuma_puller-0.2.4.tar.gz | 9.3 kB | With provenance | Details for nonebot_plugin_uptime_kuma_puller-0.2.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nonebot_plugin_uptime_kuma_puller-0.2.4-py3-none-any.whl | Python 3 | none | any | Details for nonebot_plugin_uptime_kuma_puller-0.2.4-py3-none-any.whl |
Total release size: 19.6 kB
Release files / nonebot_plugin_uptime_kuma_puller-0.2.4.tar.gz
| Download URL | nonebot_plugin_uptime_kuma_puller-0.2.4.tar.gz |
|---|---|
| Size | 9.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
92a46a84190737ff3c2048fd7c0cdd5998d128f8bbffc90988696306408fef7a
|
|
BLAKE2b-256 checksum How to use checksums |
95706ce9104211f75c1c7535f369e0f2d357deba15098bcf04ce46aa86eff1e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 27, 2025.
Transparency logRelease files / nonebot_plugin_uptime_kuma_puller-0.2.4-py3-none-any.whl
| Download URL | nonebot_plugin_uptime_kuma_puller-0.2.4-py3-none-any.whl |
|---|---|
| Size | 10.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2cfb99c10ebc92066a1192fc5898704c8a417fb8dec31746dd9d2e460a18163a
|
|
BLAKE2b-256 checksum How to use checksums |
87bd364ab821bb40b361c0687fa9602c31577d755b9574654bc49c7abf870b17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 27, 2025.
Transparency logSecurity for nonebot-plugin-uptime-kuma-puller 0.2.4
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for nonebot_plugin_uptime_kuma_puller-0.2.4.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 27, 2025.
Transparency logA 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.
