📝 新增 CF查询插件README文档
This commit is contained in:
113
ATRI My Dear Moments/skills/atri_cf_query_readme.md
Normal file
113
ATRI My Dear Moments/skills/atri_cf_query_readme.md
Normal file
@@ -0,0 +1,113 @@
|
||||
# 📊 ATRI CF 查分与刷题分析插件
|
||||
|
||||
> 查询 Codeforces 用户信息、Rating 变化、刷题统计,一键生成可视化图表
|
||||
|
||||
## 🎯 功能
|
||||
|
||||
| 功能 | 指令 | 说明 |
|
||||
|:---|:---|:---|
|
||||
| 🔗 **绑定账号** | `cfbind <handle>` | 将QQ与CF账号绑定 |
|
||||
| 🔓 **解绑** | `cfunbind` | 解除绑定 |
|
||||
| 👤 **查看绑定** | `cfwho` | 查看自己的绑定信息 |
|
||||
| 📊 **查分+报告** | `cf <handle>` / `cf` | 查Rating+刷题报告+图表 |
|
||||
| 🏆 **群排行** | `cftop` | 群内已绑定用户的Rating排名 |
|
||||
|
||||
## 📋 使用方法
|
||||
|
||||
### 1️⃣ 绑定账号
|
||||
|
||||
```
|
||||
cfbind Otmsc
|
||||
```
|
||||
✅ 绑定成功!Otmsc | Rating: 653 (Newbie)
|
||||
|
||||
### 2️⃣ 查分与刷题报告
|
||||
|
||||
```
|
||||
cf Otmsc
|
||||
```
|
||||
|
||||
输出内容:
|
||||
|
||||
📄 **文本报告**
|
||||
```
|
||||
📊 CF Profile: Otmsc
|
||||
━━━━━━━━━━━━━━━━━━━━
|
||||
Rating: 653 (Newbie) | 最高: 653
|
||||
参赛: 2场 | 涨2掉0 | 最佳排名: #9233
|
||||
━━━━━━━━━━━━━━━━━━━━
|
||||
提交: 87 | AC: 31 | AC率: 35.6%
|
||||
通过不同题目: 23道
|
||||
━━━━━━━━━━━━━━━━━━━━
|
||||
🎯 难度分布:
|
||||
0: ██ 2
|
||||
800: █ 1
|
||||
1200: █████ 5
|
||||
1300: █ 1
|
||||
1400: ███ 3
|
||||
1500: ████████ 8
|
||||
1600: ███ 3
|
||||
━━━━━━━━━━━━━━━━━━━━
|
||||
🔥 最近AC:
|
||||
✅ 2075C [1500] Two Colors
|
||||
✅ 2093E [1500] Min Max MEX
|
||||
✅ 2242B [?] Predominant Frequency Division
|
||||
```
|
||||
|
||||
🖼️ **图表输出**
|
||||
|
||||
| 图表类型 | 说明 |
|
||||
|:---|:---|
|
||||
| 📊 **Rating变化柱状图** | 参赛场次×Rating,标注涨/掉分 |
|
||||
| 📊 **难度分布柱状图** | 各Rating区间解题数 |
|
||||
| 🥧 **标签饼图** | 算法标签分布 |
|
||||
| 🔗 **合并图** | 三图合一(默认模式) |
|
||||
|
||||
### 3️⃣ 群内排行
|
||||
|
||||
```
|
||||
cftop
|
||||
```
|
||||
```
|
||||
🏆 群内CF排行榜
|
||||
━━━━━━━━━━━━━━
|
||||
🥇 Kronecker_kir — 0
|
||||
🥈 Otmsc — 653
|
||||
```
|
||||
|
||||
## ⚙️ 配置项
|
||||
|
||||
| 配置项 | 类型 | 默认值 | 说明 |
|
||||
|:---|:---:|:---:|:---|
|
||||
| `bind_max_per_group` | int | 50 | 每群最大绑定数 |
|
||||
| `default_chart_style` | string | `combined` | 图表模式:`combined` / `separate` / `text_only` |
|
||||
| `auto_report_enable` | bool | false | 定时推送刷题周报 |
|
||||
|
||||
## 🛠️ 技术栈
|
||||
|
||||
- **数据源**: [Codeforces API](https://codeforces.com/apiHelp)(公开 REST API)
|
||||
- **图表**: matplotlib + NumPy + Pillow
|
||||
- **框架**: AstrBot v4 Plugin API
|
||||
- **存储**: JSON 文件 (data/plugins/astrbot_plugin_cf_query/)
|
||||
|
||||
## 📦 安装
|
||||
|
||||
1. 将 `astrbot_plugin_cf_query` 目录放入 AstrBot 的 `data/plugins/` 目录
|
||||
2. 在 WebUI 中启用插件
|
||||
3. (可选)确保安装 matplotlib:`pip install matplotlib pillow numpy`
|
||||
4. 重启 AstrBot 或重载插件
|
||||
|
||||
## 🔄 更新日志
|
||||
|
||||
### v1.0.0 (2026-07-08)
|
||||
- ✨ 初始版本
|
||||
- ✨ 用户绑定 (cfbind / cfunbind / cfwho)
|
||||
- ✨ CF查分与刷题报告 (cf)
|
||||
- ✨ Rating变化柱状图
|
||||
- ✨ 解题难度分布柱状图 + 标签饼图
|
||||
- ✨ 合并图模式
|
||||
- ✨ 群内CF排行 (cftop)
|
||||
|
||||
---
|
||||
|
||||
*Made with 🥕 by ATRI (YHN-04B-009)*
|
||||
Reference in New Issue
Block a user