==============================================================
  FALCON 지인 테스트 — 먼저 읽어 주세요
==============================================================

0. 이 패키지가 무엇인가
--------------------------------------------------------------
FALCON(독수리) 을 지인분 PC 에서 시험해 보기 위한 «설치 안내»
꾸러미입니다.

  - 프로그램 본체가 아닙니다. 저장소 전체도 아닙니다.
  - 여기에는 설치 안내 화면과 점검 목록만 들어 있습니다.
  - 실제 실행기(falcon_local_runner.py)는 ZIP 에 없습니다.
    아래 9번 단계에서 FALCON 서버가 직접 내려 줍니다.


1. 미리 알아 두실 것
--------------------------------------------------------------
[1] API 키를 구해 오실 필요가 없습니다.
    목소리(Typecast) 와 장면 그림(EvoLink) 은 FALCON 서버가
    대신 부릅니다. 지인분 PC 에는 그 키를 넣지 않습니다.
    설치 화면에도 입력칸이 없습니다.

    * 받아쓰기(Speechmatics) 만 «선택»입니다. 본인 키가 있으면
      설치 6번 화면에서 연결하실 수 있고, 없으면 건너뛰셔도
      됩니다. 없으면 그 단계만 건너뛸 뿐 나머지는 그대로
      만들어집니다. 로컬 Whisper 로 대신하셔도 됩니다.

[2] 무거운 작업은 지인분 PC 에서 돕니다.
    ffmpeg 렌더·프레임 굽기·자막 합성은 전부 본인 컴퓨터에서
    실행됩니다. 그래서 ffmpeg 와 Python 이 필요합니다.

[3] 완성된 영상은 지인분 PC 에 저장됩니다.
    서버로 올라가지 않습니다. 위치는 아래 4번 항목에 있습니다.


2. 지금 테스트할 수 있는 채널
--------------------------------------------------------------
  사용 가능   명화관 (cinema)
  사용 가능   웃긴버거 (funnyburger)

  아직 아님   뇌전구      — 보류(HOLD) 상태입니다
  아직 아님   인물형      — 이번 테스트 대상이 아닙니다
  아직 아님   그 밖의 채널

  채널 목록은 `list_channels` 로 언제든 확인하실 수 있습니다.
  목록에 보여도 «권한 없음»으로 표시되면 아직 열리지 않은 것입니다.


3. 설치 순서
--------------------------------------------------------------
아래 명령은 Windows 명령 프롬프트(또는 PowerShell) 기준입니다.
설치 화면(installer)이 같은 순서로 안내하니, 화면을 따라가셔도
됩니다.
아래 명령은 «한 줄»입니다. 줄이 길어 보여도 그대로 복사해
붙여넣으시면 됩니다.

 1) Python 3 이 있는지 확인
      python -V
    없으면:
      winget install --id Python.Python.3.11 --exact --silent --accept-package-agreements --accept-source-agreements

 2) ffmpeg / ffprobe 가 있는지 확인
      ffmpeg -version
      ffprobe -version
    없으면 (ffprobe 는 같이 들어옵니다. 따로 설치하지 않습니다):
      winget install --id Gyan.FFmpeg --exact --silent --accept-package-agreements --accept-source-agreements
    설치 후에는 «새 터미널»을 열어 주세요. 재부팅은 필요 없습니다.

 3) Claude Code 가 있는지 확인
      claude --version

 4) 필수 항목을 한 번에 설치 — 「FALCON 필수설치.cmd」 를 더블클릭
    Python · pip · Pillow · numpy · opencv-python · FFmpeg ·
    FFprobe · Claude Code 를 «실제로» 깔고, 깐 뒤 다시 재서
    결과를 보여 줍니다. 이미 있는 것은 건너뜁니다.
    * 설치가 끝나면 «새 터미널»을 열고 한 번 더 실행해 주세요.
      방금 깐 프로그램은 새 창에서만 PATH 에 잡힙니다.
    * 1)~3) 이 이미 통과했다면 이 단계는 금방 끝납니다.
    받아쓰기를 본인 키로 쓰실 때만 (선택):
      python -m pip install --user speechmatics-python

 5) 설치 안내 화면 열기
      installer\ui\index.html 을 브라우저로 여세요.

 6) 화면의 «시스템 점검»을 돌려 빠진 것이 없는지 확인
    빨간 줄이 남아 있으면 그 줄의 안내대로 먼저 채워 주세요.

 7) 대표님이 알려 주신 FALCON 서버 주소를 등록
      claude mcp add --transport http --scope user falcon https://<대표님이_준_주소>/friend-mcp
    * 주소는 반드시 https 로 시작하고 /friend-mcp 로 끝납니다.

 8) 등록됐는지 확인하고 «브라우저»로 로그인
      claude mcp get falcon
    그다음 Claude Code 를 열고 FALCON 도구를 한 번 부르면,
    인증이 필요하다며 브라우저 창이 열립니다. 그 화면의
    「접속코드」 칸에 받으신 코드(영문·숫자 10자리)를 넣으시면
    됩니다.
    * 처음 설치할 때 «한 번만» 접속코드로 승인합니다.
      승인 후에는 다시 입력할 필요가 없습니다.
    * 로그인은 «도구»가 아니라 이 브라우저 화면에서 합니다.
      채팅창에 코드를 붙여넣지 마세요.

 9) 실행기 받기
      Claude 에게: wetube_setup 을 실행해 줘
    FALCON 이 실행기 본문과 sha256 지문을 함께 내려 줍니다.
    저장 위치는 다음과 같습니다.
      %USERPROFILE%\FalconWork\falcon_local_runner.py

    [주의] 줄바꿈을 «바꾸지 말고» 받은 그대로 저장해야 합니다.
           그러지 않으면 sha256 지문이 어긋납니다.

