---
name: study-analysis
description: 分析用户学习情况的工具，输入格式为「学情分析：用户角色ID，Level几，Unit几」，其中Level支持Level1/L1/1格式，Unit支持Unit1/U1/1格式，自动请求API获取学情数据并生成可视化分析报告。触发场景：用户提到「学情分析」、「学习情况分析」时使用。
---

# 学情分析技能使用指南

## 触发规则
当用户输入以下格式内容时触发本技能：
```
学情分析：[用户角色ID]，[Level]，[Unit]
```
- 用户角色ID：数字类型（必填）
- Level：支持多种格式：`Level1`/`L1`/`1`/`Level2`/`L2`/`2`，自动转换为数字1或2
- Unit：支持多种格式：`Unit1`/`U1`/`1`，自动转换为对应的数字

## 工作流程
1. **参数解析**：从用户输入中提取角色ID、Level、Unit三个参数，统一格式化为数字类型
2. **构造请求**：将参数封装为API查询参数，operator固定为Kingson
3. **请求API**：调用学情分析服务API `https://api.valavala.com/v2/user/unit/learn/info`，传入请求参数
4. **存储数据**：将API返回的JSON数据保存到本地 output 目录
5. **生成可视化报告**：使用HTML模板渲染返回数据，生成可视化HTML文件
6. **返回结果**：将生成的HTML文件访问地址返回给用户

## 调用方式
执行脚本：
```bash
python3 /root/.openclaw/workspace-xiaoban/skills/study-analysis/scripts/analysis.py [role_id] [level] [unit]
```

## 参数说明
- `role_id`: 用户角色ID（数字）
- `level`: 等级（数字1或2）
- `unit`: 单元号（数字）

## API接口说明
- 请求地址：`https://api.valavala.com/v2/user/unit/learn/info`
- 请求方式：GET
- 请求参数：
  - `operator`: 固定值 `Kingson`
  - `level`: `L1` 或 `L2`
  - `userId`: 用户角色ID
  - `unitIndex`: 单元号

## 输出说明
- 成功：返回HTML可视化报告的本地路径/访问地址
- 失败：返回具体错误信息