@

docs: 집합 조정(M2) 보류 기록 + 반입 목록 실측

M2 는 교통시설물을 가르는 안까지 만들고 보류했다. 16장 실측으로
structure 1,079 -> utility pole 608 / streetlight pole 372 /
road sign 358 / culvert 9, fence 702 -> guardrail 668 / fence 46 /
roadside barrier 17 로 갈라지는 것을 확인했다 (라벨 14 -> 19종).
사용자 지시로 v4 로 되돌렸고 v5 는 보류 표시와 함께 남긴다.
culvert 9개, roadside barrier 17개는 16장 기준 표본이 부족하다.

정정: "집합 없는 검출은 버려진다"는 앞선 판단은 틀렸다.
merge_labels.py 의 merge_by_group 은 집합에 없는 라벨을 passthrough 로
그대로 통과시킨다. 16장 병합 결과에 orange traffic cone 114 개와
yellow safety cone 6 개가 독립 클래스로 살아 있다. [cone] 으로 묶으면
오히려 나란히 선 콘이 gap 2px 에서 한 덩어리가 되어 개수를 잃는다.

envsetting.md 에 반입 목록을 실측 크기로 정리했다:
  git 으로 오는 것 (복사 금지)
  손으로 복사할 것  체크포인트 3.3GB / BPE 1.4MB / JPEG 69장 1.2GB
  복사하면 안 되는 것  venv(절대경로), output/, theater 뷰어 JPEG 55MB

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@

docs/envsetting.md

@@ -18,7 +18,40 @@ RTX 4090 이 달린 이 PC 에 드론 사진 SAM 3.1 검출 환경을 세워라.
 
 - OS: Windows (원래 환경과 같음). Linux 면 경로 구분자만 바꿔라.
 - GPU: RTX 4090 24GB. `nvidia-smi` 로 드라이버가 올라와 있는지 먼저 확인해라.
-- 소스 PC 에서 가져와야 하는 큰 파일이 2종 있다 (아래 3, 4단계). git 에 없다.
+
+### 반입 목록 (실측 크기)
+
+**git 으로 오는 것 — 복사하지 마라**
+
+| 경로 | 리포 |
+|---|---|
+| `prompts/discovery_v4.txt` (94개 프롬프트) | railway-client, `sam31-coverage-tuning` 브랜치 |
+| `prompts/wide_v1.txt` | 〃 |
+| `configs/merge_groups_v4.txt` (현재 활성 집합 정의) | 〃 |
+| `tools/*.py` 전부 | 〃 |
+| `sam3/` 패키지 | sam31server |
+| `configs/auto_labeling/segment_anything_3.yaml` | 〃 |
+
+`merge_groups_v5.txt` 도 리포에 있지만 **보류 상태다. 쓰지 마라.** 활성은 v4 다.
+
+**손으로 복사해야 하는 것 — git 에 없다**
+
+| 항목 | 실측 크기 | 원본 위치 | 왜 git 에 없나 |
+|---|---|---|---|
+| SAM3.1 체크포인트 | **3.3 GB** | `C:\Users\<사용자>\.cache\huggingface\hub\models--facebook--sam3.1\` | `.gitignore` 가 `*.pt` 제외 |
+| BPE 사전 `bpe_simple_vocab_16e6.txt.gz` | 1.4 MB | `sam31server\bpe_simple_vocab_16e6.txt.gz` | `.gitignore` 가 `*.gz` 제외 |
+| 원본 JPEG `stage_BlockYYX\` 69장 | **1.2 GB** | `railway-client\output\sam3\stage_BlockYYX\` | `.gitignore:42` 가 `output/` 제외 |
+
+체크포인트는 복사 대신 HuggingFace 에서 새로 받아도 된다
+(`huggingface-cli download facebook/sam3.1`). 회선이 느리면 복사가 빠르다.
+
+**복사하면 안 되는 것**
+
+| 항목 | 이유 |
+|---|---|
+| `.venv\` | 절대경로가 박혀 있어 다른 PC 에서 깨진다. 새로 만들어라 |
+| `output\` 의 나머지 (`tune_t64` 등) | 이쪽 PC 의 산출물이다. 4090 은 새로 만든다 |
+| `docs\pilot\theater*\` | 뷰어 JPEG 55MB. `make_viewer.py` 로 다시 굽는다 |
 
 ### 1. 리포 2개 clone
 
@@ -75,13 +108,13 @@ pip install -r requirements.txt
 ```
 `True` 와 `NVIDIA GeForce RTX 4090` 이 나와야 한다.
 
-### 3. 체크포인트 + BPE 사전 (git 에 없음, 수 GB)
+### 3. 체크포인트 + BPE 사전 (git 에 없음, 실측 3.3GB + 1.4MB)
 
 `.gitignore` 가 `*.pt`, `*.gz` 를 뺀다.
 
 필요한 것:
-- `sam3.1_multiplex.pt` — HuggingFace `facebook/sam3.1`
-- `bpe_simple_vocab_16e6.txt.gz`
+- `sam3.1_multiplex.pt` — HuggingFace `facebook/sam3.1` (캐시 폴더 전체 3.3GB)
+- `bpe_simple_vocab_16e6.txt.gz` (1.4MB)
 
 받는 방법 둘 중 하나:
 1. HuggingFace 에서 새로 받는다 (`huggingface-cli download facebook/sam3.1`)
@@ -97,7 +130,7 @@ pip install -r requirements.txt
 3번 파일에는 **원래 PC 의 절대경로가 적혀 있다.** 그대로 쓰면 파일을 못 찾는다.
 환경변수로 덮거나 이 파일을 고쳐라.
 
-### 4. 원본 사진 (git 에 없음, 블록당 약 1.2GB)
+### 4. 원본 사진 (git 에 없음, 실측 1.2GB)
 
 `.gitignore:42` 가 `output/` 을 통째로 뺀다.