프로젝트와 URL

#프로젝트 추가하기

1. 파일 → 프로젝트 폴더 열기…(⌘O / CtrlO), 사이드바의 프로젝트 추가, 또는 제목 표시줄 프로젝트 메뉴의 프로젝트 추가…를 사용합니다.
2. 프로젝트를 가져올 곳을 고릅니다.
   • 이 컴퓨터에서: 폴더를 선택합니다.
   • GitHub / GitLab에서 클론: 내 저장소 중 하나(gh 또는 glab 로그인으로 목록을 가져옴)를 고르거나 URL을 붙여 넣고 상위 폴더를 선택하면, Ferret이 클론한 뒤 엽니다.
   • SSH로 열기: ~/.ssh/config에서 호스트를 고릅니다. 터미널과 에이전트는 원격 머신에서 실행되고, 리뷰는 이 컴퓨터에 남습니다.

이름의 기본값은 폴더 이름입니다. 이미 등록된 폴더를 추가하면 대신 그 프로젝트가 열립니다(macOS와 Windows에서는 경로를 대소문자 구분 없이 비교합니다). 사이드바 메뉴에서 프로젝트를 이름 변경하거나 목록에서 제거할 수 있습니다. 제거해도 폴더는 삭제되지 않습니다.

터미널은 프로젝트 폴더에서 열리고, 리뷰는 <project>/.ferret/ 아래에 저장됩니다.

#URL 저장하기

1. 내장 브라우저에서 페이지를 엽니다.
2. 브라우저 도구 모음의 +(현재 URL 저장)를 클릭합니다. 현재 URL이 미리 입력되어 있습니다.
3. 이름을 입력하고 저장을 클릭합니다.

http://와 https:// URL만 사용할 수 있습니다. 제안된 이름을 그대로 두면 호스트에서 이름을 추측합니다.

#리뷰 대상 패널

피드백 모드에서는 오른쪽의 리뷰 대상 패널에 현재 프로젝트에서 리뷰할 수 있는 모든 것이 나열됩니다. 대상을 전환해도 녹화는 멈추지 않습니다. 패널은 보기 → 리뷰 대상 표시/숨기기(⌘⇧K / CtrlShiftK) 또는 패널 숨기기로 표시하거나 숨깁니다.

• 대상: 프로젝트에 저장된 URL입니다. 각 URL 아래에는 그 사이트에서 방문한 페이지가 트리로 표시됩니다. 저장하지 않았지만 방문한 사이트는 별도의 그룹으로 표시됩니다.
• 파일: 프로젝트 폴더입니다. 파일은 미리 보기로 열리므로(Markdown과 Mermaid는 렌더링되고, 그 밖의 텍스트는 읽기 전용) 문서도 리뷰할 수 있습니다. 연필(에디터에서 열기)을 누르면 에디터에서 열립니다.

대상 필터는 대상, 페이지, 파일을 한꺼번에 걸러 내며, 파일로 이동…과 같은 퍼지 매칭을 사용합니다. 목록에서는 ↑ ↓ Enter 또는 1–9로 대상을 전환합니다. URL 열기…는 일회성 URL을 열고, 프로젝트 URL에 저장은 그 URL을 저장합니다.

대상은 settings.json의 projects[].urls에서 가져옵니다(예시 참고). 각 항목에는 url, launchCommand(터미널에서 실행. 예: 데스크톱 앱 시작), windowMatch(녹화할 창) 중 하나가 필요합니다. 창 대상을 고르면 그 창이 녹화 소스로 설정되므로 녹화 중에는 고를 수 없습니다. 방문한 페이지는 프로젝트별로 이 컴퓨터에만 기억됩니다(최대 200개).

#환경 열기와 전환

저장한 URL을 클릭하면 열립니다. 현재 페이지가 다른 저장된 URL 아래에 있으면, Ferret은 경로, 쿼리, 해시를 유지하고 origin만 바꿉니다. 예를 들어 http://localhost:3000/pricing?plan=pro에서 prd를 클릭하면 https://example.com/pricing?plan=pro가 열립니다.

현재 페이지와 일치하는 칩(가장 긴 접두사)이 강조 표시됩니다. 칩을 마우스 오른쪽 버튼으로 클릭하거나 연필 아이콘을 사용해 편집하거나 삭제할 수 있습니다. 프로젝트를 열 때 이전 URL이 없으면 첫 번째 저장된 URL이 로드됩니다.