경로가 첫 번째 색인이다
검색 도구는 실패하고, 데이터베이스는 부패하고, 기억은 흐려져 — 근데 디렉토리 트리는 여전히 거기 있어, 미래의 어떤 도구든 읽으면서, 좋은 레이아웃은 그 트리 자체를 유익하게 만들어. 나쁜 레이아웃은 트리를 저자만 풀 수 있는 퍼즐로 만들고, 그것도 몇 년뿐이지. 규모가 붙는 아카이브 레이아웃은, 낯선 이(또는 문맥 없는 미래의 네)가 문서 없이 해석할 수 있는 거야.
작동하는 모양은 수집 좌표를 반영해:
- 최상위: 메이커.
black-forest-labs/,mistralai/— 감수 사슬의 뿌리. 상류 네임스페이스를 반영해서, 출처가 경로가 말하는 첫 번째 것이 되게. - 둘째 수준: 모델.
FLUX.1-dev/— 상류 리포지토리 이름, 있는 그대로, 아무리 못나도. 받으면서 모델 이름을 바꾸는 게 아카이브가 자기 소스로 가는 링크를 잃는 방법이야. - 셋째 수준: 변형/revision.
bf16-240901/,gguf-q4/— 정밀도나 포맷, 플러스 수집 스탬프. 한 모델의 두 변형은 형제지 룸메이트가 아니야: 파생 포맷은 자기 디렉토리를 갖고, 자기가 무엇인지 라벨 붙여. - 안쪽: 파일들, 플러스 기록들. 텐서, 토크나이저, 모델 카드(복사!),
SHA256SUMS, 그리고 revision sha와 출처와 라이선스 줄과 사슬 점수와 날짜가 든NOTES파일. 디렉토리가 자기완결적이야: 아카이브의 데이터베이스를 지워도 모든 디렉토리는 여전히 자기를 설명할 수 있어.
집세를 내는 네이밍 규칙
미학보다 중요한 제약들: 네가 만드는 모든 경로 세그먼트는 소문자-하이픈(대소문자 구분이 파일시스템마다 달라서, 대소문자 충돌은 이주가 잘 안 돼). ASCII만(어떤 파일시스템에서 다르게 렌더되는 문자가 든 모델 이름은 미래의 유령 파일이야). 공백 없음(모든 셸과 스크립트에서 따옴표가 달라져). 날짜는 YYMMDD나 YYYY-MM-DD로(어휘 정렬이 시간 정렬과 같게). 이 규칙을 어겨도 상류 이름은 있는 그대로 둬 — 네 세그먼트는 규칙을 따르고, 그들의 이름은 데이터야.
보상은 복리로 쌓여: 스크립트가 트리를 걷는 것만으로 수집 메타데이터를 경로에서 재구성해. 복구된 백업이 스스로 재색인돼. 그리고 "그 모델의 BF16 원본이 어디 있지"가 검색 쿼리가 아니라 디렉토리 두 번 조회가 돼.
있는 엉망을 (안전하게) 이주하기
이름 바꾸기는 메타데이터 작업이지만 여전히 쓰기야 — 뒤에 검증해. 있는 더미의 안전한 이주 루프: 정준 레이아웃을 정하고, 모델 하나씩 옮기고(복사-그리고-잊기 말고 이동), 새 위치에서 다이제스트 점검을 다시 돌리고, 색인을 갱신해. 수집 중에 일괄 이름 바꾸기 절대 금지. 활성 전송 중의 레이아웃 변경이 .part 파일을 기대 목적지에서 고아로 만드는 방법이야.