시작하기

Yenpo 설치 및 첫 저장소 열기

Mac 지원 여부를 확인하고 미리보기 버전을 설치하여 모델 계정 없이 로컬 코드를 읽으세요. AI 질문을 할 때만 제공업체를 연결하면 됩니다.

Yenpo에서 코드를 읽기 시작하는 데 모델 계정은 필요하지 않습니다. 탐색, 검색 및 언어 서버 탐색은 로컬에서 작동합니다. 코드에 대해 AI Reader에 질문하고 싶을 때 모델 제공업체를 연결하세요.

Mac 확인

현재 얼리 액세스 미리보기는 macOS 14 이상의 Apple silicon 및 Intel Mac에서 실행됩니다. 하나의 다운로드로 양쪽을 지원합니다. 이 Mac에 관하여에서 macOS 버전을 확인할 수 있습니다.

각 미리보기 빌드는 다운로드 버튼 옆에 표시된 날짜에 만료됩니다. 빌드 시 정해지는 날짜이므로 나중에 다운로드하거나 재설치해도 연장되지 않습니다. 그 전에 새 빌드를 설치하세요.

설치

  1. 홈페이지에서 .dmg를 다운로드하세요.
  2. 열고 Yenpo를 응용 프로그램으로 끌어오세요.
  3. 응용 프로그램에서 Yenpo를 실행한 뒤 디스크 이미지를 추출하세요.

설치된 버전 확인

메뉴 막대에서 Yenpo → Yenpo 정보를 선택하세요. 다운로드 버튼 옆의 버전과 비교하세요. 정보 창은 Mac의 시간대로 EAP 만료일을 표시하며 웹사이트는 UTC로 표시합니다.

업데이트했는데 이전 버전이 보이면 Yenpo를 종료하고 응용 프로그램의 사본을 다시 여세요. 교체 방법은 미리보기 만료 전에 업데이트를 참고하세요.

프로젝트 열기

읽을 프로젝트의 폴더를 여세요. README, 빌드 파일 및 .git이 있는 저장소 루트를 선택하세요. 하위 폴더를 열면 저장소의 다른 위치에 있는 테스트와 설정은 프로젝트에 포함되지 않습니다.

Command-P(파일로 이동…)를 누르고 파일 이름이나 경로 일부를 입력하여 아는 파일을 여세요. README 또는 관련 테스트는 다른 탭에 열어 두세요. 다른 프로젝트는 별도 창에서 여세요.

있는 파일을 찾지 못한다면 연 폴더 안에 있는지 확인하고 숨김 파일 및 Git 무시 파일 표시 설정을 확인하세요. 파일 찾기 및 심볼 따라가기에 자세한 내용이 있습니다.

작은 작업 하나 해 보기

설정이 읽히는 위치처럼 답을 확인할 수 있는 질문을 고르세요.

  1. 모든 파일 검색에서 정확한 설정 이름이나 특징적인 메시지를 찾으세요.
  2. 일치하는 함수를 열고 입력을 어디서 받는지 확인하세요.
  3. 언어 서버가 있다면 정의로 이동 또는 참조 찾기를 사용하세요. 없다면 심볼을 텍스트로 검색하세요.
  4. 입력을 제공하는 호출자나 테스트를 읽으세요.

진입점, 따라갈 값, 사용 방식을 보여주는 호출자나 테스트면 시작하기에 충분합니다. 전체 아키텍처를 먼저 이해할 필요는 없습니다.

AI Reader에 질문하기 (선택 사항)

모델 제공업체 연결에 따라 설정한 뒤 AI Reader를 열고 방금 읽은 코드에 대해 질문하세요. 파일, 폴더 또는 선택 영역을 시작점으로 추가하거나 동작만 설명하여 작업 공간에서 코드를 찾게 할 수 있습니다.

예를 들면 다음과 같습니다.

이 설정을 기본값부터 요청 핸들러까지 추적해 주세요. 어떤 재정의로 값이 바뀔 수 있나요? 확인할 분기를 알려주세요.

답변의 소스 참조를 누르면 빠른 보기에서 코드를 미리 볼 수 있습니다. 파일 열기를 누르면 탭에 유지됩니다. 더 큰 질문을 하기 전에 주장 하나를 코드와 대조하세요.

AI Reader는 기본적으로 읽기만 합니다. 실행 한 번에 한해 파일 편집을 허용할 수 있습니다. 동작 방식과 모델로 전송되는 내용은 전송되는 데이터와 편집 범위에서 설명합니다.

미리보기 만료 전에 업데이트

  1. 홈페이지 다운로드 버튼 옆에서 버전과 만료일을 확인하세요. 새 버전이 있으면 .dmg를 다운로드하세요.
  2. 저장하지 않은 파일을 저장하고 Yenpo를 종료하세요. 새 디스크 이미지를 열고 Yenpo를 응용 프로그램으로 끌어와 Finder에서 물으면 기존 사본을 교체하세요.
  3. 응용 프로그램에서 Yenpo를 실행하고 Yenpo → Yenpo 정보를 다시 확인한 뒤 디스크 이미지를 추출하세요.

같은 빌드를 다운로드하거나 재설치해도 만료일은 연장되지 않습니다. 빌드가 만료되었는데 홈페이지에도 같은 버전만 있다면 새 릴리스를 기다리세요.

문제가 있을 때

문제 먼저 확인할 사항
파일을 찾을 수 없음 프로젝트 루트, 파일 경로, 숨김 및 Git 무시 파일 설정
정의로 이동이 작동하지 않음 언어 서버 설치 여부와 프로젝트 이해 여부
AI Reader가 답하지 못함 현재 제공업체, API 유형, 엔드포인트, 모델 ID, API 키
예상한 코드가 보이지 않음 탭이 과거 Git 버전인지 현재 파일인지

버그를 기록할 때 Yenpo와 macOS 버전, 예상 및 실제 결과와 재현 단계를 남기세요. 공개적으로 공유하는 내용에는 비공개 코드와 API 키를 포함하지 마세요.

다음 단계 선택

파일 찾기, 심볼 따라가기 및 소스 참조 확인으로 이어가세요. 파일 검색부터 시작하고 언어 서버가 있으면 심볼 탐색을 사용하세요. 모델 계정 없이도 커밋과 브랜치 비교를 할 수 있습니다.

AI Reader에 코드 질문을 하려면 모델 제공업체를 연결하세요. 질문을 보내기 전에 제공업체로 전송되는 코드와 요금을 확인하세요.