clawhub install yuketang-club-liuxinghui📖 About This Skill
name: yuketang description: test for summary
前置配置（只需一次）
第一步：获取 Secret
打开
> 没有配置 Secret？ 所有工具调用都会返回鉴权失败。请先完成上述步骤。
第二步：设置环境变量
macOS / Linux：
export YUKETANG_SECRET="你的Secret"
Windows（PowerShell）：
$env:YUKETANG_SECRET="你的Secret"
Windows（CMD）：
set YUKETANG_SECRET=你的Secret
第三步：运行安装脚本
macOS / Linux：
bash setup.sh
Windows 或任何有 Node.js 的环境：
node setup.js
> 具体配置文件路径取决于你使用的客户端（OpenClaw / CodeBuddy / Cursor 等），请参考对应文档。
第四步：验证
配置完成后，尝试问一句 "我的雨课堂ID是多少"。如果正常返回用户信息，说明配置成功。
触发场景
意图 → 工具 速查表
| 用户意图 | 调用工具 |
|----------|---------|
| 查询账号 / 我的ID / 雨课堂ID | claw_current_user |
| 查询我开的课 / 我教了哪些班 | ykt_teaching_list |
| 查询我的班级数据 / 班级教学数据 | ykt_classroom_statistics |
| 查询预警学生名单 / 重点关注学生 | ykt_classroom_warning_overview |
| 查询某个具体班级的预警学生名单 | ykt_classroom_warning_student |
| 今天上课情况 / 今天答题率 / 到课率 | cube_teacher_today_teaching |
| 预约开课 | cube_lesson_reservation |
| 查询我有哪些待批改的作业 / 考试 / 课堂/ 课件 | ykt_teacher_correct_statistic |
| 查询最近发布的作业 / 我在xx班发布的作业完成情况 /最近一次发布的作业完成情况 | ykt_recent_exercise_submit |
| 查询最近发布的公告 / 我在xx班发布的公告阅读情况 /最近一次公告的阅读情况 | ykt_recent_notice_read |
不要触发的情况
组合调用示例
> 用户说："帮我看看我是谁，还有我开了哪些班"
依次调用：
1. claw_current_user
2. ykt_teaching_list
工具详细说明
全局规则
ykt_classroom_id_by_name 拿到 classroomId，再调用目标工具。1. claw_current_user
查询当前雨课堂用户 ID。
典型问法： "我的雨课堂ID是多少" / "帮我确认一下当前账号"
参数： 无
2. ykt_teaching_list
查询当前账号开设的班级列表。
典型问法： "我教了哪些班" / "这学期我教的课"
参数： 无
注意： 返回结果中的 emoji 需保留。
3. ykt_classroom_statistics
查询本学期班级数据概览。
典型问法： "我的班级数据" / "XXX 班级数据情况"
参数：
| 参数 | 必填 | 说明 |
|------|------|------|
| classroomName | 否 | 不传则返回本学期所有班级概览；传入后返回指定班级详情 |
交互规则：
4. ykt_classroom_warning_overview
查询本学期各班级的学习活动完成率预警总览。
典型问法： "查看班级预警情况"
参数： 无
返回内容包括： 教学班名称、完成率 = 0% 人数、预警人数（完成率 < 80%）、数据截止时间。
5. ykt_classroom_warning_student
查询指定班级的预警学生名单。
典型问法： "高等数学A-2 的预警学生" / "第 1 个班级的预警名单"
参数：
| 参数 | 必填 | 说明 |
|------|------|------|
| classroomName | 是 | 班级名称、序号或可识别简称 |
交互规则：
ykt_classroom_warning_overview 展示总览，再让用户选择。6. cube_teacher_today_teaching
查询当天授课情况（到课率、答题率等）。
典型问法： "今天上课情况怎么样" / "今天有多少人来上课了"
参数： 无
7. ykt_classroom_id_by_name
通过班级名称查询班级 ID（辅助工具，通常由其他工具间接调用）。
参数：
| 参数 | 必填 | 说明 |
|------|------|------|
| classroomName | 是 | 班级名称 |
8. cube_lesson_reservation
为指定教学班预约开课。
参数：
| 参数 | 必填 | 说明 |
|------|------|------|
| classroomId | 是 | 班级 ID |
| startDateTime | 否 | 开课时间（字符串） |
| startEpochMs | 否 | 开课时间（毫秒时间戳） |
| lessonTitle | 否 | 课次标题 |
| lessonDurationMinutes | 否 | 课次时长（分钟） |
| meetingType | 否 | 会议类型 |
使用逻辑：
ykt_classroom_id_by_name 获取 classroomId，再调本工具classroomId → 直接调用> 详细参数说明见 references/api_references.md 中 cube_lesson_reservation 部分。
9. ykt_teacher_correct_statistic - 教师待批改/已批改统计
用于按课程班级查询教师的作业、考试、课堂、课件批改统计，包括待批改、已批改数量等信息。
适用场景： 当用户有以下意图时，应使用本工具：
10. ykt_recent_exercise_submit - 教师发布的作业完成情况
用于查询教师发布作业完成情况
参数:
| 参数 | 必填 | 说明 |
|------|------|------|
| classroomId | ❌ | 班级 ID |
| classroomName | ❌ | 班级名称 |
| isLatest | ❌ | 1 表示仅查询最近一次；不传表示查询最近三天 |
使用逻辑：
ykt_classroom_id_by_name 获取 classroomId，再调本工具classroomId → 直接调用isLatest = 1 11. ykt_recent_notice_read - 教师发布的公告阅读情况
用于查询用户发布的所有近7天发布公告，按照发布时间顺序倒序排列
参数:
| 参数 | 必填 | 说明 |
|------|------|------|
| classroomId | ❌ | 班级 ID |
| classroomName | ❌ | 班级名称 |
| isLatest | ❌ | 1 表示仅查询最近一次；不传表示查询最近七天 |
使用逻辑：
ykt_classroom_id_by_name 获取 classroomId，再调本工具classroomId → 直接调用isLatest = 1