nonebot-plugin-ccb 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,42 @@
1
+ name: Publish to PyPI
2
+
3
+ # 推送 v* 標籤(例如 v0.1.0)時自動建置並發布到 PyPI。
4
+ # 使用 PyPI Trusted Publishing(OIDC),不需要在倉庫裡存 PyPI token。
5
+
6
+ on:
7
+ push:
8
+ tags:
9
+ - "v*"
10
+
11
+ jobs:
12
+ publish:
13
+ runs-on: ubuntu-latest
14
+ environment:
15
+ name: pypi
16
+ url: https://pypi.org/p/nonebot-plugin-ccb
17
+ permissions:
18
+ id-token: write # Trusted Publishing 需要
19
+ contents: write # 建立 GitHub Release 需要
20
+ steps:
21
+ - uses: actions/checkout@v4
22
+
23
+ - uses: astral-sh/setup-uv@v6
24
+
25
+ - name: Check tag matches pyproject version
26
+ run: |
27
+ version=$(uv version --short)
28
+ if [ "v${version}" != "${GITHUB_REF_NAME}" ]; then
29
+ echo "::error::tag ${GITHUB_REF_NAME} 和 pyproject.toml 版本 ${version} 不一致"
30
+ exit 1
31
+ fi
32
+
33
+ - name: Build
34
+ run: uv build
35
+
36
+ - name: Publish to PyPI
37
+ uses: pypa/gh-action-pypi-publish@release/v1
38
+
39
+ - name: Create GitHub Release
40
+ env:
41
+ GH_TOKEN: ${{ github.token }}
42
+ run: gh release create "${GITHUB_REF_NAME}" dist/* --title "${GITHUB_REF_NAME}" --generate-notes
@@ -0,0 +1,12 @@
1
+ __pycache__/
2
+ *.py[cod]
3
+ .venv/
4
+ dist/
5
+ build/
6
+ *.egg-info/
7
+ .env
8
+ .env.*
9
+ data/
10
+ .DS_Store
11
+ .idea/
12
+ .vscode/
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 zebwqfox
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,184 @@
1
+ Metadata-Version: 2.5
2
+ Name: nonebot-plugin-ccb
3
+ Version: 0.1.0
4
+ Summary: 和群友发生赛博ccb行为的 NoneBot2 群娱乐插件
5
+ Project-URL: Homepage, https://github.com/zebwqfox/nonebot-plugin-ccb
6
+ Project-URL: Issues, https://github.com/zebwqfox/nonebot-plugin-ccb/issues
7
+ Author: zebwqfox
8
+ License-Expression: MIT
9
+ License-File: LICENSE
10
+ Keywords: ccb,nonebot,nonebot2,onebot,qq
11
+ Classifier: Framework :: AsyncIO
12
+ Classifier: Operating System :: OS Independent
13
+ Classifier: Programming Language :: Python :: 3
14
+ Requires-Python: <4.0,>=3.10
15
+ Requires-Dist: nonebot-adapter-onebot>=2.4.0
16
+ Requires-Dist: nonebot-plugin-localstore>=0.7.0
17
+ Requires-Dist: nonebot2>=2.4.0
18
+ Requires-Dist: pydantic>=1.10
19
+ Description-Content-Type: text/markdown
20
+
21
+ <div align="center">
22
+ <a href="https://nonebot.dev/store/plugins"><img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo"></a>
23
+ <br>
24
+ <p><img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/NoneBotPlugin.svg" width="240" alt="NoneBotPluginText"></p>
25
+ </div>
26
+
27
+ <div align="center">
28
+
29
+ # nonebot-plugin-ccb
30
+
31
+ _✨ 和群友发生赛博 ccb 行为的群娱乐插件 ✨_
32
+
33
+ <a href="./LICENSE">
34
+ <img src="https://img.shields.io/github/license/zebwqfox/nonebot-plugin-ccb.svg" alt="license">
35
+ </a>
36
+ <a href="https://pypi.python.org/pypi/nonebot-plugin-ccb">
37
+ <img src="https://img.shields.io/pypi/v/nonebot-plugin-ccb.svg" alt="pypi">
38
+ </a>
39
+ <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
40
+ <a href="https://nonebot.dev/">
41
+ <img src="https://img.shields.io/badge/nonebot-2.4.0+-red.svg" alt="nonebot2">
42
+ </a>
43
+ <a href="https://onebot.dev/">
44
+ <img src="https://img.shields.io/badge/OneBot-v11-black.svg" alt="onebot">
45
+ </a>
46
+
47
+ </div>
48
+
49
+ > [!WARNING]
50
+ > 本插件文案含成人向玩笑,请只在成员都能接受的群里启用(可以用 `CCB_GROUPS` 限定群)。群友随时可以用 `ccbnodo` 拒绝被 ccb。
51
+
52
+ ## 📖 介绍
53
+
54
+ 在群里 `ccb @某人`,机器人会随机生成这次 ccb 的时长和「生命因子」注入量,并记录到本群的数据里。
55
+
56
+ - 🎲 **随机结果**:时长、注入量随机生成,10% 概率暴击,注入量翻倍
57
+ - 💥 **炸膛机制**:短时间内连续 ccb,炸膛概率会越来越高,炸膛后需要冷却一段时间
58
+ - 📊 **数据统计**:按群分别记录被 ccb / 主动 ccb 的次数、累计注入量、单次最高,附带排行榜
59
+ - 🛡️ **防 ccb 开关**:开启后别人无法 @ 你,随机挑人时也会跳过你
60
+ - ⌨️ **指令免前缀**:`ccb @某人` 和 `/ccb @某人` 都能触发,`ccbxyz`、`今天ccb` 这类普通聊天不会误触发
61
+
62
+ 玩法参考自 AstrBot 的 [astrbot_plugin_ccb](https://github.com/tenno1174/astrbot_plugin_ccb) 及其增强版 [astrbot_plugin_ccb_plus](https://github.com/Koikokokokoro/astrbot_plugin_ccb_plus),本插件为 NoneBot2 重新实现。
63
+
64
+ ## 💿 安装
65
+
66
+ <details open>
67
+ <summary>使用 nb-cli 安装</summary>
68
+ 在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
69
+
70
+ nb plugin install nonebot-plugin-ccb
71
+
72
+ </details>
73
+
74
+ <details>
75
+ <summary>使用包管理器安装</summary>
76
+ 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
77
+
78
+ <details>
79
+ <summary>uv</summary>
80
+
81
+ uv add nonebot-plugin-ccb
82
+ </details>
83
+ <details>
84
+ <summary>pip</summary>
85
+
86
+ pip install nonebot-plugin-ccb
87
+ </details>
88
+ <details>
89
+ <summary>pdm</summary>
90
+
91
+ pdm add nonebot-plugin-ccb
92
+ </details>
93
+ <details>
94
+ <summary>poetry</summary>
95
+
96
+ poetry add nonebot-plugin-ccb
97
+ </details>
98
+
99
+ 打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入
100
+
101
+ plugins = ["nonebot_plugin_ccb"]
102
+
103
+ </details>
104
+
105
+ <details>
106
+ <summary>从 GitHub 安装(最新开发版)</summary>
107
+
108
+ pip install git+https://github.com/zebwqfox/nonebot-plugin-ccb.git
109
+
110
+ </details>
111
+
112
+ ## ⚙️ 配置
113
+
114
+ 在 nonebot2 项目的 `.env` 文件中按需添加下表中的配置,全部为选填
115
+
116
+ | 配置项 | 必填 | 默认值 | 说明 |
117
+ |:-----:|:----:|:----:|:----|
118
+ | `CCB_GROUPS` | 否 | `[]` | 允许使用的群号列表,留空表示所有群 |
119
+ | `CCB_NAME` | 否 | `"ccb"` | 文案里的代号,同时也是指令名 |
120
+ | `CCB_SHOW_AVATAR` | 否 | `true` | 回复时附上对方头像 |
121
+ | `CCB_REQUIRE_SLASH` | 否 | `false` | 设为 `true` 时必须加命令前缀 `/` 才能触发 |
122
+ | `CCB_CRIT_CHANCE` | 否 | `0.1` | 暴击概率 |
123
+ | `CCB_BURST_WINDOW` | 否 | `1800` | 统计连续次数的时间窗(秒) |
124
+ | `CCB_BURST_STEP` | 否 | `0.08` | 时间窗内每多 ccb 一次,炸膛概率增加多少 |
125
+ | `CCB_BURST_MAX` | 否 | `0.6` | 炸膛概率上限 |
126
+ | `CCB_BURST_COOLDOWN` | 否 | `600` | 炸膛后的冷却时间(秒) |
127
+
128
+ <details>
129
+ <summary>配置示例</summary>
130
+
131
+ ```dotenv
132
+ # 只在这两个群启用
133
+ CCB_GROUPS=[123456789, 987654321]
134
+ # 关闭头像,减少刷屏
135
+ CCB_SHOW_AVATAR=false
136
+ # 炸膛后冷却 5 分钟
137
+ CCB_BURST_COOLDOWN=300
138
+ ```
139
+
140
+ </details>
141
+
142
+ ## 🎉 使用
143
+
144
+ ### 指令表
145
+
146
+ 指令前面加不加 `/` 都可以(可用 `CCB_REQUIRE_SLASH` 改为必须加)。
147
+
148
+ | 指令 | 权限 | 需要@ | 范围 | 说明 |
149
+ |:-----:|:----:|:----:|:----:|:----|
150
+ | `ccb [@某人]` | 群员 | 否 | 群聊 | 对 ta ccb,不 @ 就随机挑一位群友。别名:`踩踩背`、`捶捶背` |
151
+ | `ccb查询 [@某人]` | 群员 | 否 | 群聊 | 查看被 ccb / 主动 ccb 的次数、注入量和单次最高,不 @ 就查自己 |
152
+ | `ccb排行 [次数\|注入\|主动]` | 群员 | 否 | 群聊 | 本群排行榜,默认按被 ccb 次数 |
153
+ | `ccbnodo` | 群员 | 否 | 群聊 | 开关自己的防 ccb。别名:`防ccb` |
154
+ | `ccbclear` | 群主 / 管理员 / 超级用户 | 否 | 群聊 | 清空本群记录,防 ccb 设置会保留 |
155
+
156
+ > 表中「需要@」指是否需要 @ 机器人;`ccb` 后面的 `@某人` 是指定对象,可以省略。
157
+
158
+ ### 效果图
159
+
160
+ ```text
161
+ 你和某某发生了35.26min长的ccb行为,向ta注入了16.71ml的生命因子
162
+ [对方头像]
163
+ 这是ta的第626次。
164
+ ```
165
+
166
+ ```text
167
+ 💥你炸膛了!不能ccb了(悲)
168
+ 10 分钟后才能恢复
169
+ ```
170
+
171
+ ```text
172
+ 🏆 本群被ccb次数排行
173
+ 🥇 群友A:12次
174
+ 🥈 群友B:9次
175
+ 🥉 群友C:5次
176
+ ```
177
+
178
+ ## 📦 数据存储
179
+
180
+ 记录保存在 [nonebot-plugin-localstore](https://github.com/nonebot/plugin-localstore) 提供的插件数据目录下的 `ccb.json`,按群分开存放。炸膛冷却只保存在内存中,重启后会清空。
181
+
182
+ ## 📄 许可
183
+
184
+ 本项目使用 [MIT](./LICENSE) 许可证。
@@ -0,0 +1,164 @@
1
+ <div align="center">
2
+ <a href="https://nonebot.dev/store/plugins"><img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo"></a>
3
+ <br>
4
+ <p><img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/NoneBotPlugin.svg" width="240" alt="NoneBotPluginText"></p>
5
+ </div>
6
+
7
+ <div align="center">
8
+
9
+ # nonebot-plugin-ccb
10
+
11
+ _✨ 和群友发生赛博 ccb 行为的群娱乐插件 ✨_
12
+
13
+ <a href="./LICENSE">
14
+ <img src="https://img.shields.io/github/license/zebwqfox/nonebot-plugin-ccb.svg" alt="license">
15
+ </a>
16
+ <a href="https://pypi.python.org/pypi/nonebot-plugin-ccb">
17
+ <img src="https://img.shields.io/pypi/v/nonebot-plugin-ccb.svg" alt="pypi">
18
+ </a>
19
+ <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
20
+ <a href="https://nonebot.dev/">
21
+ <img src="https://img.shields.io/badge/nonebot-2.4.0+-red.svg" alt="nonebot2">
22
+ </a>
23
+ <a href="https://onebot.dev/">
24
+ <img src="https://img.shields.io/badge/OneBot-v11-black.svg" alt="onebot">
25
+ </a>
26
+
27
+ </div>
28
+
29
+ > [!WARNING]
30
+ > 本插件文案含成人向玩笑,请只在成员都能接受的群里启用(可以用 `CCB_GROUPS` 限定群)。群友随时可以用 `ccbnodo` 拒绝被 ccb。
31
+
32
+ ## 📖 介绍
33
+
34
+ 在群里 `ccb @某人`,机器人会随机生成这次 ccb 的时长和「生命因子」注入量,并记录到本群的数据里。
35
+
36
+ - 🎲 **随机结果**:时长、注入量随机生成,10% 概率暴击,注入量翻倍
37
+ - 💥 **炸膛机制**:短时间内连续 ccb,炸膛概率会越来越高,炸膛后需要冷却一段时间
38
+ - 📊 **数据统计**:按群分别记录被 ccb / 主动 ccb 的次数、累计注入量、单次最高,附带排行榜
39
+ - 🛡️ **防 ccb 开关**:开启后别人无法 @ 你,随机挑人时也会跳过你
40
+ - ⌨️ **指令免前缀**:`ccb @某人` 和 `/ccb @某人` 都能触发,`ccbxyz`、`今天ccb` 这类普通聊天不会误触发
41
+
42
+ 玩法参考自 AstrBot 的 [astrbot_plugin_ccb](https://github.com/tenno1174/astrbot_plugin_ccb) 及其增强版 [astrbot_plugin_ccb_plus](https://github.com/Koikokokokoro/astrbot_plugin_ccb_plus),本插件为 NoneBot2 重新实现。
43
+
44
+ ## 💿 安装
45
+
46
+ <details open>
47
+ <summary>使用 nb-cli 安装</summary>
48
+ 在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
49
+
50
+ nb plugin install nonebot-plugin-ccb
51
+
52
+ </details>
53
+
54
+ <details>
55
+ <summary>使用包管理器安装</summary>
56
+ 在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
57
+
58
+ <details>
59
+ <summary>uv</summary>
60
+
61
+ uv add nonebot-plugin-ccb
62
+ </details>
63
+ <details>
64
+ <summary>pip</summary>
65
+
66
+ pip install nonebot-plugin-ccb
67
+ </details>
68
+ <details>
69
+ <summary>pdm</summary>
70
+
71
+ pdm add nonebot-plugin-ccb
72
+ </details>
73
+ <details>
74
+ <summary>poetry</summary>
75
+
76
+ poetry add nonebot-plugin-ccb
77
+ </details>
78
+
79
+ 打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入
80
+
81
+ plugins = ["nonebot_plugin_ccb"]
82
+
83
+ </details>
84
+
85
+ <details>
86
+ <summary>从 GitHub 安装(最新开发版)</summary>
87
+
88
+ pip install git+https://github.com/zebwqfox/nonebot-plugin-ccb.git
89
+
90
+ </details>
91
+
92
+ ## ⚙️ 配置
93
+
94
+ 在 nonebot2 项目的 `.env` 文件中按需添加下表中的配置,全部为选填
95
+
96
+ | 配置项 | 必填 | 默认值 | 说明 |
97
+ |:-----:|:----:|:----:|:----|
98
+ | `CCB_GROUPS` | 否 | `[]` | 允许使用的群号列表,留空表示所有群 |
99
+ | `CCB_NAME` | 否 | `"ccb"` | 文案里的代号,同时也是指令名 |
100
+ | `CCB_SHOW_AVATAR` | 否 | `true` | 回复时附上对方头像 |
101
+ | `CCB_REQUIRE_SLASH` | 否 | `false` | 设为 `true` 时必须加命令前缀 `/` 才能触发 |
102
+ | `CCB_CRIT_CHANCE` | 否 | `0.1` | 暴击概率 |
103
+ | `CCB_BURST_WINDOW` | 否 | `1800` | 统计连续次数的时间窗(秒) |
104
+ | `CCB_BURST_STEP` | 否 | `0.08` | 时间窗内每多 ccb 一次,炸膛概率增加多少 |
105
+ | `CCB_BURST_MAX` | 否 | `0.6` | 炸膛概率上限 |
106
+ | `CCB_BURST_COOLDOWN` | 否 | `600` | 炸膛后的冷却时间(秒) |
107
+
108
+ <details>
109
+ <summary>配置示例</summary>
110
+
111
+ ```dotenv
112
+ # 只在这两个群启用
113
+ CCB_GROUPS=[123456789, 987654321]
114
+ # 关闭头像,减少刷屏
115
+ CCB_SHOW_AVATAR=false
116
+ # 炸膛后冷却 5 分钟
117
+ CCB_BURST_COOLDOWN=300
118
+ ```
119
+
120
+ </details>
121
+
122
+ ## 🎉 使用
123
+
124
+ ### 指令表
125
+
126
+ 指令前面加不加 `/` 都可以(可用 `CCB_REQUIRE_SLASH` 改为必须加)。
127
+
128
+ | 指令 | 权限 | 需要@ | 范围 | 说明 |
129
+ |:-----:|:----:|:----:|:----:|:----|
130
+ | `ccb [@某人]` | 群员 | 否 | 群聊 | 对 ta ccb,不 @ 就随机挑一位群友。别名:`踩踩背`、`捶捶背` |
131
+ | `ccb查询 [@某人]` | 群员 | 否 | 群聊 | 查看被 ccb / 主动 ccb 的次数、注入量和单次最高,不 @ 就查自己 |
132
+ | `ccb排行 [次数\|注入\|主动]` | 群员 | 否 | 群聊 | 本群排行榜,默认按被 ccb 次数 |
133
+ | `ccbnodo` | 群员 | 否 | 群聊 | 开关自己的防 ccb。别名:`防ccb` |
134
+ | `ccbclear` | 群主 / 管理员 / 超级用户 | 否 | 群聊 | 清空本群记录,防 ccb 设置会保留 |
135
+
136
+ > 表中「需要@」指是否需要 @ 机器人;`ccb` 后面的 `@某人` 是指定对象,可以省略。
137
+
138
+ ### 效果图
139
+
140
+ ```text
141
+ 你和某某发生了35.26min长的ccb行为,向ta注入了16.71ml的生命因子
142
+ [对方头像]
143
+ 这是ta的第626次。
144
+ ```
145
+
146
+ ```text
147
+ 💥你炸膛了!不能ccb了(悲)
148
+ 10 分钟后才能恢复
149
+ ```
150
+
151
+ ```text
152
+ 🏆 本群被ccb次数排行
153
+ 🥇 群友A:12次
154
+ 🥈 群友B:9次
155
+ 🥉 群友C:5次
156
+ ```
157
+
158
+ ## 📦 数据存储
159
+
160
+ 记录保存在 [nonebot-plugin-localstore](https://github.com/nonebot/plugin-localstore) 提供的插件数据目录下的 `ccb.json`,按群分开存放。炸膛冷却只保存在内存中,重启后会清空。
161
+
162
+ ## 📄 许可
163
+
164
+ 本项目使用 [MIT](./LICENSE) 许可证。
@@ -0,0 +1,233 @@
1
+ """群娛樂:和群友發生賽博 ccb 行為(NoneBot 版,功能參考 AstrBot 的 ccb / ccb_plus)。
2
+
3
+ 指令前面的 / 可加可不加:`ccb @某人` 和 `/ccb @某人` 都能觸發。
4
+ """
5
+
6
+ from __future__ import annotations
7
+
8
+ import random
9
+
10
+ from nonebot import get_plugin_config, on_message, require
11
+ from nonebot.adapters.onebot.v11 import (
12
+ Bot,
13
+ GroupMessageEvent,
14
+ Message,
15
+ MessageSegment,
16
+ )
17
+ from nonebot.adapters.onebot.v11.permission import GROUP_ADMIN, GROUP_OWNER
18
+ from nonebot.permission import SUPERUSER
19
+ from nonebot.plugin import PluginMetadata
20
+ from nonebot.rule import Rule
21
+ from nonebot.typing import T_State
22
+ from pydantic import BaseModel
23
+
24
+ require("nonebot_plugin_localstore")
25
+ import nonebot_plugin_localstore as store
26
+
27
+ from .data import CcbStore, Rules
28
+ from .match import match_command
29
+
30
+
31
+ class Config(BaseModel):
32
+ ccb_groups: list[int] = []
33
+ """允許使用的群,留空表示所有群。"""
34
+ ccb_name: str = "ccb"
35
+ """文案裡的代號,也是指令名。"""
36
+ ccb_show_avatar: bool = True
37
+ """回覆時附上對方頭像。"""
38
+ ccb_require_slash: bool = False
39
+ """true 時必須用 /ccb 觸發;預設 ccb 和 /ccb 都可以。"""
40
+ ccb_crit_chance: float = 0.1
41
+ ccb_burst_step: float = 0.08
42
+ ccb_burst_max: float = 0.6
43
+ ccb_burst_window: int = 1800
44
+ ccb_burst_cooldown: int = 600
45
+
46
+
47
+ config = get_plugin_config(Config)
48
+ N = config.ccb_name
49
+
50
+ __plugin_meta__ = PluginMetadata(
51
+ name="ccb",
52
+ description="和群友发生赛博ccb行为",
53
+ usage=(
54
+ f"{N} [@某人]:对 ta {N},不 @ 就随机挑一位群友\n"
55
+ f"{N}查询 [@某人]:查看记录\n"
56
+ f"{N}排行 [注入|主动]:群排行榜\n"
57
+ f"{N}nodo:开关防{N}(开启后别人不能对你{N})\n"
58
+ f"{N}clear:清空本群记录(群管理)\n"
59
+ "以上指令前面加不加 / 都可以"
60
+ ),
61
+ type="application",
62
+ homepage="https://github.com/zebwqfox/nonebot-plugin-ccb",
63
+ config=Config,
64
+ supported_adapters={"~onebot.v11"},
65
+ )
66
+
67
+ ccb_store = CcbStore(
68
+ store.get_plugin_data_file("ccb.json"),
69
+ Rules(
70
+ crit_chance=config.ccb_crit_chance,
71
+ burst_step=config.ccb_burst_step,
72
+ burst_max=config.ccb_burst_max,
73
+ burst_window=config.ccb_burst_window,
74
+ burst_cooldown=config.ccb_burst_cooldown,
75
+ ),
76
+ )
77
+
78
+
79
+ def command(*names: str) -> Rule:
80
+ """群訊息以指令名開頭(可選 / 前綴)時觸發,剩下的文字放進 state["arg"]。"""
81
+
82
+ async def _rule(event: GroupMessageEvent, state: T_State) -> bool:
83
+ if config.ccb_groups and event.group_id not in config.ccb_groups:
84
+ return False
85
+ arg = match_command(
86
+ event.message.extract_plain_text(), names, require_slash=config.ccb_require_slash
87
+ )
88
+ if arg is None:
89
+ return False
90
+ state["arg"] = arg
91
+ return True
92
+
93
+ return Rule(_rule)
94
+
95
+
96
+ def _target_from(event: GroupMessageEvent, arg: str) -> int | None:
97
+ """從 @ 或純數字參數取得目標 QQ。"""
98
+ for seg in event.message:
99
+ if seg.type == "at" and str(seg.data.get("qq")) not in ("all", str(event.self_id)):
100
+ return int(seg.data["qq"])
101
+ return int(arg) if arg.isdigit() else None
102
+
103
+
104
+ async def _name(bot: Bot, gid: int, uid: int) -> str:
105
+ try:
106
+ info = await bot.get_group_member_info(group_id=gid, user_id=uid)
107
+ return info.get("card") or info.get("nickname") or str(uid)
108
+ except Exception:
109
+ return str(uid)
110
+
111
+
112
+ def _avatar(uid: int | str) -> MessageSegment:
113
+ return MessageSegment.image(f"https://q1.qlogo.cn/g?b=qq&nk={uid}&s=640")
114
+
115
+
116
+ ccb = on_message(rule=command(N, "踩踩背", "捶捶背"), priority=10, block=True)
117
+
118
+
119
+ @ccb.handle()
120
+ async def _ccb(bot: Bot, event: GroupMessageEvent, state: T_State) -> None:
121
+ arg: str = state["arg"]
122
+ gid, uid = event.group_id, event.user_id
123
+
124
+ left = ccb_store.cooldown_left(gid, uid)
125
+ if left > 0:
126
+ await ccb.finish(f"💥你炸膛了!不能{N}了(悲)还要 {max(1, round(left / 60))} 分钟才能恢复")
127
+
128
+ target = _target_from(event, arg)
129
+ if target is None:
130
+ members = await bot.get_group_member_list(group_id=gid)
131
+ pool = [
132
+ m["user_id"]
133
+ for m in members
134
+ if m["user_id"] not in (uid, event.self_id) and not ccb_store.is_nodo(gid, m["user_id"])
135
+ ]
136
+ if not pool:
137
+ await ccb.finish(f"群里没有可以{N}的人了(悲)")
138
+ target = random.choice(pool)
139
+ elif target == uid:
140
+ await ccb.finish(f"不能对自己{N}哦")
141
+ elif ccb_store.is_nodo(gid, target):
142
+ await ccb.finish(f"ta 开启了防{N},换个人吧")
143
+
144
+ if ccb_store.roll_burst(gid, uid):
145
+ await ccb.finish(
146
+ f"💥你炸膛了!不能{N}了(悲)\n"
147
+ f"{config.ccb_burst_cooldown // 60} 分钟后才能恢复"
148
+ )
149
+
150
+ target_name = await _name(bot, gid, target)
151
+ my_name = event.sender.card or event.sender.nickname or str(uid)
152
+ r = ccb_store.do_ccb(gid, uid, my_name, target, target_name)
153
+
154
+ vol = f" 💥 暴击!{r.ml:.2f}" if r.crit else f"{r.ml:.2f}"
155
+ msg = Message(f"你和{target_name}发生了{r.minutes:.2f}min长的{N}行为,向ta注入了{vol}ml的生命因子")
156
+ if config.ccb_show_avatar:
157
+ msg += _avatar(target)
158
+ else:
159
+ msg += "\n"
160
+ msg += f"这是ta的第{r.target_count}次。"
161
+ await ccb.finish(msg)
162
+
163
+
164
+ query = on_message(rule=command(f"{N}查询", f"{N}记录"), priority=9, block=True)
165
+
166
+
167
+ @query.handle()
168
+ async def _query(bot: Bot, event: GroupMessageEvent, state: T_State) -> None:
169
+ arg: str = state["arg"]
170
+ gid = event.group_id
171
+ target = _target_from(event, arg) or event.user_id
172
+ s = ccb_store.stats(gid, target)
173
+ name = await _name(bot, gid, target)
174
+ if not s:
175
+ await query.finish(f"{name} 还没有任何{N}记录")
176
+ lines = [
177
+ f"📋 {name} 的{N}记录",
178
+ f"被{N}:{s['received']} 次,累计被注入 {s['received_ml']:.2f}ml",
179
+ f"主动{N}:{s['given']} 次,累计注入 {s['given_ml']:.2f}ml",
180
+ f"单次最高注入:{s['max_ml']:.2f}ml",
181
+ ]
182
+ if ccb_store.is_nodo(gid, target):
183
+ lines.append(f"🛡️ 已开启防{N}")
184
+ await query.finish("\n".join(lines))
185
+
186
+
187
+ RANK_KEYS = {
188
+ "": ("received", "被{N}次数", "次"),
189
+ "次数": ("received", "被{N}次数", "次"),
190
+ "注入": ("received_ml", "被注入量", "ml"),
191
+ "主动": ("given", "主动{N}次数", "次"),
192
+ }
193
+
194
+ rank = on_message(rule=command(f"{N}排行", f"{N}榜", f"{N}top"), priority=9, block=True)
195
+
196
+
197
+ @rank.handle()
198
+ async def _rank(event: GroupMessageEvent, state: T_State) -> None:
199
+ arg: str = state["arg"]
200
+ key, title, unit = RANK_KEYS.get(arg, RANK_KEYS[""])
201
+ rows = ccb_store.ranking(event.group_id, key)
202
+ if not rows:
203
+ await rank.finish(f"本群还没有{N}记录")
204
+ medals = ["🥇", "🥈", "🥉"]
205
+ lines = [f"🏆 本群{title.format(N=N)}排行"]
206
+ for i, (_, s) in enumerate(rows):
207
+ mark = medals[i] if i < len(medals) else f"{i + 1}."
208
+ value = f"{s[key]:.2f}" if unit == "ml" else str(s[key])
209
+ lines.append(f"{mark} {s['name']}:{value}{unit}")
210
+ await rank.finish("\n".join(lines))
211
+
212
+
213
+ nodo = on_message(rule=command(f"{N}nodo", f"防{N}"), priority=9, block=True)
214
+
215
+
216
+ @nodo.handle()
217
+ async def _nodo(event: GroupMessageEvent) -> None:
218
+ on = ccb_store.toggle_nodo(event.group_id, event.user_id)
219
+ await nodo.finish(f"🛡️ 已开启防{N},别人不能对你{N}了" if on else f"已关闭防{N}")
220
+
221
+
222
+ clear = on_message(
223
+ rule=command(f"{N}clear"),
224
+ permission=SUPERUSER | GROUP_ADMIN | GROUP_OWNER,
225
+ priority=9,
226
+ block=True,
227
+ )
228
+
229
+
230
+ @clear.handle()
231
+ async def _clear(event: GroupMessageEvent) -> None:
232
+ ccb_store.clear(event.group_id)
233
+ await clear.finish(f"已清空本群的{N}记录(防{N}设置保留)")
@@ -0,0 +1,168 @@
1
+ """ccb 紀錄的存取與遊戲邏輯(不依賴 NoneBot,可單獨測試)。"""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ import random
7
+ import time
8
+ from dataclasses import dataclass
9
+ from pathlib import Path
10
+ from typing import Any
11
+
12
+
13
+ @dataclass
14
+ class Rules:
15
+ min_minutes: float = 1.0
16
+ max_minutes: float = 60.0
17
+ min_ml: float = 1.0
18
+ max_ml: float = 20.0
19
+ crit_chance: float = 0.1
20
+ """暴擊機率,暴擊時注入量翻倍。"""
21
+ burst_window: int = 1800
22
+ """統計連續 ccb 次數的時間窗(秒)。"""
23
+ burst_step: float = 0.08
24
+ """時間窗內每多 ccb 一次,炸膛機率增加多少。"""
25
+ burst_max: float = 0.6
26
+ burst_cooldown: int = 600
27
+ """炸膛後多久不能 ccb(秒)。"""
28
+
29
+
30
+ @dataclass
31
+ class Outcome:
32
+ minutes: float
33
+ ml: float
34
+ crit: bool
35
+ target_count: int
36
+ target_total: float
37
+
38
+
39
+ class CcbStore:
40
+ """按群儲存紀錄:{group: {"users": {uid: stats}, "nodo": [uid]}}。"""
41
+
42
+ def __init__(self, path: Path, rules: Rules | None = None) -> None:
43
+ self.path = path
44
+ self.rules = rules or Rules()
45
+ self.data: dict[str, Any] = {}
46
+ # 只存在記憶體:{(group, uid): [timestamps]} 與 {(group, uid): 冷卻結束時間}
47
+ self._recent: dict[tuple[str, str], list[float]] = {}
48
+ self._cooldown: dict[tuple[str, str], float] = {}
49
+ self.load()
50
+
51
+ # ---- 持久化 ----
52
+ def load(self) -> None:
53
+ try:
54
+ self.data = json.loads(self.path.read_text("utf-8"))
55
+ except FileNotFoundError:
56
+ self.data = {}
57
+
58
+ def save(self) -> None:
59
+ tmp = self.path.with_suffix(".tmp")
60
+ tmp.write_text(json.dumps(self.data, ensure_ascii=False, indent=1), "utf-8")
61
+ tmp.replace(self.path)
62
+
63
+ def _group(self, gid: int | str) -> dict[str, Any]:
64
+ return self.data.setdefault(str(gid), {"users": {}, "nodo": []})
65
+
66
+ def _user(self, gid: int | str, uid: int | str) -> dict[str, Any]:
67
+ users = self._group(gid)["users"]
68
+ return users.setdefault(
69
+ str(uid),
70
+ {
71
+ "name": str(uid),
72
+ "received": 0, # 被 ccb 次數
73
+ "received_ml": 0.0, # 被注入總量
74
+ "given": 0, # 主動 ccb 次數
75
+ "given_ml": 0.0, # 主動注入總量
76
+ "max_ml": 0.0, # 單次最大注入量
77
+ },
78
+ )
79
+
80
+ # ---- 防 ccb 開關 ----
81
+ def is_nodo(self, gid: int | str, uid: int | str) -> bool:
82
+ return str(uid) in self._group(gid)["nodo"]
83
+
84
+ def toggle_nodo(self, gid: int | str, uid: int | str) -> bool:
85
+ """切換防 ccb,回傳切換後是否開啟。"""
86
+ nodo: list[str] = self._group(gid)["nodo"]
87
+ if str(uid) in nodo:
88
+ nodo.remove(str(uid))
89
+ on = False
90
+ else:
91
+ nodo.append(str(uid))
92
+ on = True
93
+ self.save()
94
+ return on
95
+
96
+ # ---- 炸膛冷卻 ----
97
+ def cooldown_left(self, gid: int | str, uid: int | str, now: float | None = None) -> float:
98
+ now = time.time() if now is None else now
99
+ return max(0.0, self._cooldown.get((str(gid), str(uid)), 0.0) - now)
100
+
101
+ def roll_burst(
102
+ self, gid: int | str, uid: int | str, rng: random.Random | None = None,
103
+ now: float | None = None,
104
+ ) -> bool:
105
+ """這次出手前判定是否炸膛;炸膛就進入冷卻並清空連續次數。"""
106
+ rng = rng or random
107
+ now = time.time() if now is None else now
108
+ key = (str(gid), str(uid))
109
+ recent = [t for t in self._recent.get(key, []) if now - t < self.rules.burst_window]
110
+ self._recent[key] = recent
111
+ prob = min(self.rules.burst_step * len(recent), self.rules.burst_max)
112
+ if recent and rng.random() < prob:
113
+ self._cooldown[key] = now + self.rules.burst_cooldown
114
+ self._recent[key] = []
115
+ return True
116
+ return False
117
+
118
+ # ---- 主邏輯 ----
119
+ def do_ccb(
120
+ self,
121
+ gid: int | str,
122
+ uid: int | str,
123
+ uid_name: str,
124
+ target: int | str,
125
+ target_name: str,
126
+ rng: random.Random | None = None,
127
+ now: float | None = None,
128
+ ) -> Outcome:
129
+ rng = rng or random
130
+ now = time.time() if now is None else now
131
+ r = self.rules
132
+ minutes = round(rng.uniform(r.min_minutes, r.max_minutes), 2)
133
+ ml = round(rng.uniform(r.min_ml, r.max_ml), 2)
134
+ crit = rng.random() < r.crit_chance
135
+ if crit:
136
+ ml = round(ml * 2, 2)
137
+
138
+ giver = self._user(gid, uid)
139
+ giver["name"] = uid_name
140
+ giver["given"] += 1
141
+ giver["given_ml"] = round(giver["given_ml"] + ml, 2)
142
+ giver["max_ml"] = max(giver["max_ml"], ml)
143
+
144
+ tgt = self._user(gid, target)
145
+ tgt["name"] = target_name
146
+ tgt["received"] += 1
147
+ tgt["received_ml"] = round(tgt["received_ml"] + ml, 2)
148
+
149
+ self._recent.setdefault((str(gid), str(uid)), []).append(now)
150
+ self.save()
151
+ return Outcome(minutes, ml, crit, tgt["received"], tgt["received_ml"])
152
+
153
+ def stats(self, gid: int | str, uid: int | str) -> dict[str, Any] | None:
154
+ return self._group(gid)["users"].get(str(uid))
155
+
156
+ def ranking(self, gid: int | str, key: str, limit: int = 10) -> list[tuple[str, dict]]:
157
+ users = self._group(gid)["users"].items()
158
+ ranked = sorted(
159
+ ((u, s) for u, s in users if s.get(key)), key=lambda x: x[1][key], reverse=True
160
+ )
161
+ return ranked[:limit]
162
+
163
+ def clear(self, gid: int | str) -> None:
164
+ group = self._group(gid)
165
+ group["users"] = {}
166
+ self._recent = {k: v for k, v in self._recent.items() if k[0] != str(gid)}
167
+ self._cooldown = {k: v for k, v in self._cooldown.items() if k[0] != str(gid)}
168
+ self.save()
@@ -0,0 +1,27 @@
1
+ """指令比對(不依賴 NoneBot,可單獨測試)。"""
2
+
3
+ from __future__ import annotations
4
+
5
+ from collections.abc import Iterable
6
+
7
+
8
+ def match_command(
9
+ text: str, names: Iterable[str], *, require_slash: bool = False
10
+ ) -> str | None:
11
+ """text 以某個指令名開頭(可選 / 前綴)就回傳後面的參數,否則回傳 None。
12
+
13
+ 指令名後面必須是結尾或空白,所以 "ccb查询" 不會被當成 "ccb",
14
+ "ccbxyz"、"踩踩背真舒服" 這種普通聊天也不會觸發。
15
+ """
16
+ text = text.strip()
17
+ if text.startswith("/"):
18
+ text = text[1:].lstrip()
19
+ elif require_slash:
20
+ return None
21
+ for name in sorted(names, key=len, reverse=True):
22
+ if not text.lower().startswith(name.lower()):
23
+ continue
24
+ rest = text[len(name) :]
25
+ if rest == "" or rest[0].isspace():
26
+ return rest.strip()
27
+ return None
@@ -0,0 +1,35 @@
1
+ [project]
2
+ name = "nonebot-plugin-ccb"
3
+ version = "0.1.0"
4
+ description = "和群友发生赛博ccb行为的 NoneBot2 群娱乐插件"
5
+ readme = "README.md"
6
+ requires-python = ">=3.10, <4.0"
7
+ license = "MIT"
8
+ license-files = ["LICENSE"]
9
+ authors = [{ name = "zebwqfox" }]
10
+ keywords = ["nonebot", "nonebot2", "onebot", "qq", "ccb"]
11
+ classifiers = [
12
+ "Framework :: AsyncIO",
13
+ "Programming Language :: Python :: 3",
14
+ "Operating System :: OS Independent",
15
+ ]
16
+ dependencies = [
17
+ "nonebot2>=2.4.0",
18
+ "nonebot-adapter-onebot>=2.4.0",
19
+ "nonebot-plugin-localstore>=0.7.0",
20
+ "pydantic>=1.10",
21
+ ]
22
+
23
+ [project.urls]
24
+ Homepage = "https://github.com/zebwqfox/nonebot-plugin-ccb"
25
+ Issues = "https://github.com/zebwqfox/nonebot-plugin-ccb/issues"
26
+
27
+ [build-system]
28
+ requires = ["hatchling>=1.27"]
29
+ build-backend = "hatchling.build"
30
+
31
+ [tool.hatch.build.targets.wheel]
32
+ packages = ["nonebot_plugin_ccb"]
33
+
34
+ [tool.nonebot]
35
+ plugins = ["nonebot_plugin_ccb"]