코드 첫 줄은 '분류'가 아니라 '백업'이었습니다: 원탭 콜드 백업부터 손실 0 대사표까지
2026.10.14
소개
지난 시간에 기획 문서 16개를 만들었습니다. 다만 Claude가 물었던 두 가지, 어떤 브라우저를 쓰는지와 바로 구현에 들어가도 되는지는 답하지 않고 넘어갔습니다. 이번 주에는 "다음 단계 진행해줘" 한 줄로 구현을 시작했습니다. 지난주에 질문으로 남긴 원탭 v2 저장소 구조는 여전히 모르는 상태라, 추측한 예시 데이터로 출발해야 했습니다. 저는 구현이라고 하면 분류나 LLM 쪽부터 손댈 줄 알았습니다. 그런데 실제 첫 두 단계는 원본을 지키는 일, 그리고 "하나도 잃지 않았다"를 숫자로 보이는 일이었습니다.
진행 방법
사용 도구
도구 | 용도 |
|---|---|
Claude Code (웹 클라우드 세션) | 명세 작성, 리뷰, 커밋 |
Claude Code 워크플로 | P0 구현과 모듈별 반박 리뷰 (에이전트 17개) |
서브에이전트 병렬 실행 | P1 리더·저장소·가져오기를 나눠 구현 |
Python 3.11 (표준 라이브러리만), pytest 9.1.1 | 구현과 테스트 |
Git / GitHub | 단계별 커밋 |
Claude가 구현 전에 정한 원칙은 세 가지였습니다. 표준 라이브러리만 쓴다, 브라우저 데이터는 읽기만 한다, 원탭 재설치나 Firefox 새로고침은 절대 하지 않는다.
1단계: P0, 원본부터 지키기
다음 단계 진행해줘
로드맵의 첫 단계인 P0(콜드 백업·정찰)가 만들어졌습니다. 28개 파일, 8,454줄입니다.
명령 ( | 하는 일 |
|---|---|
| 설치된 브라우저·프로필 탐지, 원탭 저장소 버전, 북마크·히스토리 개수를 한국어 보고서로 |
| 브라우저가 실행 중이면 거부. 원탭 저장소·북마크·히스토리·Safari DB를 날짜별 폴더로 복사하고 sha256 목록 생성 |
| 복사본 무결성 확인 |
| 원탭 텍스트·v1·v2 덤프를 하나의 JSON으로. 모르는 값은 |
| 텍스트 내보내기와 내부 저장소의 그룹을 맞춰 보는 대사표 |
| 현장 확인 체크리스트 |
원탭 확장 페이지의 개발자 도구에 붙여 넣는 덤프 스크립트 2개도 함께 만들었습니다. 테스트는 157개 통과, 2개 건너뜀이었습니다. 워크플로 안에서 모듈별 반박 리뷰를 돌렸더니 37건(심각 9건)이 나왔고, 심각·중간 등급은 모두 고쳤습니다.
2단계: P1, 정본 저장소와 "손실 0"
다음 단계 진행해줘
이번에는 Claude가 먼저 명세(P1-SPEC.md)를 쓰고, 서브에이전트들에게 리더·저장소·가져오기를 나눠 맡겼습니다. 커밋 5개, 39개 파일, 9,507줄이었습니다.
리더: 원탭 텍스트·v1 LevelDB·v2 덤프, Chromium 북마크·히스토리, Firefox, Safari(탭 그룹·iCloud 탭·북마크·히스토리), 북마크 HTML
정본 저장소: SQLite + 전문 검색(FTS5), URL 정규화
명령:
init / import / report / export / search / restore-list / launchd
표준 라이브러리만 쓰기로 해서, Firefox 세션 파일의 압축(mozLz4)과 Chrome LevelDB의 압축(Snappy)은 순수 파이썬으로 직접 풀었습니다. 테스트는 358개 통과로 늘었습니다.
작은 원탭 텍스트로 끝까지 돌려 본 출력입니다.
저장소 준비됨: …/links.db (schema_version=1)
onetab_text - 원본 3 → 캡처 3 (중복 0, 방문 0) onetab.txt
가져오기 완료: 배치 1, 캡처 3, 링크 3, 버전 간 병합 0, 손실 0: 예
대사표의 "손실 0"은 "원본 항목 − 적재된 캡처 − 중복으로 흡수된 것 = 0"이라는 식으로 계산됩니다. 내보내기 결과의 한글 위키 주소는 저장 당시 형태(%ED%95%9C%EA%B8%80) 그대로 나왔고, 검색 결과에는 읽기 쉬운 형태(한글)로 나왔습니다.
결과와 배운 점
🔑 꿀팁
데이터를 정리하는 도구의 첫 기능은 원본 사본입니다. 쓰기 전에 복사하고, 원본이 열려 있으면 거부하고, 해시 목록으로 사본을 검증할 수 있게 해 둡니다.
"잃지 않았다"를 식으로 만드세요. 원본 개수 − 적재 개수 − 중복 흡수 = 0처럼 계산식이 있으면, 버그가 생겼을 때 숫자가 먼저 알려 줍니다.
"확인할 수 없음"을 "없음"으로 처리하지 마세요. 모르는 값은
null로 두고, 확인에 실패하면 진행하지 않는 쪽이 안전합니다.
😅 시행착오
워크플로 스크립트 파싱 오류. P0 워크플로를 처음 실행하자마자 이 오류가 났습니다.
Invalid workflow script: Script parse error: Unexpected token (53:163)
rowser keys that appear running; parse `ps -axo comm=` on mac/linux, `tasklist`
^
원인은 에이전트에게 줄 명세 문장 안의 백틱(`)이 자바스크립트 템플릿 문자열을 중간에 끊어 버린 것입니다. 백틱을 따옴표로 바꾸고 다시 실행해 해결했습니다.
푸시 실패.
fatal: unable to access '<https://github.com/cliclo/test/>': The requested URL returned error: 503
일시적인 서버 오류였습니다. 2초, 4초, 8초, 16초 간격으로 다시 시도하는 규칙을 적용했고 재시도에서 성공했습니다.
반박 리뷰가 잡은 위험. 실행 중인 브라우저 목록을 가져오는 데 실패하면, 처음 구현은 이를 "실행 중인 브라우저 없음"으로 처리했습니다. 그러면 열려 있는 데이터베이스를 복사하게 됩니다. 지금은 확인할 수 없으면 백업을 거부합니다.
P1에서 "손실 0"이 깨진 경우 두 가지.
같은 파일을 다시 가져오거나 원탭 v1·v2 그룹을 병합하면, 중복 캡처가 하나로 합쳐지면서 "원본 항목 − 캡처"가 0이 아니게 됐습니다. 진짜 손실이 아니라 "이미 저장된 것"이었습니다. 그래서 중복으로 흡수된 건수를 따로 기록하고 식에서 빼도록 고쳤습니다.
그룹 이름을 버리는 텍스트 내보내기를 다시 가져오자, 다른 출처에서 복구해 둔 그룹 이름이 빈 값으로 덮였습니다. 지금은 정보가 빠진 출처가 이미 알고 있는 값을 지우지 않습니다.
🙋 도움이 필요한 부분
원탭 v2(IndexedDB) 덤프의 실제 스토어 이름과 필드 구조를 아시는 분이 있을까요? 지금 파서는 추측으로 만든 예시 데이터에 맞춰져 있습니다.
macOS에서 터미널에 "전체 디스크 접근" 권한을 주지 않은 채 Safari 데이터베이스를 읽으면, 파이썬이 어떤 오류를 내나요? 리눅스 환경이라 재현하지 못했습니다.
Chrome 북마크 파일의 백업본(
Bookmarks.bak)은 지금 건너뛰고 있습니다. 같은 항목이 겹치기 때문인데, 과거 시점의 스냅샷으로 따로 보관할 가치가 있을까요?
📅 앞으로의 계획
브라우저 확장을 만들어, 원탭처럼 목록을 보고 그룹 단위로 한 번에 다시 여는 원클릭 복원을 붙입니다.
미뤄 둔 질문인 "맥과 아이폰을 둘 다 만들어야 하는가"를 정리합니다.
도움 받은 글
dpschen/onetab-export-script, 원탭 v1 데이터 콘솔 추출: https://github.com/dpschen/onetab-export-script
spacepirate-op/OneTab-Import-Export-Json, 원탭 v2 IndexedDB 콘솔 덤프: https://github.com/spacepirate-op/OneTab-Import-Export-Json
한 줄 요약: 정리 도구의 첫 기능은 정리가 아니라, 원본을 지키고 "하나도 안 잃었다"를 숫자로 보여 주는 것이었습니다.
로그인하고 댓글을 남겨 주세요
‘실행 중인 브라우저 없음’이라는 결과를 보면 그대로 받아들일 것 같았어요. 목록을 못 읽은 경우도 같은 말로 보일 수 있다는 대목을 읽으니 없다는 것과 모른다는 것 사이의 간격이 생각보다 크네요.




moa님, 구현의 첫 두 단계를 분류가 아니라 "원본 백업"과 "손실 0 대사표"로 잡은 순서가 인상적이에요. 원본 개수 − 적재 개수 − 중복 흡수 = 0이라는 식으로 만들어 두니, 버그가 생기면 숫자가 먼저 알려 준다는 점이 실무에 바로 쓸 만한 꿀팁이에요.
시행착오도 구체적이라 도움이 됐어요. 실행 중인 브라우저 목록 조회에 실패했을 때 "없음"으로 처리하면 열려 있는 DB를 복사하게 된다는 반박 리뷰 지적, 그리고 같은 파일을 다시 가져올 때 "손실"처럼 보인 게 사실은 중복 흡수였다는 발견이 특히 배울 점이에요. 모르는 값을 false가 아니라 null로 두는 원칙도 좋아요.
원탭 v2 덤프 구조 질문은 아는 분이 답을 달아 주면 좋겠어요. 원클릭 복원 확장이 붙은 후기도 기다릴게요.
꼬리 탁! 치고 응원하고 갈게요 🐈⬛