windows install tips_ko

Windows 설치 팁: native wrapper 경로

언어: English | Korean

이 페이지는 Windows에서 Ghost-ALICE OS를 설치할 때 자주 부딪히는 마찰 지점을 정리한다. 빠른 copy-and-run 설치 경로는 Team onboarding을 사용한다.

Contents

• 0. Scope
• 1. Recommended Environment
• 2. Open A Windows Terminal
• 3. Run The Windows Wrapper
• 4. When Localized Output Looks Wrong
• 5. FAQ
  • Do I Need Git Bash?
  • Do I Need To Install Python First?
  • Should I Use PowerShell Directly?
  • Must I Always Run As Administrator?

0. Scope

이 페이지는 아래 항목만 다룬다.

• native Windows wrapper를 public Windows install entrypoint로 사용하는 방법
• path와 administrator terminal 혼동을 줄이는 방법
• Windows command도 install.sh와 같은 long-flag surface로 유지하는 방법
• project file을 바꾸지 않고 localized output 문제를 우회하는 방법

1. Recommended Environment

권장 Windows 설정은 다음과 같다.

Item	Recommended	Reason
Shell	Command Prompt 또는 PowerShell	일반 Windows 환경에 기본으로 있다
Terminal app	Windows Terminal, Command Prompt, PowerShell	Ghost-ALICE 설치를 위해 Git Bash를 추가 요구하지 않는다
Install entrypoint	.\install.cmd	같은 long flag를 installer로 전달하는 native wrapper다

대부분의 사용자는 Python을 먼저 설치할 필요가 없다. Python 3.11+가 없으면 installer가 지원되는 준비 경로를 시도하고 남은 조치를 보고한다.

2. Open A Windows Terminal

Command Prompt, PowerShell, Windows Terminal 중 하나를 열고 원하는 폴더로 이동한다.

cd %USERPROFILE%\Desktop

무작위 administrator terminal에서 install command를 실행하지 않는다. 대부분의 Ghost-ALICE install, update, status, uninstall 작업에는 일반 사용자 권한으로 충분하다.

3. Run The Windows Wrapper

Windows에서는 native wrapper를 사용한다.

git clone https://github.com/AidALL/ghost-alice.git %USERPROFILE%\ghost-alice
cd %USERPROFILE%\ghost-alice
.\install.cmd --addon autopilot

자주 쓰는 follow-up command도 같은 long-flag surface를 쓴다.

.\install.cmd --status
.\install.cmd --doctor
.\install.cmd --platform codex
.\install.cmd --visibility dynamic
.\install.cmd --uninstall

source update는 안전한 updater를 먼저 사용한다.

cd %USERPROFILE%\ghost-alice
.\install.cmd --update-source

Git이 conflict를 보고하면 installer를 다시 실행하기 전에 멈추고 Install troubleshooting을 읽는다.

4. When Localized Output Looks Wrong

Windows console encoding이 맞지 않으면 localized output이 깨져 보일 수 있다. 먼저 파일을 편집하지 말고 Windows Terminal 또는 새 Command Prompt에서 다시 확인한다.

cd %USERPROFILE%\ghost-alice
.\install.cmd --status

정말 editor에서 파일을 다시 저장해야 한다면 먼저 UTF-8 계열 encoding인지 확인한다. local encoding 편집은 공유 project 변경이 될 수 있으므로 원인을 확인하기 전에 commit하지 않는다.

5. FAQ

Do I Need Git Bash?

필요 없다. Git Bash는 이미 workflow에 포함되어 있다면 사용할 수 있는 optional shell로 남지만, Ghost-ALICE의 Windows default install requirement는 아니다.

Do I Need To Install Python First?

보통 필요 없다. installer가 Python 3.11+를 찾지 못하면 가능한 경우 자동으로 준비한다. 자동 준비에 실패하면 installer는 수동으로 실행할 설치 명령을 보여준다.

Should I Use PowerShell Directly?

public instruction에서는 .\install.cmd를 사용한다. 이 wrapper가 사용 가능한 PowerShell host를 선택하고 docs에 나온 같은 long flag spelling으로 arguments를 전달한다.

Must I Always Run As Administrator?

아니다. 대부분의 설치와 업데이트에는 일반 권한으로 충분하다. 시스템 전역 변경이나 UAC가 필요한 경우에만 별도 관리자 terminal을 연다.