중앙 웹

별도 설치 없이 웹 브라우저에서 바로 뷰어를 여는 가장 간단한 방법이에요.

https://darkpyonix.github.io/researchtree/

GitHub Settings → Developer settings → Personal access tokens에서 토큰을 만듭니다.
fine-grained 토큰이라면 대상 레포에 다음 권한을 설정해 주세요.
- Pull requests: 읽기/쓰기
- Contents: 읽기
토큰(github_pat_…)을 붙여 넣고 "토큰으로 로그인"을 누릅니다.

입력한 토큰은 브라우저의 localStorage에만 안전하게 저장되며, api.github.com 외의 곳으로는 보내지 않아요 (보안과 개인정보).

로그아웃과 만료

오른쪽 위 아바타에 마우스를 올려 계정 메뉴를 연 뒤 로그아웃을 누르면 브라우저에 저장된 토큰이 삭제됩니다. 같은 메뉴의 다른 레포 열기를 통해 레포 선택 화면으로 돌아갈 수도 있어요. 토큰이 만료되거나 권한이 취소되어 GitHub에서 401 오류를 반환하면 자동으로 로그인 화면으로 이동합니다.

앱으로 설치 (PWA)

중앙 웹은 앱처럼 설치할 수 있어요. 설치하면 브라우저 탭 없이 따로 창이 열리고, 홈 화면이나 시작 메뉴에 ResearchTree 아이콘이 생겨요.

데스크톱 Chrome·Edge: 주소창 오른쪽의 설치 아이콘을 누르거나, 메뉴에서 앱 설치를 골라요.
Android Chrome: 메뉴에서 홈 화면에 추가(또는 앱 설치)를 눌러요.
iPhone·iPad Safari: 공유 버튼에서 홈 화면에 추가를 눌러요.

휴대폰의 상태바와 하단바는 그 아래 화면에 맞춰 색이 바뀌어요. 입체 보기에서는 바다 색, 평면 보기와 로그인 화면에서는 배경색이에요. iPhone에서는 화면이 상태바 뒤까지 그려져요.

설치한 앱은 뷰어 화면(HTML, 스크립트, 스타일, 글꼴)을 기기에 저장해 두고 빨리 열려요. 실험 기록은 매번 GitHub에서 새로 읽고, 토큰이나 GitHub 응답은 이 저장소에 넣지 않아요.

레포 선택

로그인하면 "어떤 연구를 볼까요?" 화면이 나옵니다.

owner/name을 직접 입력하거나 내 레포 목록에서 고릅니다. 입력 시 목록이 바로 필터링돼요.
처음이라면 데모 레포로 둘러보기를 눌러 보세요. 가상의 음성 합성 연구 1년치를 담은 예시 레포가 열려요.
최근에 본 레포가 상단에 칩으로 표시됩니다 (최대 6개).
마지막으로 열었던 레포는 다음 접속 때 자동으로 열려요.
레포가 없거나 접근 권한이 부족하면 "레포를 찾을 수 없거나 접근 권한이 없습니다" 안내가 표시됩니다.

공유 링크

현재 보고 있는 레포와 선택한 노드가 주소창 URL에 그대로 반영돼요.

https://darkpyonix.github.io/researchtree/?repo=lab/moshi&node=experiment/depth-lr-half

파라미터	뜻
`repo`	열 레포 (`owner/name`)
`node`	선택할 노드. 실험은 브랜치 이름(`experiment/...`), 버전은 `research@v2` 형식

링크를 공유받은 사람도 로그인한 뒤 같은 화면을 볼 수 있어요. 만약 비공개 레포라면 상대방에게도 해당 레포 접근 권한이 있어야 내용이 보입니다. 권한이 없다면 접근 안내 메시지가 나타나요.

터미널에서 바로 열기

Python 패키지를 설치했다면 레포 디렉토리에서 researchtree open을 실행해 보세요. 현재 레포의 중앙 웹 주소(?repo=…)를 출력하고 브라우저로 바로 열어줍니다.

중앙 웹

로그인

GitHub로 로그인 (OAuth)

개인 액세스 토큰(PAT)으로 로그인

로그아웃과 만료

앱으로 설치 (PWA)

레포 선택

공유 링크

중앙 웹 ​

로그인 ​

GitHub로 로그인 (OAuth) ​

개인 액세스 토큰(PAT)으로 로그인 ​

로그아웃과 만료 ​

앱으로 설치 (PWA) ​

레포 선택 ​

공유 링크 ​

중앙 웹

로그인

GitHub로 로그인 (OAuth)

개인 액세스 토큰(PAT)으로 로그인

로그아웃과 만료

앱으로 설치 (PWA)

레포 선택

공유 링크