10) 실행기가 제대로 내려왔는지 확인
      python "%USERPROFILE%\FalconWork\falcon_local_runner.py" selfcheck
      python "%USERPROFILE%\FalconWork\falcon_local_runner.py" capability
    selfcheck 가 찍는 sha256 이 9번에서 받은 지문과 같아야 합니다.
    그다음 capability 결과를 Claude 에게 알려 줍니다.
      Claude 에게: wetube_capability 로 이 결과를 보내 줘

11) 첫 채널 만들어 보기
      Claude 에게: wetube_local_make 로 명화관 영상을 시작해 줘
    이후에는 이 두 가지를 번갈아 하시게 됩니다.
      - FALCON 이 «계약(spec)»을 내려 줍니다
      - 내 PC 에서 실행합니다
          python falcon_local_runner.py run spec.json --source ...
      - 결과를 돌려보냅니다
          Claude 에게: wetube_local_report 로 결과를 보내 줘
    어디까지 됐는지는 `wetube_local_status` 로 보실 수 있습니다.

12) 결과 영상 확인 — 아래 4번 항목


4. 최종 영상은 어디에 있나
--------------------------------------------------------------
  %USERPROFILE%\FalconWork\<작업번호>\out
  이 폴더 안에 완성된 MP4 가 있습니다.
  파일 이름은 채널마다 다릅니다.

    명화관 · 웃긴버거   <채널이름>_v001.mp4
                        (예: funnyburger_v001.mp4)

  정확한 파일 이름은 마지막 단계에서 FALCON 이 알려 줍니다.
  <작업번호> 는 제작을 시작할 때 받으신 job_id 입니다.


5. 서버 주소가 안 될 때
--------------------------------------------------------------
지금 첫 테스트는 «임시 주소(Quick Tunnel)»를 쓸 수 있습니다.
이 주소는 서버를 다시 켜면 «바뀝니다».

  - 연결이 갑자기 안 되면 주소가 바뀐 것일 수 있습니다.
  - 대표님께 새 주소를 받아 다시 등록해 주세요.
      claude mcp remove falcon
      claude mcp add --transport http --scope user falcon https://<새로_받은_주소>/friend-mcp
  - 나중에 «고정 주소»로 옮길 예정입니다. 그때는 이 과정이
    필요 없어집니다.


6. 문제가 생기면
--------------------------------------------------------------
[서버에 연결이 안 됩니다]
  claude mcp get falcon 으로 등록된 주소를 확인하세요.
  주소가 https 로 시작하고 /friend-mcp 로 끝나는지 보시고,
  그래도 안 되면 5번(임시 주소 변경)을 확인해 주세요.

[wetube_setup 이 실패합니다]
  먼저 브라우저 인증(8번)이 끝났는지 보세요. 로그인이 안 된
  상태에서는 실행기를 내려받을 수 없습니다.

[ffmpeg 가 없다고 나옵니다]
  ffmpeg -version 이 되는지 확인하세요. 방금 설치하셨다면
  «새 터미널»을 열어야 인식됩니다. 재부팅은 필요 없습니다.

[Python 패키지가 없다고 나옵니다]
  3번 4)번의 pip 명령을 다시 돌려 주세요. 그다음
  capability 를 한 번 더 돌려 결과를 보내 주시면 됩니다.

[MP4 가 안 생깁니다]
  4번 폴더가 만들어졌는지 보시고, 마지막 실행의 화면 메시지를
  확인해 주세요. 실행기가 «무엇이 없어서 멈췄는지»를 한국어로
  알려 줍니다. 그 문구를 그대로 알려 주시면 됩니다.


7. 절대 보내지 마세요
--------------------------------------------------------------
문제를 알려 주실 때, 아래는 «어떤 경우에도» 보내지 마세요.

  - API 키 · 토큰 (Typecast · EvoLink · 받아쓰기 키 등)
  - .env 파일
  - 개인 인증서 · 로그인 정보
  - 홈 폴더의 .wetube 폴더
  - 홈 폴더의 .volcano 폴더

보내 주실 것은 이것뿐입니다.

  - 화면에 뜬 오류 «메시지»
  - 스크린샷 (키나 토큰이 찍혔으면 가려 주세요)

FALCON 은 지인분께 키를 묻지 않습니다. 설치 과정에서든 채팅
에서든 «키를 넣으라»는 안내가 나오면 진행하지 마시고 먼저
대표님께 확인해 주세요.

==============================================================
  막히시면 6번을 먼저 보시고, 그래도 안 되면 편하게 물어보세요.
==============================================================
