AP Classroom 作业自动化 - 通用版

专门用于完成所有 AP Classroom 学科的作业，包括 Reading Quiz、Writing Quiz、Progress Check、Practice Exam 等。

⚠️ 重要规则

在任何情况下都不会关闭当前 Chrome 浏览器，除非先询问用户。

🎯 支持的课程

本 skill 支持所有 AP 课程，包括但不限于：

• AP English Language and Composition (AP Lang)
• AP English Literature and Composition (AP Lit)
• AP Statistics
• AP Calculus AB/BC
• AP Computer Science A
• AP Computer Science Principles
• AP Biology
• AP Chemistry
• AP Physics 1/2/C
• AP World History
• AP US History
• AP European History
• AP Psychology
• AP Macroeconomics
• AP Microeconomics
• 其他所有 AP 课程

🚀 快速开始

1. 启动浏览器（调试模式）

Start-Process "C:\Program Files\Google\Chrome\Application\chrome.exe" `
  -ArgumentList "--remote-debugging-port=9223"

2. 登录 College Board

在浏览器中手动登录 College Board 账号。

3. 选择课程

cd ~/.agents/skills/ap-classroom
node select-course.js

或者在任务管理器中选择 [C] 切换课程。

4. 开始做作业

# 使用任务管理器（推荐）
.\start.bat

# 或直接使用命令
node check-homework.js

📋 完整工作流程

步骤 1: 检查当前课程

node check-browser-status.js

显示当前登录的课程和用户信息。

步骤 2: 切换课程（如需要）

node select-course.js

从可用课程列表中选择。

步骤 3: 检查作业

node check-homework.js

显示当前课程的所有待完成作业。

步骤 4: 完成作业

使用任务管理器或命令行工具完成作业。

🛠️ 工具脚本

基础工具

作业操作工具

自动化工具

🎓 课程管理

查看所有课程

node list-courses.js

显示当前账号下所有可用的 AP 课程。

切换课程

方法 1: 使用脚本

node select-course.js

方法 2: 使用任务管理器

• 启动任务管理器
• 选择 [C] 切换课程
• 从列表中选择课程

方法 3: 手动导航

• 在浏览器中点击课程名称
• 进入对应课程的 AP Classroom

课程信息存储

当前选择的课程信息保存在 current-course.json：

{
  "name": "AP English Language and Composition",
  "id": "12",
  "student": "Rock",
  "lastChecked": "2026-03-19T10:00:00Z"
}

📊 作业类型支持

通用作业类型

所有 AP 课程都支持以下作业类型：

1. Reading Quiz - 阅读理解测验
2. Writing Quiz - 写作技巧测验
3. Progress Check - 进度检查
4. Practice Exam - 练习考试
5. Unit Test - 单元测试
6. Timed Writing - 计时写作
7. FRQ - 自由回答题
8. MCQ - 多项选择题

特殊作业类型

某些课程可能有特殊作业类型，本 skill 也支持：

• Lab Report (AP Sciences)
• Portfolio (AP Art)
• Performance Task (AP CSP)

💡 使用建议

多课程管理

如果你同时修多门 AP 课程：

1. 使用任务管理器 - 可以快速切换课程
2. 定期检查所有课程 - 避免遗漏作业
3. 按优先级处理 - 先处理截止日期近的作业

批量完成作业

# 1. 检查所有课程的作业
node check-all-courses.js

# 2. 查看优先级排序
node priority-list.js

# 3. 逐个完成
# ... 使用任务管理器或命令行工具

🔧 高级功能

1. 自动检测课程

脚本会自动检测当前浏览器中打开的课程：

// 自动获取课程 ID
const courseId = await page.evaluate(() => {
  const url = window.location.href;
  const match = url.match(/\/(\d+)\/assignments/);
  return match ? match[1] : null;
});

2. 课程特定配置

可以为不同课程创建特定配置：

// course-config.json
{
  "12": {
    "name": "AP English Language and Composition",
    "shortName": "AP Lang",
    "color": "blue"
  },
  "33": {
    "name": "AP Statistics",
    "shortName": "AP Stats",
    "color": "green"
  }
}

3. 批量检查

检查所有课程的作业：

node check-all-courses.js

📝 配置文件

current-course.json

当前选择的课程信息。

course-config.json

课程特定配置（可选）。

homework-history.json

作业完成历史记录。

🔄 更新记录

• 2026-03-19 v2.0.0: 重构为通用版，支持所有 AP 课程
• 2026-03-19 v1.0.0: 初始版本，仅支持 AP Lang

📞 需要帮助？

• 查看 QUICKSTART.md 了解快速启动方法
• 查看 README.md 了解详细功能
• 运行 node check-browser-status.js 检查当前状态

⚠️ 提醒: 提交测验前务必确认所有答案！