SSAFY Shell Tools - 기능 가이드

🚀 1. 실습 시작 (gitup)

🔹 gitup

인증 토큰이나 실습실 URL을 붙여넣어 실습 환경을 자동으로 생성하고 엽니다.

gitup

SSAFY@PC MINGW64 ~/Desktop/lab/ $ gitup 🔐 [Secure Mode] Smart Link(URL|Token) 또는 URL을 붙여넣으세요. 👉 Paste Here (Ctrl+V + Enter):

📌 Smart Batch (일괄 생성) - gitup 실행 시 자동 적용

SSAFY 실습실 URL을 붙여넣으면 여러 개의 저장소를 자동으로 감지하여 모두 처리합니다.

🚀 SSAFY 실습실 일괄 생성 및 클론 모드 (Smart Batch) ⏳ 실습실 생성 및 URL 분석 중... ------------------------------------------------------------ 👉 PR_001 확인... ✅ https://lab.ssafy.com/user/sample_ws_01 👉 PR_002 확인... ✅ https://lab.ssafy.com/user/sample_ws_02 👉 PR_003 확인... ✅ https://lab.ssafy.com/user/sample_hw_02 ------------------------------------------------------------ 📦 총 3개의 저장소를 처리합니다. ✅ 일괄 작업 완료!

📤 2. 제출 및 업로드 (gitdown)

🔹 gitdown (기본 제출)

현재 폴더의 작업을 커밋하고 푸시합니다. 메시지는 설정된 커밋 접두사(Prefix)에 따라 자동 생성됩니다.

$ gitdown [main a1b2c3d] solve: sample_ws_01 🚀 Pushed to origin/main successfully.

📌 커밋 메시지 직접 작성하기 (-m)

$ gitdown -m "feat: 알고리즘 1번 문제 풀이 완료" [main b2c3d4e] feat: 알고리즘 1번 문제 풀이 완료 ...

🔹 gitdown -a (일괄 제출)

현재 위치의 모든 하위 폴더를 검사하여 변경사항이 있는 것들을 한 번에 제출합니다.

$ gitdown -a 📦 [일괄 커밋/푸시 모드] ------------------------------------------------------------ [1/3] sample_ws_01... ✅ 커밋 & 푸시 완료 [2/3] sample_ws_02... ✅ 커밋 & 푸시 완료 [3/3] sample_hw_02... ⏭️ 변경사항 없음 (스킵) ------------------------------------------------------------ ✅ 일괄 작업 완료! (2/3 제출됨)

🔹 자동 이동 기능

gitdown 후 푸시가 성공하면 자동으로 다음 문제 폴더로 이동합니다.

$ gitdown [main a1b2c3d] solve: sample_ws_01 🚀 Pushed to origin/main successfully. ➡️ 다음 문제로 자동 이동: sample_ws_02 $ pwd ~/Desktop/lab/sample_ws_02

🔹 제출 링크 자동 생성

일괄 제출(-a) 후에는 SSAFY 실습실 제출 페이지 링크가 자동으로 표시됩니다.

✅ 일괄 작업 완료! 📋 제출 링크 목록: 1. sample_ws_01: https://project.ssafy.com/practiceroom/course/.../practice/.../detail 2. sample_ws_02: https://project.ssafy.com/practiceroom/course/.../practice/.../detail 👉 번호 입력 (0=전체 열기, Enter=건너뛰기):

⚙️ 3. 설정 관리 (algo-config)

🔹 명령어 안내

algo-config show : 현재 적용된 설정을 확인합니다.
algo-config edit : Python 설정 마법사가 실행되어 대화형으로 설정을 변경합니다.
algo-config reset : 설정을 초기화합니다.

⚠️ 주의: algo-config reset을 실행하면 저장된 토큰 등 모든 설정이 삭제됩니다.

🔹 algo-config edit (설정 마법사)

algo-config edit 실행 시 아래와 같은 Python TUI 메뉴가 표시됩니다:

$ algo-config edit ===== SSAFY Shell Tools 설정 마법사 ===== 현재 설정: 📁 작업 디렉토리: /home/user/algorithm 💻 IDE: code (VS Code) 🔑 토큰: ●●●●●●●●●●●● 👤 ID: ssafy_user 메뉴: 1. 📁 작업 디렉토리 변경 2. 💻 IDE 변경 (code/pycharm/idea) 3. 🔑 SSAFY 토큰 설정 4. 👤 SSAFY ID 설정 0. 💾 저장 및 종료 q. ❌ 취소 선택:

🔹 커밋 접두사(Prefix) 변경 방법

기본값인 solve:를 다른 단어(예: fix:, docs:)로 바꾸고 싶다면:

~/.algo_config 파일을 직접 편집하세요.
설정 파일에서 GIT_COMMIT_PREFIX 항목을 찾아 수정하세요.

$ nano ~/.algo_config # 변경 전 GIT_COMMIT_PREFIX="solve" # 변경 후 GIT_COMMIT_PREFIX="docs"

🔄 4. 도구 업데이트 (algo-update)

🔹 algo-update

SSAFY Shell Tools를 최신 버전으로 업데이트합니다.

$ algo-update 🔄 업데이트 확인 중... Fetching origin... ✅ 최신 버전으로 업데이트 완료! (V7.5.2) 🔃 셸을 재시작합니다...

💡 자동 업데이트: 셸 시작 시 24시간마다 백그라운드에서 업데이트를 자동 확인합니다.

🩺 5. 시스템 진단 (algo-doctor)

🔹 algo-doctor

설치 상태와 설정을 자동으로 진단하여 문제를 파악합니다.

$ algo-doctor 🩺 SSAFY Shell Tools 진단 (V7.5.2) ============================================ [1/4] 필수 도구 확인 git ✅ 설치됨 curl ✅ 설치됨 python ✅ 설치됨 [2/4] 보안 점검 설정 파일 권한 ✅ 600 (안전) 토큰 인코딩 ✅ Base64 인코딩됨 [3/4] IDE 점검 IDE_EDITOR ✅ code (실행 가능) [4/4] 서버 연결 SSAFY 토큰 ✅ 유효함 ============================================ 🎉 모든 항목이 정상입니다!

⬅️ 설치 포털로 돌아가기

🛠 Git & Config 가이드