lol-analyst — 英雄联盟数据分析助手

基于 Riot Games Official API 的 LOL 数据分析 Skill，支持中文自然语言查询。

功能

| 功能 | 说明 | 触发词 | |-----|------|--------| | 🔍 召唤师查询 | 查询玩家基本信息 | 查查 {name#tag} 的信息 | | 🏆 排位分析 | 排位段位、胜率、趋势 | 看看我的排位 / {name}的段位 | | 📜 对局历史 | 最近N场对局详情 | 最近{20}把战绩 | | ⭐ 英雄熟练度 | 英雄池分析 | 最擅长的英雄 | | 🎯 AI智能解读 | LLM解读数据 | 分析我需要怎么改进 | | 🆚 英雄对比 | 多英雄表现对比 | 对比我的 Jinx vs Caitlyn |

前置条件

1. 获取 Riot Games API Key

访问 Riot Developer Portal
用你的 Riot Games 账号登录（就是玩LOL的账号）
登录后自动生成 Development API Key（24小时过期）
如需永久 Key：注册产品 → 申请 Personal API Key

2. 配置 API Key

在 Skill 首次运行时输入，或设置环境变量：

export RIOT_API_KEY="RGAPI-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

使用示例

# 查询玩家
查查 虎牙丶Uzi#TW2 的信息

# 排位分析
看看 Faker#KR1 的排位

# 对局历史
我最近20把排位战绩

# 英雄分析
对比我的金克丝和凯特琳数据

# AI分析
分析我最近的对局，给上分建议

支持区域

| 代码 | 区域 | |-----|------| | KR | 韩国 | | NA1 | 北美 | | EUW1 | 西欧 | | EUN1 | 北欧/东欧 | | TW2 | 中国台湾 | | JP1 | 日本 | | BR1 | 巴西 | | ... | 全部13个区域 |

WorkBuddy 集成

前置条件

# 安装依赖（一次性）
C:/Users/PC/.workbuddy/binaries/python/envs/default/Scripts/pip install riotwatcher

调用方式

WorkBuddy 应通过 CLI 调用此 Skill：

PYTHON_PATH = "C:/Users/PC/.workbuddy/binaries/python/envs/default/Scripts/python.exe"
SKILL_SCRIPT = "C:/Users/PC/.workbuddy/skills/lol-analyst/scripts/lol_analyst.py"

# 配置 API Key
{ PYTHON_PATH } { SKILL_SCRIPT } --setup --api-key "RGAPI-xxx"

# 查询召唤师档案 → 输出 HTML
{ PYTHON_PATH } { SKILL_SCRIPT } --profile --name "name#tag" --region kr --output result.html

# 查询对局历史
{ PYTHON_PATH } { SKILL_SCRIPT } --matches --name "name#tag" --region kr --count 20 --output matches.html

# 综合分析报告
{ PYTHON_PATH } { SKILL_SCRIPT } --analysis --name "name#tag" --region kr --count 20 --output analysis.html

结果呈现

脚本执行后输出 HTML 文件路径（格式：__OUTPUT_FILE__:C:\path\to\file.html），WorkBuddy 需：

读取输出的 HTML 文件路径
使用 preview_url 打开该 HTML
用中文给用户解读关键数据

无 API Key 时的处理

如果用户没有 API Key，引导用户：

访问 https://developer.riotgames.com/
用 Riot 账号登录（就是玩LOL的账号）
复制自动生成的 Development API Key（RGAPI-xxx 格式）
在 WorkBuddy 中执行 lol-analyst --setup --api-key "RGAPI-xxx"

文件结构

lol-analyst/
├── SKILL.md
├── scripts/
│   ├── lol_analyst.py      # 主入口
│   ├── riot_client.py       # Riot API 封装
│   ├── config_manager.py    # 配置管理
│   └── report_generator.py  # HTML 报告生成
└── requirements.txt

技术栈

Python 3.10+
RiotWatcher (Riot API Python 封装)
纯 Python 标准库 HTML 报告（无外部前端依赖）