RepoDelta

Start where you left off / 지난번에 읽던 곳부터

RepoDelta 1.0.4 · JTech-CO · MIT

Using RepoDelta

  1. Visit a GitHub repository and select Delta in the repository header. If the header cannot be located, a small floating control may appear instead.
  2. Review the displayed default branch and SHA. Select Start tracking here to save your first checkpoint. Earlier visits are not reconstructed.
  3. Revisit later. Compare commits and changed files, use the path/status filters, or open the exact comparison on GitHub.
  4. Select Mark this revision reviewed and confirm. Only the SHA currently displayed is acknowledged, even if the upstream branch advances while you read.

RepoDelta 1.0.4 tracks the default branch only, even when you are viewing another branch. Opening a page does not acknowledge changes. File filters do not create individual file-level read states.

Controls and states

Refresh revalidates the current result when GitHub permits requests. Registered repositories can check on revisit using a five-minute cache. There is no periodic monitoring, no browser-closed background service and no automatic GitHub write.

Files includes change type, renamed paths and line counts. Deleted files link to the older checkpoint. Commits loads up to 100 rows per request, oldest first, with explicit load-more up to 500 rows. When 300 files are returned, a warning states that the list may not be complete. Detailed code diffs open on GitHub.

History changed, default branch changed, repository identity changed and comparison unavailable are not ordinary unread updates. Inspect the repository before explicitly resetting your checkpoint. Cancel keeps the old checkpoint. An old tab cannot overwrite a newer checkpoint from another tab.

Settings and optional authentication

The toolbar popup opens the current repository panel or the settings page. Settings includes EN/KR, automatic checking, saved checkpoints, local JSON backup and session-only token management. GitHub login in a browser is separate from API authentication. For private repositories, use a repository-scoped fine-grained token with Contents read permission; organization approval may also be necessary. A token is checked on the next API request, not when pasted.

Re-enter your token after Chrome restarts or the extension reloads. Checkpoints remain local. Export before uninstalling if you need to preserve them. Imports merge only new entries and accept a JSON file up to 1 MiB.

Troubleshooting

If no button appears, reload GitHub after installing or updating the extension. Check that the extension is enabled and has site access on GitHub. A changed GitHub layout may require selector maintenance. Rate-limit errors show retry information instead of repeatedly calling GitHub. A 404 can mean missing permission, a renamed repository or an unavailable commit; it is not conclusive evidence of deletion. Use the current canonical repository URL after a rename. If the snapshot expires, refresh before acknowledging.

The initial package has automated logic tests and offline browser UI tests. Native installation and live GitHub authentication remain release checks; see the source package's QA report.

RepoDelta 사용 방법

  1. GitHub 저장소 상단의 Delta를 누릅니다. 헤더를 찾지 못하면 작은 플로팅 버튼이 표시될 수 있습니다.
  2. 표시된 기본 브랜치와 SHA를 확인하고 이 버전부터 추적을 누릅니다. 설치 전의 방문 기록은 복원하지 않습니다.
  3. 나중에 재방문하여 커밋·변경 파일을 비교합니다. 경로·상태로 필터하거나 GitHub의 해당 비교 화면을 열 수 있습니다.
  4. 이 버전까지 확인 완료를 누르고 확인합니다. 읽는 중 새 커밋이 올라와도 지금 표시된 SHA까지만 저장합니다.

1.0.4은 다른 브랜치를 보고 있더라도 기본 브랜치만 추적합니다. 페이지를 열기만 해서는 확인 완료가 되지 않습니다. 파일 필터는 파일별 읽음 상태를 만들지 않습니다.

화면과 상태

새로 확인은 GitHub가 요청을 허용하면 다시 조회합니다. 등록된 저장소는 재방문 시 5분 캐시를 활용해 자동 확인할 수 있습니다. 정기 모니터링, 브라우저 종료 중 감시, GitHub 자동 쓰기 기능은 없습니다.

파일 탭은 변경 종류, 이전 파일명, 줄 수 변화를 표시합니다. 삭제 파일은 이전 기준점에서 엽니다. 커밋 탭은 오래된 순서로 요청당 최대 100개, 더 보기를 통해 최대 500개를 제공합니다. 파일 300개가 반환되면 일부가 생략되었을 가능성을 안내합니다. 상세 코드 diff는 GitHub에서 확인합니다.

이력 변경, 기본 브랜치 변경, 저장소 ID 변경, 비교 불가는 일반적인 새 변경점과 구분합니다. 저장소 상황을 확인한 후 명시적으로 기준점을 재설정하세요. 취소하면 기존 기준점은 유지됩니다. 오래된 탭에서는 다른 탭이 저장한 최신 기준점을 덮어쓸 수 없습니다.

설정과 선택적 인증

도구 모음 팝업에서 현재 저장소 패널 또는 설정 화면을 엽니다. 설정에는 EN/KR 전환, 자동 확인, 기준점 목록, 로컬 JSON 백업, 세션 전용 토큰 관리가 있습니다. 브라우저의 GitHub 로그인과 API 인증은 별개입니다. 비공개 저장소에는 대상 저장소의 Contents 읽기 권한을 가진 fine-grained 토큰을 사용하세요. 조직 승인이 추가로 필요할 수 있습니다. 토큰 유효성은 붙여넣는 즉시가 아니라 다음 API 요청에서 확인합니다.

Chrome 재시작이나 확장 재로드 후 토큰을 다시 입력해야 합니다. 기준점은 로컬에 유지됩니다. 보관하려면 확장 삭제 전에 백업하세요. 가져오기는 기존 항목을 덮어쓰지 않고 새 항목만 병합하며 최대 1 MiB JSON 파일을 지원합니다.

문제 해결

버튼이 없다면 설치·업데이트 후 GitHub를 새로고침하고 확장 활성화 및 GitHub 사이트 접근 허용 여부를 확인합니다. GitHub 화면 구조가 변경되면 셀렉터 수정이 필요할 수 있습니다. API 한도 오류에서는 반복 요청 대신 재시도 정보를 표시합니다. 404는 권한 부족·이름 변경·커밋 접근 불가일 수 있으므로 삭제로 단정하지 않습니다. 저장소 이름 변경 시 현재 정식 URL을 사용하세요. 조회 스냅샷이 만료되면 다시 조회한 후 확인 완료를 누릅니다.

초기 패키지는 로직 자동화 테스트와 오프라인 브라우저 UI 테스트를 포함합니다. 네이티브 설치와 실제 GitHub 인증은 별도 배포 전 확인 항목입니다. 소스 패키지의 QA 보고서를 참고하세요.