Metadata-Version: 2.5
Name: nonebot-plugin-xianmei
Version: 0.2.0
Summary: 向本群群主（B站主播小小桃纸哟）自动献媚的娱乐插件：群主出现即随机发送彩虹屁，可联动馒头好感榜一起复读
Project-URL: Homepage, https://github.com/TonyLiangP2010405/nonebot-plugin-xianmei
Project-URL: Repository, https://github.com/TonyLiangP2010405/nonebot-plugin-xianmei
Author: TonyLiangP2010405
License: MIT
License-File: LICENSE
Keywords: bilibili,nonebot,nonebot2,plugin,娱乐,彩虹屁
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: nonebot-adapter-onebot>=2.4.0
Requires-Dist: nonebot2>=2.2.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: nonebot2[fastapi]>=2.2.0; extra == 'dev'
Requires-Dist: nonebug>=0.3; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# nonebot-plugin-xianmei

向本群群主自动献媚的娱乐插件——为本群桃神（B站主播「[小小桃纸哟](https://space.bilibili.com/6867955)」）量身定制的彩虹屁机器人。群主在群里出现时，先播报「检测到出现、开始献媚」，再随机发送谄媚文案（内置 6200 条，玩主播本人梗）。

## 功能

- 群主（桃神）在群里出现时，先播报「🔔 检测到 XX 出现！」「🫡 开始献媚！」
- 同时加载 `nonebot-plugin-mantou-affection` 时，逐个 @ 好感榜前 5 名说「出列，和我一起献媚！+1」，再把同一句彩虹屁连发三遍
- 好感度插件未加载、榜单为空或读取失败时，自动退化为「2 条播报 + 3 条文案」
- 冷却时间（默认 30 分钟）与每日封顶（默认 5 次触发，每次最多 10 条消息）防刷屏
- 全部管理命令仅限 superuser
- 多群独立配置

## 安装

```bash
pip install nonebot-plugin-xianmei
```

并在 NoneBot 配置中加载插件（`pyproject.toml` 的 `[tool.nonebot]` 或 bot 的 `load_plugin`）。

## 使用方法

| 指令 | 权限 | 范围 | 说明 |
|---|---|---|---|
| `/献媚设置群主 <QQ号>` | superuser | 群聊/私聊 | 绑定本群群主（桃神）QQ |
| `/献媚设置上限 <N>` | superuser | 群聊/私聊 | 设置每日献媚条数上限（1~100） |
| `/献媚设置冷却 <分钟>` | superuser | 群聊/私聊 | 设置触发冷却时间（1~1440 分钟） |
| `/献媚开关` | superuser | 群聊/私聊 | 开关本群献媚功能 |
| `/献媚状态` | superuser | 群聊/私聊 | 查看本群配置与今日已发数量 |
| `/献媚预览` | superuser | 群聊/私聊 | 随机预览一条献媚文案 |

> 命令需要 NoneBot 配置 `command_start=["/"]`（默认即为 `/`）。
>
> **群聊中发送**：省略群号，直接作用于当前群，如 `/献媚设置群主 6867955`。
>
> **私聊发送**：第一个参数必须是群号，格式为 `/献媚设置群主 <群号> <QQ号>`。例如 `/献媚设置群主 123456 6867955` 中，`123456` 是群号，`6867955` 是群主（桃神）的 QQ 号。其余命令同理，如 `/献媚状态 123456`、`/献媚设置上限 123456 10`。

数据存储于运行目录 `data/xianmei/state.json`（每群独立，自动生成）。绑定后可用 `/献媚状态` 核对配置是否正确。

## 文案风格

每条 10~30 字，梗来自桃神直播间：五冠王、头部主播、出货/老演员、堵门抽卡、抽到三点多、星露谷、理性消费「不买资格」，以及至冬女皇、星布谷地、因缘精灵、影之刃零、烟嗓、王者陪玩等新素材。文案由 `scripts/gen_quips.py` 生成，在现有文案后追加新批次，重复运行不会重复追加。

## 示例

```
桃神：大家晚上好
机器人：🔔 检测到 五冠王桃神 出现！
机器人：🫡 开始献媚！
机器人：@桃神的头号信徒 出列，和我一起献媚！+1
机器人：桃神一开口，群里的空气都变甜了
机器人：桃神一开口，群里的空气都变甜了
机器人：桃神一开口，群里的空气都变甜了
```

## 可选联动

如果同时加载 `nonebot-plugin-mantou-affection`：

- 每次真正触发献媚后，为该群主上报 2 点馒头好感度；
- 读取本群好感榜，按顺序 @ 前 5 名（排除桃神本人和机器人自己）一起复读。

该联动是软依赖，好感度插件未安装、未加载或榜单读取失败时，献媚功能仍会正常发送「2 条播报 + 3 条文案」，不会报错或中断。

## 许可证

MIT
