77 lines
2.9 KiB
Markdown
77 lines
2.9 KiB
Markdown
---
|
||
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`：默认查询的老师姓名
|