leetify

从 Leetify API 获取 CS2 玩家统计数据、比赛分析和游戏玩法见解。支持球员比较和赛季统计数据。用于统计查询和演示分析。

# Leetify API Skill

Access CS2 statistics and match data from the Leetify platform.

## Quick Stats

Use these commands for general statistics, ranks, and recent performance.

### Show Statistics
```bash
bash scripts/get_stats_by_username.sh USERNAME
```
Displays averages, recent match performance, and ranks.

### Get Match Data
```bash
bash scripts/get_match_details.sh USERNAME [INDEX]
```
Fetches raw JSON statistics for a specific match. When presenting this data, provide a structured report covering shooting, utility usage, and performance metrics.

### Compare Players
```bash
bash scripts/compare_by_username.sh USERNAME1 USERNAME2
```
Compares two players based on their Leetify profiles.

### Season Stats
```bash
python3 scripts/season_stats.py
```
Provides a summary table for players tracked in the local database.

## Demo Analysis

Use this workflow for detailed tactical reviews and round-by-round breakdowns.

### 1. Identify the Player
- Resolve Steam ID: `python3 scripts/steam_ids.py get --username USERNAME`
- Match the player in the match log using the resolved Steam ID.

### 2. Generate Match Log
```bash
python3 scripts/analyze_last_demo.py --username USERNAME [--match-index N] [--no-cache]
```
- Downloads and parses the demo file (requires significant memory).
- Generates a text log containing scoreboard and round timeline.

### 3. Analyze Performance
Review the generated log to assess:
- Shooting accuracy and trade efficiency.
- Utility effectiveness (flash duration, grenade damage).
- Role performance (entry, anchor, support).
- Tactical highlights and mistakes.

Actionable recommendations can be provided based on the observed patterns. Guides or tutorials for specific map positions may be referenced if performance in those areas was suboptimal.

## Data Management

### Manage Steam IDs
```bash
# Save a player profile
python3 scripts/steam_ids.py save --username "username" --steam-id "7656119..." --name "Name"

# List all tracked players
python3 scripts/steam_ids.py list
```

## Configuration

The skill requires the `LEETIFY_API_KEY` environment variable.
API documentation is available at: https://api-public-docs.cs-prod.leetify.com/

---

## 中文说明

# Leetify API 技能

从 Leetify 平台访问 CS2 统计数据和比赛数据。

## 快速统计

使用以下命令查询常规统计、段位和近期表现。

### 显示统计数据
```bash
bash scripts/get_stats_by_username.sh USERNAME
```
显示平均值、近期比赛表现和段位。

### 获取比赛数据
```bash
bash scripts/get_match_details.sh USERNAME [INDEX]
```
获取指定比赛的原始 JSON 统计数据。在呈现这些数据时，请提供一份结构化报告，涵盖射击、道具使用和表现指标。

### 比较玩家
```bash
bash scripts/compare_by_username.sh USERNAME1 USERNAME2
```
根据两名玩家的 Leetify 个人资料进行比较。

### 赛季统计
```bash
python3 scripts/season_stats.py
```
为本地数据库中跟踪的玩家提供一份汇总表。

## 演示（Demo）分析

使用此工作流进行详细的战术复盘和逐回合分析。

### 1. 确定玩家
- 解析 Steam ID：`python3 scripts/steam_ids.py get --username USERNAME`
- 使用解析出的 Steam ID 在比赛日志中匹配该玩家。

### 2. 生成比赛日志
```bash
python3 scripts/analyze_last_demo.py --username USERNAME [--match-index N] [--no-cache]
```
- 下载并解析 demo 文件（需要大量内存）。
- 生成包含记分板和回合时间线的文本日志。

### 3. 分析表现
查看生成的日志以评估：
- 射击精度和补枪效率。
- 道具效果（闪光持续时间、手雷伤害）。
- 角色表现（突破手、驻守位、辅助位）。
- 战术亮点和失误。

可根据观察到的模式提供可执行的改进建议。如果在某些地图点位的表现不佳，可参考相关点位的攻略或教程。

## 数据管理

### 管理 Steam ID
```bash
# Save a player profile
python3 scripts/steam_ids.py save --username "username" --steam-id "7656119..." --name "Name"

# List all tracked players
python3 scripts/steam_ids.py list
```

## 配置

该技能需要 `LEETIFY_API_KEY` 环境变量。
API 文档可在以下网址查看：https://api-public-docs.cs-prod.leetify.com/