개발자 터미널 명령어

명령어 참고 문서 · v4.23.7

RandomSeats의 설정, 추첨, 학생, 자리, 조, 기록과 로컬 데이터를 명령으로 관리하는 개발자 모드 전용 도구입니다. 개발자 모드에서 터미널을 팝업 또는 화면 옆 고정으로 열 수 있으며, 좁은 화면에서는 고정 모드가 하단 패널로 자동 전환됩니다.

빠른 시작

› help › config list › tool group › run group 6 › let target "홍길동" › students absent $target

기본 명령

명령	설명	예시
help [명령어]	명령어 전체 목록 또는 일치하는 명령 도움말을 표시합니다.	`help students`
status	현재 기능, 학생 수, 결과, 공정 모드, 시드와 변수 상태를 표시합니다.	`status`
tool seats\|pick\|group	자리뽑기, 학생뽑기, 조짜기로 화면을 전환합니다.	`tool seats`
run [기능] [값]	기능을 실행합니다. 학생뽑기의 값은 인원, 조짜기의 값은 조 개수입니다.	`run pick 3`
reset [기능]	선택한 기능의 초기화 절차를 실행합니다.	`reset group`
render	현재 기능 결과를 저장된 상태로 다시 그립니다.	`render`
open 대상	설정, 학생관리, 기록, 내보내기, 정보, 패치노트 또는 계정 화면을 엽니다.	`open settings`
docs \| man	이 명령어 문서를 새 탭으로 엽니다.	`docs`

자리 직접 제어

행과 열은 각각 1부터 시작하는 전체 자리 그리드 좌표입니다. seat list로 현재 학생 좌표를 먼저 확인할 수 있습니다.

명령	설명	예시
seat list \| find "이름"	현재 배치와 잠금 상태를 표시하거나 학생 좌표를 찾습니다.	`seat find "홍길동"`
seat assign "이름" 행 열	비어 있는 활성 자리에 학생을 직접 배치합니다.	`seat assign "홍길동" 2 3`
seat clear 행 열	자리의 학생과 잠금을 함께 해제합니다.	`seat clear 2 3`
seat lock\|unlock 행 열	배치된 자리를 잠그거나 잠금을 해제합니다.	`seat lock 2 3`
seat enable\|disable 행 열	자리 칸을 활성화하거나 비활성화합니다.	`seat disable 6 5`
seat swap 행1 열1 행2 열2	두 활성 자리의 학생을 교환합니다.	`seat swap 2 3 4 5`

설정

› config list › config get fairMode › config set fairMode off › config set groupGenderMode mixed › config set devConsoleLayout dock

지원 설정: theme, pngTheme, language, fontSize, simpleMode, fairMode, deskVisible, teacherView, genderless, resetLocked, slotAnim, swapEnabled, disabledSwap, manualMode, pickDefaultCount, pickExcludePicked, groupDefaultMode, groupDefaultValue, groupGenderMode, gridRows, gridCols, devConsoleLayout.

학생과 조

명령	설명	예시
students list	번호, 이름, 성별과 결석 상태를 표시합니다.	`students list`
students add 번호 "이름" [성별]	학생을 추가합니다. 성별은 male, female 또는 none입니다.	`students add 7 "홍길동" male`
students remove "이름"	학생과 연결된 결과·강조 데이터를 확인 후 삭제합니다.	`students remove "홍길동"`
students absent\|present "이름"	결석을 지정하거나 해제합니다. `present all`도 지원합니다.	`students absent "홍길동"`
students bold\|unbold "이름"	이름 굵게를 지정하거나 해제합니다.	`students bold "홍길동"`
students color "이름" 색상	#RRGGBB 색상을 지정합니다. clear로 해제합니다.	`students color "홍길동" #3772FF`
group list\|add	현재 조를 표시하거나 빈 조를 추가합니다.	`group add`
group delete 번호	조를 삭제하고 조원이 있으면 남은 조에 재배치합니다.	`group delete 3`
group rename 번호 "이름"	조 이름을 변경합니다.	`group rename 1 "발표조"`
group move "이름" 번호	학생을 지정한 조로 이동합니다.	`group move "홍길동" 2`
group swap "학생1" "학생2"	두 학생의 조를 서로 바꿉니다.	`group swap "홍길동" "김하늘"`
group lock\|unlock "이름"	다시 조를 짤 때 현재 조에 학생을 고정하거나 해제합니다.	`group lock "홍길동"`
class get\|set	반 이름을 확인하거나 변경합니다.	`class set "1학년 1반"`

제약 조건

› constraints seats add near "홍길동" "김하늘" 1 › constraints group add apart "홍길동" "김하늘" › constraints seats list › constraints group remove 1

자리 제약 종류는 near·far, 조 제약 종류는 together·apart입니다. clear로 전체 삭제할 때는 터미널에서 y/N 확인을 받습니다.

반 슬롯

› profiles list › profiles create "1학년 2반" › profiles use 2 › profiles rename 2 "방과후반" › profiles delete 2

슬롯은 목록 번호 또는 정확한 이름으로 지정합니다. 전환할 때 현재 슬롯은 먼저 저장되며, 삭제는 터미널에서 y/N 확인을 거칩니다.

시드

시드 지정

seed set 1234는 자리·학생·조 추첨이 함께 사용하는 32비트 시드를 설정합니다. seed random은 새 번호를 생성합니다.

재현 조건

같은 학생, 설정, 기록과 같은 시드 상태에서 같은 결과가 나옵니다. seed reset으로 시퀀스를 처음으로 돌립니다.

암호학적 무작위

seed clear를 실행하면 시드를 해제하고 브라우저의 암호학적 난수로 돌아갑니다.

공정 모드

공정 모드가 켜져 있으면 기록 점수도 결과에 영향을 줍니다. 시드만 같고 기록이 다르면 결과가 달라질 수 있습니다.

변수와 인수

› let student "김 은성" › students bold "$student" › vars › unset student

변수 이름은 영문자 또는 밑줄로 시작해야 합니다. $name과 ${name} 형식을 지원하며, 공백이 있는 값은 따옴표로 묶습니다. 변수는 로컬 설정·클라우드 동기화·전체 JSON 내보내기에 포함되므로 비밀번호, 토큰과 같은 비밀 값은 저장하지 마세요.

기록과 데이터 삭제

명령	범위	보호 장치
history clear all\|seats\|pick\|group	선택한 추첨 기록	터미널 `y/N`
data clear results	현재 자리·학생·조 결과와 잠금	터미널 `y/N`
data clear students	학생 명단, 강조, 결석과 현재 결과	터미널 `y/N`
data clear variables	터미널 변수	터미널 `y/N`
data clear all	현재 출처의 `rs_`로 시작하는 RandomSeats 로컬 데이터	`y/N` 확인 후 앱 재시작

주의: 삭제 명령은 임의 JavaScript 실행으로 우회할 수 없습니다. 위험 명령은 터미널 입력란에서 y를 입력해야 실행되며, Enter 또는 N은 취소로 처리됩니다. data clear all은 다른 사이트 데이터가 아닌 RandomSeats 전용 키만 삭제합니다.

진단 명령

storage 저장 공간 확인 · sync 클라우드 강제 동기화 · ping 서버 응답 확인 · version 버전 확인 · download 로그 저장 · clear 콘솔 출력 지우기