프로젝트 구조 이해
| 파일/디렉터리 | 기능 설명 |
|---|---|
| main.py | 메인 실행 파일로, 로그인, 비디오 재생, прогресс 모니터링 등의 핵심 기능을 관리합니다. |
| configurations.ini | 계정 정보, 브라우저 설정, 강의 링크 등의 중요 설정을 저장합니다. |
| dependencies.txt | 프로젝트에 필요한 모든 Python 패키지를 나열합니다. |
| modules/ | 로그인 검증, 비디오 처리, прогресс 추적 등의 하위 모듈이 들어 있습니다. |
| resources/ | 캡차 인식, 브라우저 드라이버 등의 보조 파일을 저장합니다. |
핵심 구성 파일 설명
2.1 구성 파일 위치 및 형식
구성 파일 이름은 configurations.ini이며, 프로젝트 루트 디렉터리에 있습니다. "섹션-키=값" 형식으로 작성되어 있습니다. 모든 설정 값을 직접 수정할 수 있습니다.
2.2 핵심 설정 항목
| 구성 섹션 | 설정 이름 | 설명 | 예제 값 |
|---|---|---|---|
| [user-info] | user_id | 스마트 트리 계정 | your@email.com |
| user_pass | 계정 비밀번호 | yourpassword | |
| [browser-settings] | browser_type | 사용할 브라우저 유형 | Chrome, Edge |
| [script-settings] | auto_captcha_enabled | 자동 캡차 검증 여부 | True, False |
| [course-settings] | max_learning_time | 한 강의당 최대 학습 시간 (분) | 30 (0는 제한 없음) |
| playback_speed | 비디오 재생 속도 | 1.0 (최대 1.8까지) | |
| mute_mode | 음소거 모드 | True | |
| [course-links] | course_url1 | 강의 재생 페이지 링크 | https://... |
| course_url2 | 추가 강의 링크 | https://... |
초보자용 설치 단계
3.1 사전 준비
- Python 3.8 이상 버전 설치 완료确认
- 프로젝트 소스 코드 다운로드:
git clone https://gitcode.com/gh_mirrors/au/Autovisor
3.2 의존성 패키지 설치
터미널 창에서 프로젝트 디렉터리로 이동 후 다음 명령 실행:
pip install -r dependencies.txt
playwright install스크립트 사용 시작
4.1 구성 파일 설정
텍스트 에디터로 configurations.iniを開いて 다음 단계 수행:
[user-info]섹션에 계정 정보 입력[course-links]섹션에 강의 링크 추가- 기타 설정을 원하는 대로 수정
4.2 스크립트 실행
프로젝트 디렉터리에서 다음 명령 실행:
python main.py최초 실행 시 필요한 컴포넌트 설치가 자동으로 진행됩니다.
4.3 실행 과정 설명
- 자동으로 계정으로 로그인하고 강의를 차례로 학습합니다.
- 비디오는 설정된 배속으로 음소거 모드에서 재생됩니다.
- 퀴즈 점프 등의 작업을 자동으로 수행합니다.
- progress 상태가 콘솔에 실시간 표시됩니다.
- 강의 완료 후 자동으로 다음 강의로 전환합니다.
흔히 발생하는 문제 해결
5.1 브라우저 시작 실패
[browser-settings]섹션에서(browser_type)를 확인하고 Chrome/Edge만 사용- 브라우저가 설치되었더라도(EXE_PATH)에 실제 실행 파일 경로 지정
5.2 강의 로딩 실패
[course-links]섹션의 URL가 정확한 강의 재생 페이지인지 확인- 계정이 강의에 가입했는지 확인
5.3 캡차 검증 실패
auto_captcha_enabled를 False로 설정하고 수동으로 검증 완료 후 진행- 인터넷 연결 상태를 확인
고급 기능 설정
6.1 브라우저 숨기기
enable_background_mode를 True로 설정하면 브라우저 창이 최소화되고 백그라운드에서 실행됩니다.
6.2 학습 시간 제한
max_learning_time를 조정하여 각 강의당의 최대 학습 시간을 제어할 수 있습니다.
6.3 여러 강의 연속 학습
[course-links] 섹션에(course_url1, course_url2, ...)를 추가하면 순차적으로 학습합니다.