# 설치 가이드 — 풀 패키지 (로컬 완결형 · Windows)

원고 업로드 없이 **HWPX까지 내 PC에서** 만듭니다. Claude Code 외에 **Node.js·(그림용)Python·한컴**이 필요합니다.

> ★ 작업은 **`projects/<과제명>/` 폴더** 안에서 진행됩니다(`/gdi-plan`이 자동 생성). 최종 산출물은 `projects\<과제명>\output\report_최종.hwpx` 입니다.

## 1단계 — 기본
1. **Git for Windows**: <https://git-scm.com/downloads/win> (기본값 설치)
2. **Claude Code 데스크탑 앱**: <https://claude.ai/download> → Windows x64 (.exe)
3. 앱 실행 → **Pro/Max 계정 로그인**

## 2단계 — 로컬 변환 도구 (이 패키지의 추가 요건)
4. **Node.js 18 이상 설치**: <https://nodejs.org> 에서 LTS — HWPX 변환·조판 엔진 구동용. 설치 후 새 명령창에서 `node -v` 로 확인.
5. (그림을 넣을 때만) **Python 3 + PyMuPDF**: <https://www.python.org> 설치 시 **'Add Python to PATH' 체크** → 새 명령창에서 `pip install pymupdf`. `sources/` PDF의 원본 도표 추출용.
6. **한컴오피스** — 차례 만들기·표지·PDF 내보내기·렌더 검증용.

## 3단계 — 패키지 열기
작업 폴더(예: `문서\GDI보고서`)에 zip을 풀고, 앱 **Code** 탭 → **+ New session** → 그 폴더 선택, **Environment: Local**.
(압축이 어려우면 빈 폴더를 열고 채팅 **+** 로 zip 첨부 후 "이 패키지 설치해줘".)

## 4단계 — 보고서 만들기 (앱 채팅창)
```
/gdi-plan 경상북도 ○○ 도입 및 활성화 방안
/gdi-research              ← 또는 sources 폴더에 자료를 직접 넣기
/gdi-chapter 1            ← 마지막 장까지
/gdi-finalize
```
→ `/gdi-finalize` 가 **로컬에서 build + 조판까지 수행**해 `projects\<과제명>\output\report_최종.hwpx` 를 만듭니다(웹앱 불필요).

## 5단계 — 한글에서 마무리
`projects\<과제명>\output\report_최종.hwpx` 를 한글로 열어:
- **[도구]-[차례/색인]-[차례 만들기]**(쪽번호 `000` 채움)
- 표지 `[확인요망]`(연구진·발간정보) 확정값 교체
- PDF 내보내기 용지 = **'문서 크기(190×260)'**

## 그림 넣기
- **개념도:** `※ 이미지 생성 프롬프트` 복사 → GPT Image / Nano Banana 생성 → 한글 `[그림]` 자리 삽입
- **데이터 그래프:** Claude가 준 **표**를 차트로(딸깍개발실 차트 딸깍 또는 직접) → 삽입
- **sources PDF 원본 도표 추출:** Python+PyMuPDF 설치 시 자동 추출 가능

## 자주 묻는 것
- 저장 시 **"[GDI 하네스 검토 요망]"** 안내는 오류가 아니라 출처 없는 수치 자동 점검(무시 가능).
- `node`·`pip` 명령이 안 먹으면 설치 후 **명령창을 새로 열어** PATH를 갱신하세요.
- HWPX 변환이 실패하면 `node -v` 가 18 이상인지 확인하세요.
