教学日程查询 Skill 使用说明
功能概述
本技能直接调用公司API获取实时教学排课数据，支持查询指定日期或时间段的课程安排，自动生成功能完整的互动网页，帮助老师快速查询授课安排，查看学生名单和出勤情况，支持单天查询和任意时间段查询两种模式。
环境配置
1. 依赖安装
首次使用前需要安装技能依赖：
cd .claude/skills/教学日程查询
npm install
2. API配置
确保项目根目录下的 .env 文件包含正确的API配置：
# 公司API地址
API_BASE_URL=https://api.qonnwolf.com/api/v1
# API认证令牌
AUTHORIZATION=Bearer your_token_here
# 默认查询的老师姓名
EMPLOYEE_NAME=橙子(程城)
快速开始
1. 调用技能
在Claude Code对话中输入，支持多种日期格式：
# 方式1：查询单天
/教学日程查询 # 查询当天日程
/教学日程查询 2026-04-28 # 标准格式
/教学日程查询 2026/04/28 # 斜杠格式
/教学日程查询 20260428 # 纯数字格式
/教学日程查询 4月28日 # 中文格式
/教学日程查询 04-28 # 短格式（默认当前年份）
# 方式2：查询时间段
/教学日程查询 2026-04-01 2026-04-30 # 查询4月整个月的日程
/教学日程查询 4月24日 4月26日 # 中文格式时间段
/教学日程查询 20260422 20260428 # 纯数字格式时间段
2. 查看结果
技能执行完成后会返回网页链接，点击链接即可打开互动网页查看详细信息。
网页功能说明
顶部功能区
- 日期范围显示：显示当前查询的日期范围和总天数
- 搜索框：输入日期、班级名称或学生姓名进行全局快速搜索
- 导出按钮：点击导出整个时间段的课表为Excel文件
- 视图切换：支持「按日期」和「按班级」两种视图模式一键切换
统计面板
- 展示查询范围内的总天数、总课程数、总学生人次
- 汇总出勤人次、缺勤人次，直观展示整体出勤情况
课表展示区
按日期视图（默认）
- 按日期分组展示，每天的课程独立排列
- 日期头部粘性定位，滚动时始终可见
- 每个日期组显示当日的课程数量、学生人次和出勤统计
- 课程按时间顺序排列，每个课程以卡片形式展示
- 卡片显示：班级名称、授课时间、授课老师、学生人数、出勤统计
- 点击卡片展开查看该班级的详细学生名单
按班级视图
- 按班级分组展示，同一个班级的所有课程集中排列
- 每个班级组显示课程次数和时间范围
- 方便查看同一个班级在整个时间段内的所有上课情况
学生名单
- 表格展示学生姓名和出勤状态
- 出勤状态标识：
- ✅ 出勤：正常上课
- ⏸ 请假：已请假
- ❌ 缺勤：未上课
- 支持按出勤状态筛选学生
导出功能
导出的Excel文件包含以下信息：
- 课程日期
- 班级名称
- 授课时间
- 授课老师
- 教室
- 学生姓名
- 出勤状态
- 备注信息
- 时间段查询会导出所有日期的完整数据，自动按日期排序
目录结构
教学日程查询/
├── index.js # 主程序文件，处理API调用和网页生成
├── package.json # 依赖配置文件
├── skill.md # Claude技能定义文件
├── template.html # 网页模板文件
└── README.md # 使用说明文档
输出目录
生成的文件保存在：
# 单天查询
.claude/output/teaching-schedule/2026-04-28/
├── schedule.html # 互动网页
└── schedule.json # 原始API数据
# 时间段查询
.claude/output/teaching-schedule/2026-04-01_2026-04-30/
├── schedule.html # 互动网页
└── schedule.json # 原始API数据（包含多天的完整数据）
常见问题
Q: API调用失败提示认证失败？
A: 请检查项目根目录下 .env 文件中的 AUTHORIZATION 配置是否正确，令牌是否过期。
Q: API调用失败提示网络错误？
A: 请检查网络连接是否正常，是否能够访问公司API地址，或者稍后重试。如果问题持续存在，请联系技术支持。
Q: 为什么没有数据？
A: 可能是查询的日期没有排课，或者API返回数据为空。可以尝试查询其他日期，或者检查 EMPLOYEE_NAME 配置是否正确。
Q: 导出的Excel文件打不开？
A: 请确保使用支持.xlsx格式的办公软件打开，如Microsoft Excel、WPS等。
Q: 可以查询其他老师的课表吗？
A: 可以修改 .env 文件中的 EMPLOYEE_NAME 配置为要查询的老师姓名，支持模糊匹配。
更新日志
v1.1.0 (2026-04-28)
- ✨ 新增时间段查询功能，支持查询任意起止日期范围内的所有日程
- ✨ 新增双视图展示模式：按日期视图、按班级视图，一键切换
- ✨ 升级统计面板，展示总天数、总课程数、总学生人次等汇总信息
- ✨ 搜索功能升级，支持按日期、班级、学生姓名全局搜索
- ✨ 导出功能升级，支持导出整个时间段的完整数据
- ✨ 优化界面设计，日期分组头部支持粘性定位，滚动浏览更方便
- ♻️ 重构数据处理逻辑，支持多天数据的合并和展示
v1.0.0 (2026-04-28)
- 初始版本发布
- 支持基础的单天日程查询功能
- 支持搜索、筛选、导出Excel功能
- 响应式界面设计