무료) hwpx 딸깍, jakal-hwpx 초간단 사용법
게시글 주소: https://orbi.kr/00078138940
[양식] 2026_오르비_보고서.hwp
jakal-hwpx-수정.hwp
jakal-hwpx-딸깍.hwp
기존의 방식(메인글)은 설치가 복잡하여서 많은 분들이 사용하지 못했습니다.
저희는
CHATGPT에 로그인만 되어있으면 jakal-hwpx를 사용할 수 있도록 추가하였습니다.
1) 사용 방법
(1) 유료 GPT 요금제가 있는경우

thiniking이나 pro를 쓰시고 hwpx 파일을 첨부하고
gpt에게
"python으로 jakal-hwpx을 반드시 설치 및 활용하고, xml 편집은 이용하지 말것. save(validate = True)로 해줘 " + (요청사항 프롬프트) 로 입력하면 됩니다.
(2) 유료 GPT 요금제가 없는경우
+잘 생각하기 누르고 hwpx 파일을 첨부하고
"python으로 jakal-hwpx을 반드시 설치 및 활용하고, xml 편집은 이용하지 말것. save(validate = True)로 해줘 " + (요청사항 프롬프트) 로 입력하면 됩니다.
(다만, 사용량이 적고 성능도 떨어질 겁니다..)
2) 사용 예시
(1) 수능 수학 편집
매우 간단한 문제입니다.[251101]

문제 변형을 요청하였고

성공적인 문제 변환에 성공하였습니다.
(2) 학교 숙제
양식을 준비해봤습니다.

그리고 저에 대해서 조사해서 보고서를 만들어보라고 시켜봤습니다.

처음에는 완벽하지는 않지만, 양식을 깨트리지 않고 수정에 성공하였습니다.

이건 제가 5분정도 편집하여서 만든 최종본 파일입니다.
양식, jakal-hwpx 수정본, 저의 수정본은 첨부파일을 통해 확인할 수 있습니다.
3) 한계점
저희가 만든건 hwpx를 gpt가 편집할 수 있도록 하는것이라
생성되는 문서의 품질을 보장하지는 않고
베타 버전인지라 버그가 많을 수 있습니다.
4) Q&A
(1) GPT가 hwp 지원한다고 하던데?
맞습니다. 다만 기존의 방식인 xml 수정으로는 읽기는 잘하는데 복잡한 문서의 쓰기에선 오류를 내는 경우가 많습니다.
저희는 이걸 줄이기 위해 생성 전에 오류를 검증하는 과정을 강화했습니다.
(2) ㅈ구리고 버그만 ㅈㄴ 많네 ㅋㅋㅋ
맞습니다. 저희도 더 좋은 품질의 hwpx가 생성되기 위해 최대한 노력해보겠습니다.
다만, AI의 성능이 hwpx를 스스로 편집할 만큼 뛰어나지 못할 수 있다는 점 양해 바랍니다.
(3) 다른 모델(claude, gemini는 지원이 됨?)
claude는 설정 => 기능 =>코드 실행 및 파일 생성 => 네트워크 송신 허용 => 모든 도메인 설정후 사용 가능합니다.

gemini는 지원할 수 있는 방법을 찾지는 못했습니다. 추후 찾으면 알려드리겠습니다.
(4) hwp는 안되나?
넵. 한컴에서 hwp -> hwpx 변환해서 올려주세요
(5) 문의사항
여기 오르비 댓글이나 쪽지로 문의해주시면 최대한 빨리 답변드리겠습니다!
(6) hwpx가 안열리는데?
무결성이 어디서 생겼는지 jakal-hwpx등을 이용하여 추적하고 고쳐줘" 과 같이 다시 입력하면
GPT가 수정해줄 확률이 높습니다.
밑 프롬프트를 추가해서 첨부하면 성공 가능성이 높아집니다.
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()를 채울 것.
5) 끝맺음
https://github.com/Ahnd6474/jakal-hwpx STAR

와 이 게시글에 좋아요 부탁합니다!
0 XDK (+0)
유익한 글을 읽었다면 작성자에게 XDK를 선물하세요.
-
day 하나 풀려면 앞으로 갔다 뒤로 갔다 해야 하는 거 귀찮으면 걔추
-
초등교사가 되려면 교대에 가야하는건 알지만 지스트나 유니스트 나와서 정확히 어떤...
-
이노래 오랜만이다 3 0
갑자기 생각남
-
여기까지 상대 탁월 내 탁월 상대한테 g5 한턴만 주면 바로 지는건데 비비는 탁월...
-
ㅅㅂ 오늘 차였어 15 1
내가 이성적 매력이 없나봐
-
한자 (일본어) 폭탄 11 2
후핫후핫
-
초미녀 퇴근 12 0
잘까? 게임할까?
-
중앙대 가기 79일차 9 0
안녕하세요 중앙대29학번 부산사나이 이동현입니다 . 부산의 명수 날뛰는 우레...
-
라떼는 수학 가형 나형이었다 13 0
문과는 통통이가 아니라 수학 나형이었다 확통런이 아니라 나형런이었고 이과들은...
-
간쓸개 연계 7 0
간쓸개 즌2 김승리 현강에서 받고 안 풀엇는데 연계 도움 많이 되나요? 매승도...
-
ㅈㄴ 기만인게 일단 서울대를 가야 하고 거기에서 자아성찰까지 해야 함
-
님들 요새는 탐구 뭐해야함? 8 1
보통 어느정도 성적이냐 목표 대학이 어디냐에 따라 갈릴텐데 과탐+과탐하기에는...
-
연대생 집합!!! 6 1
반수 할 사람 있나요
-
영과고 괴물들은 못이김 7 2
선대나 유기화학 분생 이런것 까지 한번 경험해보고 들어감+ ㅈㄴ 똑똑함 때문에...
-
뭔 개소리세요 14 0
에효
-
토익 990은 진짜 인정이다 9 1
토익 듣기 진짜 존나 안들리던데
-
4월부터 n제하면 늦는거임?? 8 0
아까 어떤분이 "4월 말부터 n제하면 좀 늦을까요,,,," 이 글 올렸다가...
-
자살마렵누... 8 1
수학쌤이 냉정하게 말하면 저1등급 못 받는다는데 너무 우울하네요...ㅜㅜㅜ
-
어떨 것 같나요 일단 전 싫음
-
무물보 11 0
부남 무물보 받아요!
엄청나군요

꼭 저희의 프로그램이 도움이 되시기를 바랍니다그리고 국어칼럼 감사합니다! 애용하고 있어요
유용한 도구를 만드시고 배포해주시느라 고생이 많으십니다. MCP나 클로드코드 스킬을 만드는 쪽으로 알아보시면 더 유용한 도구를 만드시는 데 도움이 될 수 있을 것 같아요.

좋은 말씀 감사합니다!어케햣노
조장 ㅅㄲ가 코딩 개고수임
Codex로 마법을 부리던데 ㅈㄴ 신기함