koishi-plugin-arknights-card/README.md

明日方舟抽卡模拟插件 - 支持限定池、标准池抽卡模拟，包含完整的干员数据和抽卡统计功能

# 明日方舟抽卡模拟插件

[![npm](https://www.npmjs.com/package/koishi-plugin-arknights-card)](https://koishi.chat)
[![License](https://www.npmjs.com/package/koishi-plugin-arknights-card)](LICENSE)

一个基于 [Koishi](https://koishi.chat) 框架的明日方舟抽卡模拟插件，支持限定池、标准池抽卡模拟，包含完整的干员数据和抽卡统计功能。

## 功能特点

- 🎯 **真实概率模拟**：基于游戏内实际概率设计，可自定义各星级出率
- 🌟 **完整干员数据**：包含最新的限定干员、六星、五星、四星和三星干员数据
- 🎁 **每日签到系统**：用户可通过每日签到获取抽卡机会
- 📊 **抽卡统计**：详细记录用户的抽卡历史和统计数据
- 🔄 **单抽与十连**：支持单次抽卡和十连抽卡
- 🎨 **美观的结果展示**：使用星星和特殊标签直观显示抽卡结果

## 安装方法

### 使用 Koishi 插件市场安装

1. 在 Koishi 控制台中，进入插件市场
2. 搜索 "arknights-card"
3. 点击安装按钮
4. 重启 Koishi 应用

### 手动安装

```bash
# 进入 Koishi 应用目录
cd your-koishi-app

# 安装插件
npm install koishi-plugin-arknights-card

# 或使用 yarn
yarn add koishi-plugin-arknights-card
```

然后在 `koishi.yml` 中添加插件配置：

```yaml
plugins:
  arknights-card:
    limitedRate: 1
    sixStarRate: 2
    fiveStarRate: 12
    fourStarRate: 45
    threeStarRate: 40
    dailyDraws: 10
```

## 使用方法

### 基本命令

| 命令 | 描述 | 示例 |
|------|------|------|
| `签到` | 每日签到，获取抽卡次数 | `签到` |
| `单抽` | 进行一次抽卡 | `单抽` |
| `十连` | 进行十次抽卡 | `十连` |
| `查询` | 查询剩余抽卡次数 | `查询` |
| `抽卡历史` | 查询最近的抽卡记录 | `抽卡历史` |
| `抽卡统计` | 查询抽卡统计数据 | `抽卡统计` |

### 命令选项

- `抽卡历史 -l <数量>`: 指定显示的历史记录数量，默认为10条，最多50条
  ```
  抽卡历史 -l 20
  ```

### 示例输出

#### 单抽示例

```
博士
本次寻访获得的干员：
━━━━━━
★★★★★★ 中坚术师 艾雅法拉
━━━━━━
剩余抽卡次数：9
```

#### 十连示例

```
博士
本次寻访获得的干员：
━━━━━━
★★★ 尖兵 芬
★★★★ 巡空者 云迹
★★★ 医师 芙蓉
★★★★★ 异格职业 阿米娅
★★★★ 铁卫 泡泡
★★★ 强攻手 泡普卡
★★★★ 领主 罗小黑
★★★ 速射手 安德切尔
【限定】召唤师 令
★★★★ 医师 末药
━━━━━━
✨限定干员：1个
五星干员：1个
四星干员：3个
三星干员：5个
剩余抽卡次数：0
```

#### 抽卡历史示例

```
博士的抽卡历史记录（最近10条）：
━━━━━━
1. 【限定】召唤师 令 (5.15 20:30)
2. ★★★★ 医师 末药 (5.15 20:30)
3. ★★★ 速射手 安德切尔 (5.15 20:30)
4. ★★★★ 领主 罗小黑 (5.15 20:30)
5. ★★★ 强攻手 泡普卡 (5.15 20:30)
6. ★★★★ 铁卫 泡泡 (5.15 20:30)
7. ★★★★★ 异格职业 阿米娅 (5.15 20:30)
8. ★★★ 医师 芙蓉 (5.15 20:30)
9. ★★★★ 巡空者 云迹 (5.15 20:30)
10. ★★★ 尖兵 芬 (5.15 20:30)
━━━━━━
```

#### 抽卡统计示例

```
博士的抽卡统计：
━━━━━━
总抽卡次数：100次
✨限定干员：1个 (1.00%)
🌟六星干员：2个 (2.00%)
五星干员：12个 (12.00%)
四星干员：45个 (45.00%)
三星干员：40个 (40.00%)
━━━━━━
```

## 配置选项

| 配置项 | 类型 | 默认值 | 描述 |
|--------|------|--------|------|
| `limitedRate` | 数字 | 1 | 限定干员出率 (%) |
| `sixStarRate` | 数字 | 2 | 六星干员出率 (%) |
| `fiveStarRate` | 数字 | 12 | 五星干员出率 (%) |
| `fourStarRate` | 数字 | 45 | 四星干员出率 (%) |
| `threeStarRate` | 数字 | 40 | 三星干员出率 (%) |
| `dailyDraws` | 数字 | 10 | 每日签到获得的抽卡次数 |

## 干员数据

插件包含完整的干员数据，按照以下分类：

- **限定干员**: 36个限定干员，如令、W、浊心斯卡蒂等
- **六星干员**: 80个六星干员，如艾雅法拉、能天使、银灰等
- **五星干员**: 170+个五星干员，如阿米娅、德克萨斯、蓝毒等
- **四星干员**: 49个四星干员，如云迹、罗小黑、末药等
- **三星干员**: 17个三星干员，如芬、香草、米格鲁等

所有干员数据均采用最新的职业体系，如尖兵、武者、神射手等，而非旧的职业体系（先锋、近卫、狙击等）。

## 数据存储

插件使用 Koishi 的数据库系统存储以下信息：

- 用户抽卡次数和签到记录
- 抽卡历史记录
- 抽卡统计数据

## 许可证

本项目采用 [MIT 许可证](LICENSE)。

## 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进这个插件！

## 致谢

- [Koishi](https://koishi.chat) - 提供强大的机器人框架
- [明日方舟](https://ak.hypergryph.com/) - 游戏数据和灵感来源