如何快速上手yatori-go-console:5分钟部署你的第一个课程助手(Windows新手完整教程)
如何快速上手yatori-go-console:5分钟部署你的第一个课程助手(Windows新手完整教程)
yatori-go-console(Yatori 课程助手)是一款免费开源的线上课程自动学习工具,支持英华慕课(英华学堂及各高校套壳平台)、超星学习通、学习公社、CQIE、码上研训等平台,可自动刷课、自动考试、多账号同刷,Windows 用户无需安装任何运行环境。本教程面向新手,带你 5 分钟完成第一次部署。
一、认识项目:yatori-go-console 能帮你做什么
yatori-go-console 是独立运行的桌面程序,不依赖浏览器,启动后按配置文件自动执行学习任务。核心特性一览:
| 特性 | 说明 |
|---|---|
| 独立程序,不依赖浏览器 | 解压即用,无需打开网页 |
| 多账号同刷 | 多个账号并行学习 |
| AI 自动识别跳过验证码 | AI 大模型加持答题与验证 |
| 自动考试 | 支持 AI 答题、外置题库答题 |
| 状态邮箱通知 | 任务完成后邮件通知指定邮箱 |
| 自动继续上次记录时长 | 再次运行不会从头开始 |
| Docker 容器化部署 | 可部署到 Linux 服务器 |
二、支持平台对照表:部署前先确认你的平台
部署前先确认你的平台对应的 accountType 值(全大写):
| 平台 | accountType 值 | 备注 |
|---|---|---|
| 英华学堂(英华慕课/各高校英华套壳) | YINGHUA |
url 必须填自己学校的平台链接 |
| 仓辉实训 | CANGHUI |
|
| 海旗科技 | HQKJ |
|
| 学习公社 / 大学生网络党校 / 中小学网络党校 | ENAEA |
url 可省略 |
| 超星学习通 | XUEXITONG |
url 可省略 |
| 重庆工程学院 CQIE | CQIE |
url 可省略 |
| 码上研训 | KETANGX |
默认秒刷 |
| Welearn 随行课堂 | WELEARN |
|
| 智慧职教(资源库) | ICVE |
推荐 Cookie 登录 |
| 青书学堂 | QSXT |
💡 示例配置文件 command/config.yaml 中每一项都有中文注释,并附完整平台类型清单。
三、一键部署步骤:Windows 下 5 分钟跑通课程助手
步骤 1(约 1 分钟):下载并解压 Windows 包
到项目 Releases 页面下载最新的 Windows 压缩包并解压,目录中应包含以下 4 个文件:
| 文件 | 作用 |
|---|---|
yatori-go-console.exe |
主程序 |
config.yaml |
配置文件,唯一需要修改的文件 |
start.bat |
一键启动脚本 |
配置文件生成器.html |
可视化配置生成器,用浏览器打开 |
步骤 2(约 2 分钟):修改 config.yaml,只需改 4 项
配置文件的核心是 users 列表,新手只需修改这 4 项:
users:
- accountType: "YINGHUA" # ① 平台类型,见上方对照表
url: "你学校的平台链接" # ② 必须填自己学校的链接
account: "你的账号" # ③ 你的账号
password: "你的密码" # ④ 你的密码
⚠️ 常见坑:url 一定要用自己学校的平台链接,每个学校都不同,可自己去找或询问同学。
其余选项(刷课模式、自动考试、邮箱通知等)保持默认值即可,示例配置逐行都有中文注释。如果担心配置文件写错,可双击 配置文件生成器.html 图形化生成(command/配置文件生成器.html);即使完全没放 config.yaml,程序也会在控制台交互式引导你生成一份(logic/Lunch.go)。
步骤 3(约 1 分钟):双击 start.bat 启动
start.bat 的内容其实只有 3 行(command/start.bat):
@echo off
yatori-go-console.exe
@pause
双击启动后,控制台会显示 Yatori Logo 和公告,随后按账号开始执行任务,全部完成后打印"所有任务执行完毕"。
步骤 4:确认运行状态
- ✅ 彩色日志默认开启,控制台乱码时把
colorLog改为0 - ✅
logOutFileSw为1时,日志持续写入assets/log目录 - ✅ 默认播放完成提示音(
completionTone控制开关)
四、config.yaml 新手常用配置项清单
除上面 4 项外,最常用到的还有这些配置项:
| 配置项 | 说明 |
|---|---|
videoModel |
0=不刷、1=普通模式、2=暴力模式、3=英华去红模式/学习通多任务点模式 |
autoExam |
0=不考试、1=AI 考试、2=外置题库答题、3=学习通内置 AI |
examAutoSubmit |
0=不自动交卷、1=自动交卷、2=智能提交 |
includeCourses / excludeCourses |
只刷指定课程 / 不刷指定课程(填课程名称) |
informEmails |
任务执行完毕后需要通知的邮箱 |
aiSetting.API_KEY |
AI 平台密钥,使用 AI 答题时必填 |
💡 控制台(非 Web)模式下最多同时配置 5 个账号(logic/Lunch.go),更多账号建议使用下方的 Web 管理模式。
五、进阶配置:Web 管理模式与 Docker 部署
Web 管理模式:图形界面添加账号
不想每次改 yaml,可以启用 Web 管理模式:
yatori-go-console.exe --web
首次带 --web 启动会自动生成一份不含账号的基础 config.yaml,服务启动后在浏览器打开:
http://localhost:8092/web/
在「账号管理」页面即可添加账号、课程配置和 AI 配置。账号数据保存在本地 yatori.db(SQLite 数据库),不再写入 config.yaml(web/ServerInit.go、logic/Lunch.go)。默认端口 8092 可通过环境变量 YATORI_WEB_ADDR 覆盖。
Docker 部署:Linux 服务器最快配置方法
仓库自带 Dockerfile,采用三阶段构建:先构建前端(Next.js),再编译 Go 程序,最后打包成配置了北京时区的精简运行镜像。
⚠️ Linux 用户推荐直接使用 Docker 版本:官方 Linux 可执行文件在 glibc 2.35 环境下编译,CentOS 7 等老系统可能报 glibc 版本过低的错误。
六、常见问题排查清单
| 现象 | 原因与解决方法 |
|---|---|
| 提示"找不到配置文件或配置文件内容书写错误" | config.yaml 缺失或 YAML 语法错误;也检查是否被误命名为 config(1).yaml 等 |
| 仓辉平台卡住、一直刷屏报错 | 你的平台可能是英华套壳,把 accountType 由 CANGHUI 改为 YINGHUA |
| 控制台输出乱码 | 将 basicSetting.colorLog 设为 0 关闭彩色日志 |
| 提示"Yatori-go-console 已在运行,请勿重复启动" | 程序有重复启动锁,先关闭已运行的进程 |
| 英华类平台无法启动 | url 必须填写自己学校的完整 http 链接 |
| Linux 报 glibc 版本过低 | 改用 Docker 部署 |
七、写在最后
yatori-go-console 已开源,仅供技术学习交流,请合理使用。按照上面的步骤操作,你应该已经完成了第一个课程助手的部署,祝学习顺利!
📁 关键项目文件速查:
- command/config.yaml — 带注释的示例配置
- command/start.bat — Windows 一键启动脚本
- command/配置文件生成器.html — 可视化配置生成器
- logic/Lunch.go — 启动流程、交互式配置生成与 Web 模式入口
- web/ServerInit.go — Web 管理服务初始化
- config/Config.go — 配置结构定义
- Dockerfile — Docker 三阶段构建
- README.md — 完整功能清单与支持平台状态
