ATRI-NOTES/ATRI My Dear Moments/skills/atri_cf_query_readme.md

📊 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（公开 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)