설치는 한 줄,
그 뒤로는 손댈 것이 없습니다

1-①. 맥이라면 — 워커 앱 설치

⌘ + 스페이스 를 누르고 터미널 이라고 친 뒤 엔터. 그다음 아래를 붙여넣고 엔터.

터미널에 다운로드·설치 진행 상황이 표시됩니다. 중간에 맥 로그인 암호를 한 번 묻습니다. 입력해도 화면에 아무것도 안 보이는 것이 정상입니다. 이름도 한 번 묻습니다 — 본명으로 넣어주세요.

1-②. 윈도우 PC라면 — Intel·AMD·NVIDIA 모두 한 줄

시작 버튼 → powershell 입력 → 오른쪽 클릭 → 관리자 권한으로 실행.

그래픽카드를 자동으로 확인해 NVIDIA는 CUDA, Intel·AMD는 Vulkan으로 설치합니다. 내장그래픽 PC도 가능하며, 메모리가 적으면 동시 처리량을 자동으로 낮춥니다. RAM 16GB 이상, 32GB 권장입니다. 윈도우 PC 는 스캔본 PDF 전담입니다 — 한글(.hwp)·오피스 문서는 맥이 맡습니다.

2. 끝

맥은 화면 위쪽 메뉴바에 ⚙️ 아이콘이, 윈도우는 오른쪽 아래 트레이에 동그란 아이콘이 생기면 완료입니다. 컴퓨터를 껐다 켜도 로그인하면 스스로 다시 시작합니다.

윈도우는 시작 메뉴 → AI Conversions Team 으로 켜고, AI Conversions Team 끄기 (또는 트레이 아이콘 → ⏻ 끄기)로 완전히 끕니다. 끄면 하던 책은 다른 컴퓨터가 이어받고, 다시 켜기 전까지는 로그인해도 뜨지 않습니다.

설치는 처음 한 번 20~40분 걸립니다 — 필요한 프로그램을 내려받아야 합니다. 그 뒤로는 기다릴 일이 없습니다.

윈도우 PC에 원격 지원 열기

설치가 막힐 때, 관리자가 그 PC에 직접 붙어 볼 수 있게 합니다. 관리자 권한 PowerShell에 붙여넣으세요. (시작 버튼 → powershell 입력 → 오른쪽 클릭 → 관리자 권한으로 실행)

끝나면 마지막 줄에 USER=… IP=… 가 찍힙니다. 그 줄을 관리자에게 알려주세요.

관리자가 요청했을 때만 실행하세요. 이 명령은 관리자의 접속 열쇠를 이 PC에 등록합니다. 암호는 오가지 않으며, 나중에 지울 수 있습니다.

맥에 원격 지원 열기

윈도우와 같은 용도 — 설치가 막힐 때 관리자가 이 맥에 직접 붙어 봅니다. 터미널에 붙여넣으세요. 맥 로그인 암호를 한 번 묻습니다.

끝나면 마지막 줄에 USER=… IP=… TS=… 가 찍힙니다. 그 줄을 관리자에게 알려주세요.

관리자가 요청했을 때만 실행하세요. 시스템 설정의 "원격 로그인"을 켜고 관리자의 접속 열쇠를 등록합니다. 암호는 오가지 않습니다. 되돌리기: 시스템 설정 → 일반 → 공유 → 원격 로그인 끄기.

워커가 멈췄을 때 — 되살리기 (맥·윈도우)

대시보드에서 이 컴퓨터가 오프라인인데 컴퓨터는 켜져 있을 때. 설치를 다시 하지 않고 워커만 다시 세웁니다. 이미 돌고 있으면 아무것도 건드리지 않습니다(하던 책이 날아가지 않습니다).

맥 — 터미널:

윈도우 — PowerShell(관리자 아니어도 됨):

순서: 마스터 연결 확인 → 멈춤 스위치 제거 → 워커 재기동 → 25초 뒤 살아났는지 화면에 표시. "마스터에 닿지 않는다"가 나오면 Tailscale 문제이니 그 아래 줄을 관리자에게 보내세요. "설치돼 있지 않다"면 설치 한 줄을 실행하세요. 컴퓨터가 꺼져 있거나 잠들어 있으면 이 명령으로는 안 됩니다 — 켜야 합니다.

