# Gemini 이미지 주석 작업 프롬프트

`docs/papers/md/`의 논문 마크다운에 들어 있는 그림 86개를
Vision으로 분석해 각 그림 아래에 한국어 설명을 붙이는 작업.

아래 블록을 Antigravity에 그대로 넣으면 된다.

---

## 프롬프트

````
# 작업: 논문 마크다운의 그림에 Vision 분석 주석 달기

## 대상

D:\MYCLAUDE_PROJECT\sum-parts-test\docs\papers\md\ 아래 .md 파일 6개.
각 파일 옆에 같은 이름의 _images\ 폴더가 있고, 거기에 그림 파일이 들어 있다.

| 파일 | 그림 수 |
|---|---|
| PointNet_1612.00593.md | 24 |
| PointNet++_1706.02413.md | 10 |
| PointNeXt_2206.04670.md | 5 |
| PointVector_2205.10528.md | 8 |
| SUM_2021_dataset.md | 14 |
| SUM-Parts_2503.15300.md | 25 |
| **합계** | **86** |

## 마크다운의 현재 구조

그림은 항상 이 형태로 들어 있다. 앞에 `<span id=...>` 앵커가 붙기도 한다.

```
<span id="page-0-0"></span>![](PointVector_2205.10528_images/_page_0_Figure_11.jpeg)

Figure 1. Illustrations of the core operations of the different methods. (a) The
features of each point are calculated separately... (논문 원본 캡션)
```

- 이미지 경로는 **.md 파일 기준 상대경로**다
- 이미지 바로 아래 빈 줄, 그 다음에 **논문 원본 캡션**이 이미 있다
- 캡션이 없는 그림도 있다 (표 이미지, 장식용 등)

## 해야 할 일

각 이미지를 Vision으로 열어보고, **원본 캡션 아래에** 한국어 설명을 삽입한다.

### 삽입 형식

원본 캡션 다음 빈 줄 뒤에 인용 블록으로 넣는다.

```
<span id="page-0-0"></span>![](PointVector_2205.10528_images/_page_0_Figure_11.jpeg)

Figure 1. Illustrations of the core operations of the different methods. (a) The
features of each point are calculated separately...

> **[그림 해설]** 4개 패널을 가로로 배열한 비교 다이어그램. (a) attention 방식은
> 고정 커널로 각 점을 따로 계산한 뒤 입력에서 만든 가중치로 이방성을 부여한다.
> (b) 변위 벡터로 커널 패턴에 가까운 점을 골라 집계한다. (c) 점마다 다른 동적
> 커널을 적용한다. (d) 제안 방식은 특징에서 벡터 표현을 만들고, 벡터의 방향
> 자체가 이방성을 만든다. 화살표 색으로 등방성(검정)과 이방성(색)을 구분한다.
```

**원본 캡션이 없는 그림**은 이미지 바로 아래에 넣는다.

### 규칙

1. **`> **[그림 해설]**` 마커로 시작한다.** 이 마커로 나중에 검색·제거가 가능해야 한다.
2. **원본 텍스트는 절대 수정하지 않는다.** 캡션도, 본문도, 앵커 `<span>`도 그대로 둔다.
   오직 삽입만 한다.
3. **이미 `[그림 해설]`이 붙은 그림은 건너뛴다.** 재실행해도 중복되지 않아야 한다.
4. 한국어로 쓴다. 기술 용어(attention, MLP, IoU, voxel 등)는 원어 그대로 둔다.
5. 인용 블록 전체를 `> `로 시작하는 여러 줄로 쓴다.

## 무엇을 쓸 것인가

**"그림이 무엇을 보여주는지"를 쓴다. 캡션을 번역하지 않는다.**
원본 캡션은 바로 위에 이미 있으므로, 번역만 하면 아무 가치가 없다.

그림 유형별로 다르게 접근한다.

### 아키텍처 다이어그램 (가장 중요)

