jakal-hwpx — ChatGPT 한 줄로 한글 문서 자동 완성

사용법

ChatGPT에 프롬프트 한줄, 그게 전부

코딩 지식 없어도 됩니다. ChatGPT가 알아서 합니다.

Step 1

📎

파일 첨부

hwpx 양식 파일 + PDF·텍스트 등 참고 자료를 ChatGPT에 올립니다

Step 2 — 핵심
💬
프롬프트 한 줄 추가
원하는 내용을 입력하고 아래 한 줄을 붙여넣으세요
python으로 jakal-hwpx을 반드시 설치 및 활용하고, xml 편집은 이용하지 말것. save(validate=True)로 해줘

완료

📥

검증된 파일 다운로드

ChatGPT가 검증까지 마친 hwpx 파일을 바로 줍니다

Q. Python·코드 직접 필요? 아니요. 프롬프트 한 줄이 전부입니다.

Q. 어떤 ChatGPT 플랜? 코드 실행(Code Interpreter)이 지원되는 플랜.

실제 예시

연구계획서 자동 완성

PDF 보고서를 참고해서 빈 양식을 자동으로 채운 결과입니다.

① ChatGPT 화면 — 파일 2개 첨부 + 프롬프트 한 줄

hwpx 연구계획서(팀장이름).hwpx

pdf 사키 보고서.pdf

사키 보고서를 바탕으로 연구계획서를 작성해줘.

python으로 jakal-hwpx을 반드시 설치 및 활용하고, xml 편집은 이용하지 말것. save(validate=True)로 해줘

▶ pip install jakal-hwpx ... ✓ ▶ 사키 보고서.pdf 분석 중... ✓ ▶ 표 항목 자동 채움... ✓ ▶ validation_errors() → [] ✓ 연구계획서_완성.hwpx 생성 완료 ✅

② 결과물 비교 — 빈 양식 → 자동 완성

⬜ Before — 빈 양식

연 구 계 획 서

□ 연구계획 요약

연구과제명	국문	( 작성 필요 )
	영문	( 작성 필요 )
연구 분야	수학( ), 물리학( ), 화학( ), 생명과학( ), ...
연구 요약	( 내용 작성 )

→

✅ After — 자동 완성 + 검증 통과

연 구 계 획 서

□ 연구계획 요약

연구과제명	국문	유산균의 장내 유해세균 억제 효과 및 항균물질 특성 분석
	영문	Analysis of the Inhibitory Effects of Probiotic Lactic Acid Bacteria on Harmful Intestinal Bacteria and the Characteristics of Their Antimicrobial Substances
연구 분야	수학( ), 물리학( ), 화학( ), 생명과학(O), 지구과학( )
연구 요약	본 연구는 시중 프로바이오틱스에 포함되는 Lactococcus lactis와 Lactobacillus acidophilus가 장내 유해세균의 생장을 억제할 수 있는지를 실험적으로 검증하고, 그 항균 작용의 원인 물질을 분석하는 것을 목적으로 한다. 표적 균주로는 Staphylococcus pasteuri와 Shigella flexneri를 선정하여, agar plug/disk diffusion method로 억제 효과를 정량 비교한다...

✅ validation_errors() → []

✅ save_reopen 통과

③ 실제 결과 화면 (한글에서 열기)

사용 사례:

📋 사회보장 신청서 🎓 졸업논문 양식 🔢 수식 문서 📝 각종 보고서

개발자용

API 레퍼런스 · 안전 규칙

직접 코드로 사용하는 개발자를 위한 섹션입니다.

설치 & 빠른 시작

설치

pip install jakal-hwpx

빠른 시작

from jakal_hwpx import HwpxDocument

doc = HwpxDocument.open("양식.hwpx")
doc.replace_text("{{제목}}", "연구 제목")
t = doc.tables()[0]
t.set_cell_text(0, 2, "유산균 항균 연구")
doc.save("완성.hwpx", validate=True)

주요 API 목록

HwpxDocument.open(path)

replace_text(old, new)

set_paragraph_text(si, pi, text)

tables() / set_cell_text(r, c, v)

pictures() / equations()

validation_errors()

save_reopen_validation_errors()

save(path, validate=True)

AI 안전 규칙 19개 — ChatGPT 프롬프트에 추가 권장

AI 안전 규칙 (복사해서 프롬프트에 추가)

1. jakal_hwpx.HwpxDocument를 범용 편집기처럼 직접 쓰지 말 것. 2. save(validate=False)를 절대 호출하지 말 것. 3. 저장 후 검증 없이 파일을 반환하지 말 것. 4. validation_errors(), xml_validation_errors(), reference_validation_errors(), save_reopen_validation_errors() 중 하나라도 실패하면 결과 파일을 폐기할 것. 5. save_reopen_validation_errors() 호출 실패나 예외를 무시하지 말 것. 6. add_part(), remove_part(), 내부 XML/XPath 직접 수정, ZIP 후처리를 금지할 것. 7. replace_text()는 짧고 고유한 플레이스홀더 치환에만 사용할 것. 8. 사람용 지시문 문장 전체를 replace_text()로 바꾸려 하지 말 것. 9. 문단 교체는 승인된 문단 슬롯에 대해서만 set_paragraph_text()를 사용할 것. 10. set_paragraph_text()는 헤더/도형/복합 컨트롤 문단에는 사용하지 말 것. 11. 표 수정은 승인된 셀 좌표에 대해서만 set_cell_text()를 사용할 것. 12. 병합 셀 구조를 추측해서 수정하지 말 것. 13. 새 문단/새 섹션 추가는 템플릿이 허용한 위치에서만 수행할 것. 14. 배포보호 문서(is_distribution_protected)는 수정하지 말 것. 15. 플레이스홀더 치환 후 잔여 지시문, 플레이스홀더, 작성 안내 문구가 남아 있으면 실패로 처리할 것. 16. 치환/수정 성공 개수를 확인하고, 예상 개수와 다르면 실패로 처리할 것. 17. 검증 실패 시 우회 저장, 강제 저장, 재시도 저장을 하지 말 것. 18. 출력은 항상 새 파일로 저장하고 원본 템플릿을 덮어쓰지 말 것. 19. 가능하면 set_preview_text()를 채울 것.

프롬프트 한 줄 추가

ChatGPT에 프롬프트 한줄, 그게 전부

연구계획서 자동 완성

표·이미지·수식 전부 지원

API 레퍼런스 · 안전 규칙

지금 바로 딸깍 하세요