核心用法
hwpx_my는 한글 HWPX 포맷 문서의 템플릿 기반 자동 생성을 위한 스킬입니다. ZIP 구조를 활용한 경량 치환 방식으로 작동하며, 전용 파서 없이도 템플릿 내 플레이스더를 탐색하고 JSON 매핑 파일을 통해 일괄 치환합니다.
주요 커맨드:
analyze-template <path>— 템플릿에서 텍스트 플레이스홀더 추출apply-template <template> <mapping.json> <out.hwpx>— 매핑 데이터로 치환 후 출력
워크플로우:
1. assets/report-template.hwpx 기본 플릿 또는 사용자 업로드 템플릿(uploads/) 준비
2. analyze-template로 치환 가능한 필드 식별
3. JSON 매핑 파일 작성 후 apply-template 실행
4. 결과물 outputs/에 저장
확장성: python-hwpx 설치 시 전체 ObjectFinder 기능 사용 가능; 미설치 시 lib/hwpx_shim.py 경량 셔 제공
显著优点
- 한글 전용 최적화: 국내 표준 HWPX 포맷原生 지원
- 경량 구조: ZIP 레벨 치환으로 무거운 문서 엔진 불필요
- 템플릿 친화적: 양식 기반 워크플로우, 재사용성 높음
- MIT 라이선스: 상업/개인 용도 자유로운 사용
潜在缺点与局限性
- 구조적 제약: ZIP 레벨 치환은 서식 보존에 한계; 복잡한 서식/표/이미지 동적 조정 어려움
- python-hwpx 의존성: 고급 기능(ObjectFinder)은 추가 패키지 필요
- 검증 부재: 제공된 문서에 보안 스캔 정보 없음, 실제 안전성 미확인
- 단일 포맷: HWPX만 지원, DOCX/PDF 등 크로스 포맷 호환 없음
- 템플릿 품질 의존: 출력물 품질은 템플릿 설계에 전적으로 의존
适合人群
- 한글 문서 자동화가 필요한 국내 기업/공공기관 담당자
- 정형화된 보고서(주간/월간 리포트, 감사 결과서 등)를 반복 생성하는 사용자
- 개발자가 템플릿 엔진을 직접 구축하기보다 경량 솔루션을 선호하는 경우
常规风险
- 데이터 노출:
mapping.json에 민감 정보 포함 시 버전관리 시스템 유출 위험 - 템플릿 주입: 외부 템플릿 파일 신성 검증 필요; 악성 XML/매크로 가능성
- 출력 무결성: ZIP 치환 실패 시 손상된 문서 생성, 사전 백업 권장
- 의존성 관리:
python-hwpx버전 불일치로 기능 동작 불능 가능성