- 블록이 몇 개이고 무엇이 무엇으로 흘러가는가
- 화살표 방향, 분기와 합류 지점
- 텐서 shape 표기가 있으면 그대로 옮긴다 (예: `N×3 → N×64 → 1024`)
- 색이나 선 스타일이 구분하는 것
- **논문의 주장과 직결되는 지점을 짚는다** (예: "여기가 skip connection이고, 이게
  PointNet++ 대비 추가된 부분이다")

### 성능 차트 (막대·꺾은선·산점도)

- 축이 무엇인가 (단위 포함)
- 비교 대상이 몇 개이고 각각 무엇인가
- **읽을 수 있는 수치는 옮긴다** — 나중에 검색된다
- 추세와 교차점

### 정성 결과 (세그멘테이션 시각화 등)

- 몇 개 열/행이고 각각 무엇인가 (입력 / GT / 각 방법의 결과)
- 색상 범례가 있으면 클래스-색 대응을 옮긴다
- 방법 간 눈에 띄는 차이가 어디서 나타나는가

### 표를 이미지로 캡처한 것

- **표 내용을 마크다운 표로 복원한다.** 이게 가장 가치 있다.
- 행·열 헤더와 수치를 정확히 옮긴다

### 수식 이미지

- 수식을 LaTeX로 옮긴다
- 각 기호가 무엇을 뜻하는지 본문에서 찾아 붙인다

## 하지 말 것

- **읽을 수 없는 것을 지어내지 않는다.** 흐리거나 잘려서 안 보이면
  "해상도가 낮아 세부 수치는 판독 불가" 라고 명시한다.
- 원본 캡션을 그대로 번역하지 않는다.
- 논문에 없는 해석이나 평가를 덧붙이지 않는다.
  ("이 방법이 우수하다" 같은 것 — 그림에서 읽히는 사실만 쓴다)
- 그림과 무관한 배경 설명을 늘어놓지 않는다.

## 분량

그림당 **3~8줄**. 아키텍처 다이어그램과 표 이미지는 더 길어져도 된다
(표는 완전히 복원할 것). 장식용 그림은 1~2줄로 짧게.

## 진행 방식

1. 파일 하나씩 처리한다. 한 파일을 끝내고 다음으로 간다.
2. 파일 안에서는 위에서 아래 순서로 그림을 처리한다.
3. 이미지를 열 때는 **.md 파일이 있는 디렉토리 기준**으로 상대경로를 해석한다.
4. 파일 하나가 끝나면 몇 개 그림에 주석을 달았는지 보고한다.

## 검증

작업 후 이것들이 성립해야 한다.

- `[그림 해설]` 개수 == 그 파일의 이미지 개수
- 원본 텍스트 줄 수가 줄지 않았다 (삽입만 했으므로 늘어나야 정상)
- 마크다운이 깨지지 않았다 (표, 코드 블록, 수식이 그대로)
````

---

## 작업 후 확인 명령

Git Bash 또는 WSL에서:

```bash
cd /d/MYCLAUDE_PROJECT/sum-parts-test/docs/papers/md

# 그림 수 대 주석 수 대조
for md in *.md; do
  img=$(grep -c '!\[' "$md")
  ann=$(grep -c '\[그림 해설\]' "$md")
  printf '%-34s 그림 %2s  주석 %2s  %s\n' "$md" "$img" "$ann" \
    "$([ "$img" -eq "$ann" ] && echo OK || echo MISMATCH)"
done
```

## 되돌리기

주석만 지우려면:

```bash
# 백업 먼저
cp -r md md.backup

# [그림 해설] 인용 블록 제거
sed -i '/^> \*\*\[그림 해설\]\*\*/,/^$/d' md/*.md
```

원본 PDF가 `docs/papers/`에 있으므로 최악의 경우
`scripts/convert_papers.sh`로 재생성하면 된다.