---
name: 教学日程查询
description: 通过调用公司API获取指定日期的教学排课数据，生成功能完整的互动网页展示课表、学生名单和出勤情况，支持搜索、筛选、导出Excel等功能。
type: skill
command: node {{skillPath}}/index.js {{args}}
---

# 教学日程查询 Skill

## 功能介绍
本技能用于查询指定日期的教学排课安排，**直接调用公司API获取实时数据**，自动生成互动网页展示详细信息，帮助老师快速了解当日授课安排和学生出勤情况。

## 调用方式
```
# 方式1：查询单天
/教学日程查询 [日期]

# 方式2：查询时间段
/教学日程查询 [开始日期] [结束日期]
```

### 参数说明
- `[日期]`（可选）：要查询的单天日期，支持多种格式：
  - 标准格式：`2026-04-28`、`2026/04/28`、`20260428`
  - 短格式：`04-28`、`4月28日`（默认使用当前年份）
  - 如果不指定日期，默认查询当天的日程
- `[开始日期]` 和 `[结束日期]`：要查询的时间段，格式同上，系统会自动查询这两个日期之间的所有日程（包含起止日期）。

### 示例
```
/教学日程查询                          # 查询当天的教学日程
/教学日程查询 2026-04-28             # 查询2026年4月28日的教学日程
/教学日程查询 4月24日 4月26日        # 查询2026年4月24日至26日的日程
/教学日程查询 2026-04-01 2026-04-30  # 查询2026年4月整个月的教学日程
/教学日程查询 20260422 20260428      # 查询2026年第17周的教学日程
```

## 功能特性
### 📅 日程展示
- 按时间顺序展示当天所有课程安排
- 显示班级名称、授课时间、授课老师、校区、学生人数
- 点击课程卡片展开查看详细学生名单

### 🔍 搜索筛选
- 支持按班级名称搜索
- 支持按学生姓名搜索
- 支持按出勤状态筛选学生（出勤/请假/缺勤）

### 📊 数据导出
- 支持将当前课表导出为Excel文件
- 导出内容包含班级信息、学生名单、出勤状态、备注

### 📱 响应式设计
- 支持电脑、平板、手机等多种设备访问
- 界面美观易用，操作流畅

## 输出文件
生成的网页和数据会保存在以下目录：
```
.claude/output/teaching-schedule/日期范围/
├── schedule.html    # 互动网页文件
└── schedule.json    # 原始API数据文件
```
例如：查询4月24日至26日，输出目录为 `.claude/output/teaching-schedule/2026-04-24_2026-04-26/`

## 使用说明
1. 调用命令后，系统会自动调用公司API获取实时排课数据
2. 数据获取成功后会生成互动网页
3. 点击返回的链接即可打开网页查看详细信息
4. 在网页中可以进行搜索、筛选、导出等操作

## 配置说明
API配置信息保存在项目根目录的 `.env` 文件中：
- `API_BASE_URL`：公司API地址
- `AUTHORIZATION`：API认证令牌
- `EMPLOYEE_NAME`：默认查询的老师姓名
