القائمة
烟草网络学院 (mooc.ctt.cn) 自动学习脚本。支持刷学时、刷专题、刷课程、刷任务四种模式。 触发词：烟草、网络学院、mooc、自动学习、学时、cttc、刷专题、刷课程、刷任务。 安装：`npx skills add gandli/cttc-auto-learn` 用户只需说"帮我刷学时"，Agent 自动完成全部流程。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | cttc-auto-learn |
| description | 烟草网络学院 (mooc.ctt.cn) 自动学习脚本。支持刷学时、刷专题、刷课程、刷任务四种模式。 触发词：烟草、网络学院、mooc、自动学习、学时、cttc、刷专题、刷课程、刷任务。 安装：`npx skills add gandli/cttc-auto-learn` 用户只需说"帮我刷学时"，Agent 自动完成全部流程。 |
| tags | ["playwright","automation","china-tobacco","video","agent-workflow"] |
| project_url | https://github.com/gandli/cttc-auto-learn |
用户只需安装此 SKILL，说"帮我刷学时"即可。Agent 自动完成环境搭建、登录、学习。
npx skills add gandli/cttc-auto-learn
# 检查项目是否存在
if [ ! -d ~/Desktop/cttc-auto-learn ]; then
git clone https://github.com/gandli/cttc-auto-learn.git ~/Desktop/cttc-auto-learn
fi
cd ~/Desktop/cttc-auto-learn
cd ~/Desktop/cttc-auto-learn
uv sync
# 清除 Python 缓存
find . -name "__pycache__" -type d -exec rm -rf {} + 2>/dev/null || true
注意： 不要使用 taskkill //F //IM chrome.exe，这会误杀 Hermes Agent 的浏览器进程。脚本会自动清理自己的 Chrome 进程。
检查凭证文件是否存在且有效：
ls output/auth-state.json 2>/dev/null
如果不存在或已过期，需要用户扫码登录：
cd ~/Desktop/cttc-auto-learn
uv run python main.py
登录流程特性：
framenavigated)，扫码后立即检测成功二维码图片位置：
output/qrcode-app.png — APP 扫码output/qrcode-wechat.png — 微信扫码登录成功后，根据用户需求运行对应模式：
cd ~/Desktop/cttc-auto-learn
# 刷学时（默认）
uv run python main.py --mode hours --target 50 --headless
# 刷专题
uv run python main.py --mode topics --headless
# 刷课程
uv run python main.py --mode courses --headless
# 刷任务
uv run python main.py --mode tasks --headless
参数说明：
--mode — 运行模式（hours/topics/courses/tasks）--target — 目标学时（默认 50）--unlimited — 无限制模式（跳过目标检查，持续刷课）--headless — 无头模式（推荐，不显示浏览器窗口）| 模式 | 命令 | 说明 |
|---|---|---|
| 刷学时 | uv run python main.py --mode hours | 播放视频累计学时（默认） |
| 刷专题 | uv run python main.py --mode topics | 完成专题课程 |
| 刷课程 | uv run python main.py --mode courses | 完成所有未完成课程 |
| 刷任务 | uv run python main.py --mode tasks | 完成指定任务 |
触发词对应模式：
--mode hours--mode topics--mode courses--mode tasks登录后自动获取全部数据，保存到 data/ 目录：
| 文件 | 内容 | API |
|---|---|---|
data/courses.json | 我的课程 | personCourse-list |
data/topics.json | 我的专题 | DOM 托底 |
data/tasks.json | 我的任务 | /api/v1/human/task |
data/study_stats.json | 学时统计 | credit/detail-hour-member |
查看数据报告：
uv run python scripts/list_courses.py
# Windows
tasklist | findstr python
# 或检查进程
ps aux | grep main.py
脚本运行时会自动更新 output/status.json：
cat output/status.json
status.json 字段说明：
| 字段 | 说明 |
|---|---|
status | 当前状态：playing / idle / error |
current_video | 正在播放的视频名称 |
video_progress | 视频播放进度（百分比） |
study_hours_current | 当前学时 |
study_hours_target | 目标学时 |
courses_completed | 已完成课程数 |
courses_pending | 待学习课程数 |
errors_count | 错误次数 |
Agent 可以定期读取 status.json 并向用户汇报：
📊 学习进度汇报：
- 学时：33/50 小时 (66%)
- 当前视频：《资本论》导读 (22.4%)
- 已完成：261 门
- 待学习：75 门
- 状态：🟢 正常运行
| 参数 | 默认值 | 说明 |
|---|---|---|
--mode | hours | 运行模式 |
--target | 50.0 | 目标学时 |
--headless | False | 无头模式 |
现象： 日志出现 40909
原因： 多个脚本实例或浏览器会话同时访问同一课程
解决： 等待 30 秒自动重试，或关闭其他浏览器窗口
现象： 日志出现 40904
原因： studyTime 必须是增量值（≤30秒），不能等于 lessonLocation
解决： 脚本已自动处理，无需干预
现象： 日志出现浏览器相关错误 解决： 脚本会自动恢复（最多 5 次），如持续崩溃请重启脚本
现象： status.json 中 study_hours_current 不变 原因： 可能是视频未完全播放完成 解决： 检查 video_progress 是否达到 100%
现象： 扫码后无反应 解决： 脚本会自动刷新二维码，重新扫码即可
finishStatus=2, completedRate=100%