nonebot-plugin-cs2match

✨ CS2赛事查询 ✨

📖 介绍

实时追踪 Counter-Strike 2 职业赛事，进行开赛自动提醒与大比分异动推送。

使用 nb-cli 安装

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

nb plugin install nonebot-plugin-cs2match

使用包管理器安装

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

pip

pip install nonebot-plugin-cs2match

pdm

pdm add nonebot-plugin-cs2match

poetry

poetry add nonebot-plugin-cs2match

conda

conda install nonebot-plugin-cs2match

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

plugins = ["nonebot_plugin_cs2match"]

下表中的配置可通过插件的config.py或 NoneBot 的.env提供

配置项	必配置	默认值	说明
pandascore_token	是	无	PandaScore提供商获取的Token
serie_rules	否	见文件	按照优先级给赛事系列排序（同时也是赛事系列白名单）
client_timeout	否	10	API调用客户端最大超时限制，单位为秒
cache_ttl	否	60	api请求临时缓存存活时间及比赛监视检测间隔时间，单位为秒
cache_max_size	否	64	API请求内存缓存中最多保留的条目数
match_page_size	否	100	比赛列表接口每页条数（PandaScore 上限为 100）
max_misses	否	3	连续多少轮“确证比赛已不存在”后自动取消监视。仅统计单场比赛接口明确返回 404 的轮次
render_cache_cleanup_interval	否	60	渲染缓存的后台清理间隔，单位为分钟
render_cache_renewal_duration	否	30	渲染缓存命中后的续期时长，单位为分钟

以上配置既可以在插件的config.py中修改，也可以通过 NoneBot 的.env提供（如CACHE_TTL=30）。

API 请求有内存级 TTL 缓存（cache_ttl 秒）与并发合并（同一请求只发一次），容量由 cache_max_size 限制。
渲染出的图片以内容哈希为键落盘缓存，命中时直接复用，不必重复调用 Typst 渲染。
落盘缓存按 render_cache_renewal_duration（分钟）续期，并每 render_cache_cleanup_interval（分钟）清理一次过期与失去元信息的孤儿文件；缓存目录由 nonebot_plugin_localstore 决定，删除该目录即可强制重新渲染。

监视目标的存活不依赖比赛列表的“第一页窗口”：列表里找不到时会按比赛 ID 直查单场比赛接口，只有接口明确返回 404（比赛确实不存在）才计入 max_misses；接口报错、限流、窗口滑动都不会导致监视被取消。
若比赛列表接口调用失败，本轮不判定任何目标消失，也不会误取消监视。
监视任务按 Bot 实例（self_id）隔离；单个 Bot 掉线只影响它自己，且任务异常退出后会记录原因并在下次 /monitor 时自动重启，不会再出现“监视静默停止”。

部分运行时配置（DynamicConfig）仅开放运行时修改，详情查阅指令表

指令	权限	需要@	范围	说明
`cs2help` / `cs2帮助`	所有人	否	任何	获取插件命令用法
`matches [past/running/upcoming]`	所有人	否	任何	比赛列表获取。`matches`可用`比赛列表`代替。
`match <slug/队名>`	所有人	否	任何	比赛大比分获取，支持直接输入战队名（同名多场时展示第一个并提示）。`match`可用`比分`代替。
`monitor <slug/队名>`	群管/SUPERUSER	否	群聊	追加监视比赛开始、大比分变动、结束，参数为“cancel”时取消本群全部监听。`monitor`可用`监视`代替。
`cs2whitelist <on/off>`	群管/SUPERUSER	否	任何	设置比赛列表是否仅显示白名单赛事系列。`cs2whitelist`可用`白名单`代替。
`cs2uid`	所有人	否	任何	查看自己的用户ID与当前场景ID。

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

Source distribution for nonebot-plugin-cs2match 1.2.1
File	Size	Uploaded
nonebot_plugin_cs2match-1.2.1.tar.gz	23.4 kB	Oct 4, 2026	Details

Table of built distributions (wheels) for nonebot-plugin-cs2match 1.2.1
File	Interpreter	ABI	Platform	Reset
nonebot_plugin_cs2match-1.2.1-py3-none-any.whl 28.3 kB Oct 4, 2026	Python 3	none	any	Details

Total release size: 51.7 kB

Download URL	nonebot_plugin_cs2match-1.2.1.tar.gz
Size	23.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`5bbb8db1090fc23e8de4597e37b087c5bfa1268ea0bc958c5412bec3b0df5383`
BLAKE2b-256 checksum How to use checksums	`afc429bc4a3e4924be9223cebaec79366f3ca2fd1582e2ec9ed1daa7d481c8a1`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Download URL	nonebot_plugin_cs2match-1.2.1-py3-none-any.whl
Size	28.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`09cae50670722053fa3799109049db95e43eeab97be2afc00b6107cb6d12db4f`
BLAKE2b-256 checksum How to use checksums	`c1042e83279bb4798abb2ac4b37b3151c60e336142d0b08077ed836f357d16ee`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`