메뉴바 ⚙ 가 안 보일 때 (맥)

워커는 도는데 메뉴바에 톱니가 없을 때. 원인은 대개 둘 — 메뉴바가 꽉 차서 맨 왼쪽 아이콘부터 화면 밖으로 밀려났거나, 노치 맥북에서 노치에 가려진 것. 이 명령은 톱니 자리를 시계 옆(오른쪽)으로 정하고 워커를 다시 띄웁니다. 하던 책은 반납됐다가 다시 받습니다.

그래도 안 보이면 메뉴바에 아이콘이 너무 많은 것입니다 — 다른 아이콘을 ⌘ 누른 채 메뉴바 밖으로 끌어내 몇 개 지우세요. 윈도우는 트레이 아이콘이 사라지면 위 "되살리기" 한 줄로 됩니다.

저장 공간 옮기기 — 엔진·모델 캐시를 다른 드라이브로 (이미 참여 중인 컴퓨터)

부팅 디스크가 모자라 워커가 "디스크 여유 부족"으로 쉬고 있을 때. 큰 것(OCR 엔진 약 5GB · 모델 캐시 약 10GB · 작업 임시 폴더)만 다른 드라이브로 옮기고 원래 자리는 링크로 연결합니다. 워커 코드는 그대로이고, 하던 책은 반납됐다가 다시 받습니다.

먼저 첫 부분의 드라이브 이름을 고치세요. 맥은 /Volumes/외장디스크이름(Finder 에 보이는 이름), 윈도우는 E: 를 실제 드라이브 문자로. 그 드라이브는 항상 연결돼 있어야 합니다 — 빼면 워커가 돌지 못합니다.

맥 — 터미널 (2~10분, 옮길 양에 따라):

윈도우 — PowerShell:

새로 설치하는 컴퓨터는 이 명령이 필요 없습니다 — 설치기가 공간이 모자라면 같은 선택지를 알아서 보여 줍니다.

윈도우 PC 상태 진단

설치가 됐는데 작동하지 않을 때. 결과를 그대로 알려주세요.

맥이 자꾸 잠들 때 (이미 참여 중인 맥)

맥이 잠들면 아무도 그 맥에 닿지 못해 함대에서 빠집니다. 작업 중에는 워커가 잠자기를 막지만, 워커가 멈추면 방지도 같이 풀립니다. 이 한 줄이 잠자기 자체를 꺼서 그 상황을 막습니다. 터미널에 붙여넣고 맥 로그인 암호를 한 번 넣으면 됩니다.

화면 꺼짐·화면 잠금·화면보호기는 건드리지 않습니다. 쓰시던 그대로입니다. 새로 참여하는 맥은 설치할 때 자동으로 되므로 이 명령이 필요 없습니다.

Tailscale 완전 제거 (윈도우)

이미 쓰던 Tailscale이 다른 계정에 묶여 있어 설치가 꼬였을 때, 깨끗이 지우고 다시 시작합니다. 관리자 권한 PowerShell에 붙여넣으세요.

보통은 지울 필요가 없습니다. 설치 한 줄이 기존 계정을 건드리지 않고 프로필만 추가하도록 되어 있어서, 이미 Tailscale을 쓰던 PC도 그대로 참여할 수 있습니다. 이 명령은 그래도 안 될 때의 마지막 수단입니다.

지운 뒤에는 관리자 콘솔의 기기 목록에서도 이 PC를 지워야 완전히 정리됩니다. 남아 있어도 다시 설치할 때 자동으로 넘어가지만, 목록이 지저분해집니다. 워커가 돌고 있었다면 마스터와의 연결도 함께 끊깁니다 — 제거 후 설치 한 줄을 다시 실행하세요.

Tailscale 완전 제거 (맥)

맥에서 Tailscale이 다른 계정에 묶여 있거나 앱이 이상할 때, 앱·데몬·설정을 모두 지웁니다. 터미널에 붙여넣으세요 — 맥 로그인 암호를 한 번 묻습니다. macOS 13 이상 어디서든 됩니다.

앱스토어판·직접 설치판(pkg)·홈브루판 어느 것이든 한 번에 지웁니다. 지운 뒤에는 관리자 콘솔의 기기 목록에서도 이 맥을 지우고, 설치 한 줄을 다시 실행하세요.