如何快速上手yatori-go-console:5分钟部署你的第一个课程助手(Windows新手完整教程)

原创2026-11-16 14:12:271,452 阅读

如何快速上手yatori-go-console:5分钟部署你的第一个课程助手(Windows新手完整教程)

yatori-go-console(Yatori 课程助手)是一款免费开源的线上课程自动学习工具,支持英华慕课(英华学堂及各高校套壳平台)、超星学习通、学习公社、CQIE、码上研训等平台,可自动刷课、自动考试、多账号同刷,Windows 用户无需安装任何运行环境。本教程面向新手,带你 5 分钟完成第一次部署。

一、认识项目:yatori-go-console 能帮你做什么

yatori-go-console 是独立运行的桌面程序,不依赖浏览器,启动后按配置文件自动执行学习任务。核心特性一览:

特性 说明
独立程序,不依赖浏览器 解压即用,无需打开网页
多账号同刷 多个账号并行学习
AI 自动识别跳过验证码 AI 大模型加持答题与验证
自动考试 支持 AI 答题、外置题库答题
状态邮箱通知 任务完成后邮件通知指定邮箱
自动继续上次记录时长 再次运行不会从头开始
Docker 容器化部署 可部署到 Linux 服务器

yatori-go-console 课程助手项目形象图

二、支持平台对照表:部署前先确认你的平台

部署前先确认你的平台对应的 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 已开源,仅供技术学习交流,请合理使用。按照上面的步骤操作,你应该已经完成了第一个课程助手的部署,祝学习顺利!

📁 关键项目文件速查:

登录后查看全文
yatori-go-console