Metadata-Version: 2.4
Name: nb-plugin-uma
Version: 0.1.0
Summary: NoneBot2 赛马娘插件 - 模拟抽卡 | 新闻推送 | 生日提醒
Project-URL: Homepage, https://github.com/Baimotong/nonebot-plugin-uma
Project-URL: Repository, https://github.com/Baimotong/nonebot-plugin-uma
Author: Baimotong
License-Expression: GPL-3.0-only
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.0
Requires-Dist: gitpython>=3.1.0
Requires-Dist: httpx>=0.28.0
Requires-Dist: lxml>=4.9.0
Requires-Dist: nonebot-adapter-onebot>=2.4.6
Requires-Dist: nonebot-plugin-apscheduler>=0.5.0
Requires-Dist: nonebot2>=2.4.4
Requires-Dist: pillow>=10.0.0
Description-Content-Type: text/markdown

# nonebot-plugin-uma

NoneBot2 赛马娘插件 — 模拟抽卡 / 新闻推送 / 生日提醒

## 声明

> **本插件移植自 [azmiao/uma_plugin](https://github.com/azmiao/uma_plugin)（HoshinoBot 版），原作者 [azmiao](https://github.com/azmiao)。**
>
> 本项目仅对原插件进行框架适配（HoshinoBot → NoneBot2），核心逻辑和数据来源归原作者所有。
> 本项目遵循 [GPL-3.0](LICENSE) 开源协议，与原插件保持一致。
>
> 如有问题反馈，建议优先前往原仓库 [azmiao/uma_plugin](https://github.com/azmiao/uma_plugin) 提交 issue。

## 功能

| 模块 | 功能 | 说明 |
|------|------|------|
| 抽卡 | 马娘单抽/十连/天井、支援卡单抽/十连/天井/满破 | 支持日/台/韩/B服卡池 |
| 新闻 | 日服官网新闻查看 + 定时推送 | 每5分钟检测更新 |
| 生日 | 马娘生日查询 + 每日推送 | 每天8:31推送 |

## 安装

以下三种方式任选其一：

### 方式一：nb-cli（推荐）

```bash
nb plugin install nonebot-plugin-uma
```

### 方式二：uv

```bash
uv add nonebot-plugin-uma
```

### 方式三：pip

```bash
pip install nonebot-plugin-uma
```

### 从 GitHub 安装

```bash
pip install git+https://github.com/Baimotong/nonebot-plugin-uma.git
```

## 配置

在 NoneBot2 的 `.env.prod` 中添加以下配置（均为可选）：

```ini
# 数据存储目录，默认 data/uma
UMA_DATA_DIR=data/uma

# 默认服务器，可选 jp/tw/ko/bili，默认 jp
UMA_DEFAULT_SERVER=jp

# 是否使用代理，默认 false
UMA_USE_PROXY=false

# 代理地址
UMA_PROXY_URL=http://localhost:1081
```

## 命令

### 抽卡

| 命令 | 说明 |
|------|------|
| `马娘单抽` / `单抽马娘` | 马娘池单抽 |
| `马娘十连` / `马十连` | 马娘池十连 |
| `马之井` / `马娘井` | 马娘池200抽天井 |
| `支援卡单抽` / `育成卡单抽` | 支援卡池单抽 |
| `支援卡十连` / `育成卡十连` | 支援卡池十连 |
| `支援卡井` / `育成卡井` | 支援卡池200抽天井 |
| `支援卡抽满破` | 模拟抽到满破(5张) |
| `支援卡选择满破目标` | 设置满破目标(不带参数查看列表) |
| `支援卡查询满破目标` | 查询当前满破目标 |
| `支援卡清除满破目标` | 清除满破目标 |
| `查看马娘卡池` | 查看当前卡池详情 |
| `切换马娘服务器 jp/tw/bili` | 切换服务器(群管理员) |
| `切换马娘卡池 数字ID` | 切换卡池(群管理员) |
| `更新马娘卡池` | 手动更新卡池数据(超级用户) |

### 新闻

| 命令 | 说明 |
|------|------|
| `马娘新闻` | 查看日服最新5条新闻 |
| `开启马娘新闻推送` | 开启日服新闻定时推送(群管理员) |
| `关闭马娘新闻推送` | 关闭日服新闻定时推送(群管理员) |

### 生日

| 命令 | 说明 |
|------|------|
| `查今天生日马娘` | 查询今天生日的马娘 |
| `查马娘生日 角色名` | 查询指定马娘的生日 |
| `查生日马娘 月-日` | 查询某天生日的马娘 |
| `开启马娘生日推送` | 开启每日生日提醒(群管理员) |
| `关闭马娘生日推送` | 关闭每日生日提醒(群管理员) |

### 帮助

| 命令 | 说明 |
|------|------|
| `马娘帮助` | 显示全部命令帮助 |

## 定时任务

| 任务 | 时间 | 说明 |
|------|------|------|
| 卡池数据更新 | 每天 3:30 | 自动从 Bwiki 更新卡池数据和图片 |
| 日服新闻检测 | 每5分钟 | 检测日服新闻更新并推送到已开启的群 |
| 生日推送 | 每天 8:31 | 推送当天生日的马娘到已开启的群 |

## 致谢

- [azmiao](https://github.com/azmiao) — 原 HoshinoBot 赛马娘插件作者
- [azmiao/uma_info_data](https://github.com/azmiao/uma_info_data) — 马娘基础数据库
- [BWiki](https://wiki.biligame.com/umamusume) — 卡池数据和图片资源来源
- [赛马娘官网](https://umamusume.jp/) — 新闻数据来源

## 协议

本项目基于 [GPL-3.0](LICENSE) 协议开源。
