Metadata-Version: 2.5
Name: nonebot-plugin-xianmei
Version: 0.1.3
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)」）量身定制的彩虹屁机器人。群主在群里出现时，先播报「检测到出现、开始献媚」，再随机发送一条谄媚文案（内置 5200 条，玩主播本人梗）。

## 功能

- 群主（桃神）在群里出现时，先播报「🔔 检测到 XX 出现！」「🫡 开始献媚！」，再自动随机发送一条献媚彩虹屁
- 冷却时间（默认 30 分钟）与每日封顶（默认 5 条）防刷屏
- 全部管理命令仅限 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` 生成，可改语料后重新生成。

## 示例

```
桃神：大家晚上好
机器人：🔔 检测到 五冠王桃神 出现！
机器人：🫡 开始献媚！
机器人：群主大人一出场，我辈楷模！
```

## 许可证

MIT
