hwpx (HWPX / OWPML)
.hwpx는 ZIP 기반 OWPML 문서다. 모든 작업은
python-hwpx-automation의 MCP 도구를 1차 경로로 사용한다. 새 설정은 정식
host-local key hwpx, launcher scripts/hwpx-automation-mcp, 콘솔
hwpx-automation-mcp를 사용한다. hwpx-mcp-server 이름과 launcher wrapper는
6.x 호환 표면이며 host key는 MCP 프로토콜 식별자가 아니다.
MCP가 없을 때의 local Python(python-hwpx >= 6.5.0) 대안과 번들 스크립트는 references 문서에만 있다.
일반적인 읽기·편집·양식 채움·문서 생성처럼 여러 단계를 거치는 작업은 서버가 상태와 안전 정책을
강제하는 start_workflow를 1차 경로로 쓴다. get_workflow·continue_workflow로 진행하고,
decision에서만 approve_workflow_decision을 호출한다. 중단·재개는 cancel_workflow·resume_workflow를
쓴다. 큰 결과의 resultRef는 get_workflow_result로 회수한다. typed 입력과 영수증 계약은
workflows-autonomous를 본다.
primitive 도구는 workflow가 지원하지 않는 전문 작업 또는 진단용 escape hatch다. 단, 처음 보는
기존 문서의 semantic 구조를 탐색하고 본문·표 셀·기존 단순 머리글 story 또는 블록 이동·복사를
포함한 이종 편집을 한 번에 적용하는 요청은
get_document_node → query_document_nodes → apply_document_commands 경로를 쓴다.
지원되는 문서·하위 트리를 다른 HWPX로 이식할 때는 같은 경로로 source/target canonical path를
확정한 뒤 dump_document_blueprint → manifest의 unsupported/fidelity 검토 →
replay_document_blueprint(dry-run → commit)를 쓴다.
기존 문서의 읽기/문안/적용 전환, 손편집 후 재조회, 허용 범위와 기준본 보존, Python·CLI·MCP 안전 가드는
기존 편집 안내를 따른다. 구조 검사 통과와 실제 한컴 화면 확인은 별도로 보고한다.
시작 체크
MCP 서버가 연결되어 있으면 작업 전에 mcp_server_health()를 호출해
version, pythonHwpxVersion, toolSurface.status, toolSurface.missingKeyTools를 확인한다.
toolSurface.status != "ok"이거나 핵심 도구가 누락되면 플러그인 번들을 갱신하고 새 호스트 세션을
시작하라고 안내한다 — Claude Code: claude plugin marketplace update hwpx && claude plugin update hwpx-plugin@hwpx,
Codex: codex plugin marketplace upgrade && codex plugin add hwpx-plugin@hwpx. 그래도 같으면 stale
모든 HWPX MCP 서버를 종료한 뒤 관리 런타임을 점검한다. 실행 중 환경을 삭제하지 않는다.
응답에 stackUpdate가 있으면 세션당 한 번만 본다. 공개 automation 7.0.3에는 이 필드가 없으며 후속 버전부터 제공된다.
stackUpdate.pluginBundle.latestKnown이 installed보다 높으면 위 호스트별 갱신 명령을 사용자에게
한 번 안내하고 작업을 계속한다. stackUpdate.lastError는 런타임 자동 갱신이 마지막에 실패했다는
기록이지 작업 차단 사유가 아니다 — 보고만 한다. 런타임(python-hwpx·python-hwpx-automation)은
Claude·Codex 관리 런처가 시작 시 점검 간격(기본 24시간)이 지났으면 갱신을 시도한다.
runtime.restartRequired가 참이면 새 환경은 준비됐지만 현재 서버에는 아직 적용되지 않았으므로
새 호스트 세션에서 사용된다고 안내한다. verified 채널은 고정이며 OpenClaw·Hermes 직접 uvx는 수동 갱신이다.
단위는 인간 단위다: 글자 크기 pt, 줄간격 %, 들여쓰기 mm, 문단 간격 pt, 용지/여백 mm.
케이스 → 경로 라우팅 표
| 사용자 요청 패턴 |
1차 경로 (MCP 도구) |
상세 참조 |
| 낯선 기존 문서의 구조 탐색 + 본문·표 셀·기존 단순 머리글 story·블록 이종 편집·이동·복사 |
get_document_node → query_document_nodes → apply_document_commands (dry-run → commit) |
workflows-agent-document |
| 지원 문서·결재/양식 블록을 다른 HWPX로 안전하게 이식 |
get_document_node/query_document_nodes → dump_document_blueprint → replay_document_blueprint (dry-run → commit) |
workflows-agent-blueprint |
| 일반 복합 HWPX 읽기·편집·생성 (아래 전문 양식·시험 경로 제외) |
start_workflow → continue_workflow → 필요 시 approve_workflow_decision |
workflows-autonomous |
| 최종 산출물을 실제 한컴으로 렌더·검증 |
render_health → render_submit → render_status |
workflows-real-hancom-render |
| 양식 채움·기존 좌표 편집용 구조·표·필드·앵커 지도 |
get_document_map |
workflows-editing |
| 텍스트·개요·표 내용 읽기 |
get_document_text · get_document_outline · get_table_text |
api |
| Markdown/HTML/JSON 변환·추출 |
hwpx_to_markdown · hwpx_to_html · hwpx_extract_json · document_to_markdown · document_extract_json |
api |
| 런서식(굵게·색·크기·글꼴) + 각주/미주 본문까지 충실 읽기 |
hwpx_extract_json (format_detail·doc.notes[]) · hwpx_to_markdown (각주 부록) |
workflows-reading |
| 일반 텍스트 위치 찾기 |
find_text |
workflows-editing |
| 이미 canonical path가 확정된 본문·표 좌표와 기존 단순 머리글 story 편집 (2건 이상) |
apply_document_commands (dry-run → commit) |
workflows-agent-document |
| 바이트-스플라이스 다단 편집(표 구조+본문+셀 채움 혼합, 실패 시 부분 적용이 허용 안 되는 작업) |
run_edit_plan (계획 1파일, dry_run=true → 실행 — all-or-nothing 원자, 개별 도구 연타 금지) |
workflows-editing |
| 단건 치환·문단·표 셀 편집 |
search_and_replace · batch_replace · insert_paragraph · set_table_cell_text |
workflows-editing |
| 직전 편집 되돌리기 |
undo_last_edit |
workflows-editing |
| 줄간격·정렬·들여쓰기·문단 간격 변경 |
set_paragraph_format |
workflows-editing |
| 용지 크기·방향·여백·단 설정 |
set_page_setup |
workflows-editing |
| 머리글/바닥글 추가·수정 |
set_header_footer |
workflows-editing |
| 쪽번호 추가·수정 |
set_page_number |
workflows-editing |
| 기존 문단을 불릿/번호 목록으로 |
set_list_format |
workflows-editing |
| 그림 삽입 / 그림만 교체 |
insert_picture · replace_picture |
workflows-editing |
| 굵게·색·글꼴 등 글자 서식, 사용자 스타일 |
format_text · create_custom_style · list_styles |
workflows-editing |
| 표 병합·분할·머리행·테두리(선 종류/색/굵기)·셀 음영 |
merge_table_cells · split_table_cell · format_table |
workflows-editing |
| 검토 메모 추가·삭제 |
add_memo · add_memo_by_anchor · remove_memo |
workflows-editing |
| 충실도 민감·대형 문서의 문단 텍스트 패치 |
byte_preserving_patch |
workflows-editing |
| 생성/편집 후 레이아웃 확인 |
render_preview self-check 루프 |
workflows-editing |
| 한컴 없이 수식 포함 문서 스크롤 통독 검수 |
render_preview(viewer=true, screenshot="off") |
workflows-preview |
| 자연어 요청으로 새 문서 생성 |
validate_document_plan → create_document_from_plan |
workflows-creation |
| Markdown/비-HWPX 원본에서 HWPX 초안 생성 |
document_to_markdown → markdown_to_document_plan → create_document_from_plan |
workflows-creation |
| 공문·보고서·가정통신문 (유형별 한컴 양식 프로파일 + 공문 구조 hard-gate·결문 메타·맞춤법 정직보고) |
create_document_from_plan (metadata.document_type + gyeolmun) |
workflows-authoring |
| 살아있는 목차(한컴이 재계산)·쪽 번호 상호참조 |
add_toc · add_cross_reference · verify_toc |
workflows-toc |
| 변경추적 redline 저작 (삽입/삭제/치환 + 코멘트, 사람이 한컴서 수락/거부) |
add_tracked_edit (+ add_memo_by_anchor) |
workflows-redline |
| 개인정보(PII) 탐지·마스킹 (읽기·추출 기본 마스킹, 쓰기 입력 사전 정제) |
scan_personal_info · 읽기/추출 mask param |
workflows-pii |
| 정부보고서·공문형 보고서 (□/○/※ 불릿) |
parse_government_report_text → document plan 구성·검증 → create_document_from_plan |
workflows-creation |
| 운영 계획서 제출 후보 |
document-plan + quality_profile="operating_plan" |
workflows-creation |
| 운영 계획서 하우스 스타일·섹션칩 변주 |
skill이 genre/profile/variable slot 판단 → 기존 document-plan MCP 경로 |
workflows-house-style |
| 제안서·기획안 |
proposal document plan → create_document_from_plan → inspect_document_quality |
workflows-creation |
| 기안문 서식 저작 (별지 제1호 일반기안문 / 제2호 간이기안문) |
compose_official_draft · compose_simple_draft → validate_document_plan → create_document_from_plan (결재란 칸은 결재자 수만큼만·결문 라벨 미인쇄·선택항목은 [ ]+√) |
workflows-authoring |
| 체크박스 양식개체가 실제로 쓰이는 서식(공문서 아님) |
add_check_box 계열 core API (공문서는 [ ] 텍스트 관례) |
workflows-authoring |
| 공문서 작성규정 lint·결재란 |
inspect_official_document_style |
workflows-creation, 규정 |
| 직인/관인 날인 (발신명의 끝글자에 도장) · 날인 규정 pass/fail 검사 |
place_seal · check_seal_compliance |
workflows-forms |
| 출제 md를 학교 시험지 양식에 재조판 (문항 keep-together, 그림은 placeholder) |
compose_exam · verify_question_splits |
workflows-exam |
LaTeX 수식을 네이티브 <hp:equation>으로 삽입 (커버리지 밖 typed 거부) |
add_equation |
workflows-authoring |
| 데이터 시리즈를 네이티브 차트로 삽입 (막대·꺾은선·원, 밖은 typed 거부) |
add_chart |
workflows-authoring |
| 운영계획서를 백지에서 장르-충실하게 저작(섹션칩·개조식·박스 조직도) |
get_genre_grammar · compose_section_chip · add_boxed_org_chart |
workflows-authoring |
| 평가계획(교수학습운영 및 평가계획) 전문 채움 (J1~J6 두뇌 판단·붙여넣기용 MD 저작) |
apply_evalplan_fill(filename=..., review_md=..., output=..., phase="clean", render_check="required", score_gold_path=...) → 필요 시 advanced score_form_fill |
workflows-evalplan |
| 낯선 양식·누름틀·라벨 셀·경로 셀·표 밖 본문이 섞인 채움 |
analyze_form_fill(plan=...) → plan 승인 → apply_form_fill(plan=...) (plan.dryRun dry-run → commit) → verify_form_fill(plan=...) |
workflows-forms |
| 메일머지 N부 대량생산 (상장·수료증·안내장·명부 CSV/XLSX) · 셀 넘침 격리(fit) |
mail_merge (fit_mode) |
workflows-bulk-compare |
| 표 합계·평균·소계 계산 |
table_compute |
workflows-bulk-compare |
| 두 문서/문단 비교 (신구 diff) |
doc_diff |
workflows-bulk-compare |
| 신구대조표 문서 생성 |
doc_diff → comparison document plan → create_document_from_plan |
workflows-bulk-compare |
| 사진대지 생성 |
build_image_grid → create_document_from_plan |
workflows-bulk-compare |
| 회의 명패 생성 |
build_meeting_nameplates → create_document_from_plan |
workflows-bulk-compare |
| 조직도 생성 |
build_organization_chart → create_document_from_plan |
workflows-bulk-compare |
| 참조 문서 서식 이식·템플릿 등록 |
extract_style_profile · apply_style_profile_to_plan · register_template |
workflows-bulk-compare |
| 붙임·표/그림 번호 정합성 검사 |
inspect_reference_consistency |
workflows-bulk-compare |
| 깨졌거나 한컴에서 안 열리는 파일 |
repair_hwpx (복구 복사본 생성) |
api |
| 원본 보존용 사본 만들기 |
copy_document |
api |
| MCP 없음: 텍스트 추출·표 포함 전역 치환 |
scripts/text_extract.py · scripts/zip_replace_all.py |
api |
양식 채움 우선순위
시험은 compose_exam, 평가계획은 apply_evalplan_fill, 그 밖의 양식은
analyze_form_fill → apply_form_fill 순서다. mixed plan에는 native field, label cell,
canonical path, body anchor를 함께 넣고 한 트랜잭션으로 적용한다. public 저수준
프리미티브 apply_table_ops/apply_body_ops는 양식 채움 밖의 표·본문 구조 작업에 직접
쓸 수 있으나, 양식 채움에서는 canonical 한 트랜잭션을 쪼개지 않는다. fill_form_field,
fill_by_path, find_cell_by_label, analyze_template_formfit/apply_template_formfit은
새 요청의 1차 경로가 아니다(DEPRECATED, 5.0 경계 확정 — 동작 유지·제거는 다음 major).
전환이 필요한 기존 호출에서만 generated contract의 deprecation/replacement guidance를 따른다.
공통 안전 수칙
- 원본 보존: 기존 문서를 편집할 때는 원본을 직접 덮어쓰지 말고
copy_document 사본 또는
별도 destination에서 작업한다. 양식 채움은 항상 원본과 다른 destination에만 적용한다.
- openSafety: 생성 계약이
openSafety를 선언한 쓰기 도구는 openSafety.ok == true
(또는 도구별 verification receipt의 대응 필드)를 확인한다. 필드가 없는 도구는 해당
도구가 선언한 전용 영수증과 재열기 검증을 사용하며, 존재하지 않는 공통 필드를 추정하지 않는다.
- dry_run 우선: 생성 계약이
dry_run과 semanticDiff를 선언한 쓰기 도구는 이를 먼저
검토한 뒤 확정 저장한다. 미지원 도구에는 인자를 임의로 추가하지 말고 도구별 안전 절차를 따른다.
- blueprint 정직성:
unsupported가 비었고 strict fidelity.ok == true인 replayable bundle만
이식한다. raw XML·ZIP 내부 XML·package path를 직접 편집하거나 degraded를 exact로 부르지 않는다.
- 증거 계약:
visual_review_required=true이면
references/evidence-contract.md의 요건
(current.status == "observed_pass" + current.screenshot_path)을 충족하기 전에는
최종 제출 가능 상태라고 주장하지 않는다.
- 깨졌거나 열리지 않는 파일은 편집 전에
repair_hwpx로 복구 복사본을 만든다.
- 치환 키에
<, > 같은 XML 조각을 넣지 않는다. 태그가 아닌 텍스트 플레이스홀더만 치환한다.
낯선 문서 구조 편집 루프
get_document_node(filename, path="/", depth=2)로 bounded 구조와 revision을 얻는다.query_document_nodes(..., limit=<bounded>)로 후보를 좁히고 한 canonical path를 확정한다.
여러 후보 중 첫 항목을 임의 선택하거나 volatilePath를 다른 revision에서 재사용하지 않는다.- 관련 변경을 한
apply_document_commands(..., dry_run=true) batch로 검토한다.
- diff가 맞으면 새 idempotency key로 commit한다. commit 재시도에만 같은 key를 쓴다.
ok, rolledBack == false, verificationReport.openSafety.ok, 선언한 검증 영수증을 확인한다.
머리글 story를 포함했다면 verificationReport.storyPreservation.ok == true와 대상 stableId도 확인한다.
스키마·오류 복구·CLI replay는
references/workflows-agent-document.md를 본다. 양식·시험·PII·
메일머지·lint 같은 도메인 작업은 이 generic 경로로 낮추지 않고 전문 도구를 유지한다.
블루프린트 이식 루프
- source와 target을 각각
get_document_node/query_document_nodes로 읽어 revision-bound canonical
path를 확정한다. 여러 후보 중 첫 항목을 임의 선택하지 않는다.
- 교차 문서 이식은
mode="portable"로 dump_document_blueprint를 호출한다. 같은 source fingerprint에만
재생할 때만 source-bound를 쓴다.
- 반환 manifest의
unsupported, fidelity, dependency/resource 수, blueprintHash를 검토한다.
inspect/edit가 필요하면 hwpx dump --inspect로 typed JSON만 꺼내고 hwpx dump --repack으로 안전하게
재포장한다. ZIP/XML을 직접 고치지 않는다.
replay_document_blueprint에 bundle hash, target input/output, targetParent, position, mode,
expectedRevision, strict mapping, idempotency key, 검증 요구사항을 모두 넣고 먼저 dryRun=true로 실행한다.- dry-run의 node/dependency map,
exact|mapped|degraded|unsupported fidelity와 semantic diff를 확인한다.
commit에는 새 idempotency key를 쓰고, 동일 요청 재시도에만 같은 key를 쓴다.
- commit에서
rolledBack == false, package/reopen/reference/resource/byte preservation,
verificationReport.openSafety.ok, domain 영수증을 확인한다. 실패하면 output이 보존됐는지 확인하고 성공으로 간주하지 않는다.
- 실제 한컴 검증이 요구되면
render_health → render_submit → render_status의 matching full-page
영수증까지 받아야 한다. oracle unavailable/mismatch는 unverified다.
전체 envelope·CLI·실패 처리와 전문 workflow 경계는
references/workflows-agent-blueprint.md를 본다.
확정 좌표 편집 표준 루프
get_document_map(filename) — 개요·표·양식 필드·앵커와 document_revision을 확보한다.- 확정된 좌표·앵커를 command 목록으로 만들어
apply_document_commands(filename, output, commands=[...], dry_run=true)를 호출한다 — semanticDiff와
verificationReport.openSafety.ok를 확인한다.
- diff가 의도와 일치하면 같은 commands를
dry_run=false, 새 idempotency key,
expected_revision=<1의 document_revision>으로 재실행해 확정한다.
- 응답의
ok, rolledBack == false, verificationReport.openSafety.ok, semanticDiff를
확인한다. stale_revision이면 문서를 다시 읽고 새 revision으로 재시도한다.
- dry-run과 commit은 request hash가 달라 idempotency key를 공유하지 않는다 — commit
재시도에만 같은 key를 쓴다.
연산 스키마·selector·실패 코드 상세는
references/workflows-agent-document.md를 본다.
기존 호출자를 위한 compatibility facade apply_edits(operation-list 스키마,
undo_last_edit 1단계 되돌리기)는 references/workflows-editing.md를 본다.
참조 인덱스
references/workflows-autonomous.md — 서버 강제 5-family workflow, decision/재개/needs_review/사전 렌더 영수증 계약.references/workflows-agent-document.md — 낯선 문서 semantic view/query, canonical path, 본문·표 셀·기존 단순 머리글 story의 원자 set과 add/remove/move/copy batch, structured failure와 CLI replay.references/workflows-agent-blueprint.md — typed .hwpxbp dump/inspect/repack, portable/source-bound dependency mapping, atomic replay, strict fidelity와 real-Hancom 검증.references/workflows-real-hancom-render.md — 비동기 실한컴 제출·폴링·artifact provenance·취소·degraded 처리.references/workflows-editing.md — 트랜잭션 편집 루프, 서식 5종, 그림, byte patch, render_preview.references/workflows-creation.md — document-plan, builder, 정부보고서, 운영계획서, 제안서, 공문서 레시피.references/workflows-redline.md — 변경추적 저작(insert/delete/replace + 코멘트), 사람이 한컴서 수락/거부, verify 영수증. add_tracked_edit.references/workflows-pii.md — 개인정보(PII) 탐지, 읽기·추출 기본 마스킹, 폼필·메일머지 입력 사전 정제 + 가명/비식별. scan_personal_info · 읽기/추출 mask param.references/workflows-reading.md — 런서식(굵게·색·크기·글꼴)+각주/미주 본문 충실 읽기. hwpx_extract_json(format_detail·doc.notes[])·hwpx_to_markdown 각주 부록, document_to_markdown 로컬 ingest.references/workflows-toc.md — 네이티브 자동 차례·상호참조(재페이지네이션 시 한컴이 재번호). add_toc·add_cross_reference·verify_toc.references/workflows-preview.md — 한컴 없는 스크롤 통독 문서 뷰어(수식 MathML 렌더 fail-closed 3단계), 환경별 전달(Claude Code=Artifact/Codex=local open), 충실도 티어 정직 라벨. render_preview(viewer=true).- 처음 이 스킬로 HWPX 작업 시작 시:
describe_capabilities로 실제 FastMCP 작업군을 확인한다. 정확한 default/advanced/필수 도구 계약은 자동 생성된 tool-contract.generated.md가 정본이다.
references/workflows-forms.md — canonical mixed-form plan/apply/verify, 평가계획 facade, legacy replacement 경계.references/workflows-evalplan.md — 평가계획 실채움 두뇌 판단(J1~J6): 붙여넣기용 MD 저작, phase="clean" 대표 경로, 신규 지시문·정상 본문 구별·측면 매핑·변형 선택·렌더 해석. 스코어≠제출가능·오너 검수 권위.references/workflows-exam.md — 시험지 조판: 출제 md→학교 양식 재조판, 문항 keep-together, 커브-export 정직 게이트(시각 증거).references/workflows-bulk-compare.md — 메일머지, 표 계산, 신구대조, 생성기 3종, 스타일 프로파일/템플릿.references/evidence-contract.md — openSafety·visual-review v1·hard gates·제출 증거 계약.references/api.md — python-hwpx 시그니처, MCP 도구 표, repair/recover, 번들 스크립트.references/migration-mcp-5.0.md — 5.0 경계: 제거 5종 대체표, DEPRECATED 1군, 2군 권장 경로.references/official-document-rules.md — 공문서 항목 표시·끝 표시·붙임·날짜/금액 규칙.references/migration-core-5.0.md — python-hwpx 5.0에서 응용 워크플로가 MCP로 이동한 내역과 직접 import 사용자를 위한 대체표.- 설치 직후 최소 검증:
python3 examples/01_create_and_save.py → python3 scripts/text_extract.py examples/out/01_created.hwpx.
1---2name: hwpx3description: 한글 문서(.hwpx/OWPML) 편집·추출·자동화 스킬. '한글 문서 편집해줘', 가정통신문·공문·한글 양식 작성, HWPX 편집, 한글 파일/OWPML 분석, 플레이스홀더 치환, 문서 자동화 요청이면 이 스킬을 반드시 사용하세요. 줄간격·여백·쪽번호·머리글 등 서식 변경, 그림 삽입/교체, 문서 비교·신구대조표, 메일머지 대량생산(상장·수료증·가정통신문), 사진대지·회의명패·조직도 생성, 표 합계/소계 계산 요청도 모두 이 스킬의 대상입니다.4---56# hwpx (HWPX / OWPML)78`.hwpx`는 ZIP 기반 OWPML 문서다. 모든 작업은9`python-hwpx-automation`의 MCP 도구를 1차 경로로 사용한다. 새 설정은 정식10host-local key `hwpx`, launcher `scripts/hwpx-automation-mcp`, 콘솔11`hwpx-automation-mcp`를 사용한다. `hwpx-mcp-server` 이름과 launcher wrapper는126.x 호환 표면이며 host key는 MCP 프로토콜 식별자가 아니다.13MCP가 없을 때의 local Python(`python-hwpx >= 6.5.0`) 대안과 번들 스크립트는 references 문서에만 있다.1415일반적인 읽기·편집·양식 채움·문서 생성처럼 여러 단계를 거치는 작업은 서버가 상태와 안전 정책을16강제하는 `start_workflow`를 1차 경로로 쓴다. `get_workflow`·`continue_workflow`로 진행하고,17`decision`에서만 `approve_workflow_decision`을 호출한다. 중단·재개는 `cancel_workflow`·`resume_workflow`를18쓴다. 큰 결과의 `resultRef`는 `get_workflow_result`로 회수한다. typed 입력과 영수증 계약은19[workflows-autonomous](references/workflows-autonomous.md)를 본다.20primitive 도구는 workflow가 지원하지 않는 전문 작업 또는 진단용 escape hatch다. 단, 처음 보는21기존 문서의 semantic 구조를 탐색하고 본문·표 셀·기존 단순 머리글 story 또는 블록 이동·복사를22포함한 이종 편집을 한 번에 적용하는 요청은23`get_document_node` → `query_document_nodes` → `apply_document_commands` 경로를 쓴다.24지원되는 문서·하위 트리를 다른 HWPX로 이식할 때는 같은 경로로 source/target canonical path를25확정한 뒤 `dump_document_blueprint` → manifest의 unsupported/fidelity 검토 →26`replay_document_blueprint`(dry-run → commit)를 쓴다.2728기존 문서의 읽기/문안/적용 전환, 손편집 후 재조회, 허용 범위와 기준본 보존, Python·CLI·MCP 안전 가드는29[기존 편집 안내](references/workflows-existing-edit.md)를 따른다. 구조 검사 통과와 실제 한컴 화면 확인은 별도로 보고한다.3031## 시작 체크3233MCP 서버가 연결되어 있으면 작업 전에 `mcp_server_health()`를 호출해34`version`, `pythonHwpxVersion`, `toolSurface.status`, `toolSurface.missingKeyTools`를 확인한다.35`toolSurface.status != "ok"`이거나 핵심 도구가 누락되면 플러그인 번들을 갱신하고 **새 호스트 세션**을36시작하라고 안내한다 — Claude Code: `claude plugin marketplace update hwpx && claude plugin update hwpx-plugin@hwpx`,37Codex: `codex plugin marketplace upgrade && codex plugin add hwpx-plugin@hwpx`. 그래도 같으면 stale38모든 HWPX MCP 서버를 종료한 뒤 관리 런타임을 점검한다. 실행 중 환경을 삭제하지 않는다.39응답에 `stackUpdate`가 있으면 세션당 한 번만 본다. 공개 automation 7.0.3에는 이 필드가 없으며 후속 버전부터 제공된다.40`stackUpdate.pluginBundle.latestKnown`이 `installed`보다 높으면 위 호스트별 갱신 명령을 사용자에게41**한 번** 안내하고 작업을 계속한다. `stackUpdate.lastError`는 런타임 자동 갱신이 마지막에 실패했다는42기록이지 작업 차단 사유가 아니다 — 보고만 한다. 런타임(`python-hwpx`·`python-hwpx-automation`)은43Claude·Codex 관리 런처가 시작 시 점검 간격(기본 24시간)이 지났으면 갱신을 시도한다.44`runtime.restartRequired`가 참이면 새 환경은 준비됐지만 현재 서버에는 아직 적용되지 않았으므로45새 호스트 세션에서 사용된다고 안내한다. `verified` 채널은 고정이며 OpenClaw·Hermes 직접 uvx는 수동 갱신이다.46단위는 인간 단위다: 글자 크기 pt, 줄간격 %, 들여쓰기 mm, 문단 간격 pt, 용지/여백 mm.4748## 케이스 → 경로 라우팅 표4950| 사용자 요청 패턴 | 1차 경로 (MCP 도구) | 상세 참조 |51|---|---|---|52| 낯선 기존 문서의 구조 탐색 + 본문·표 셀·기존 단순 머리글 story·블록 이종 편집·이동·복사 | `get_document_node` → `query_document_nodes` → `apply_document_commands` (dry-run → commit) | [workflows-agent-document](references/workflows-agent-document.md) |53| 지원 문서·결재/양식 블록을 다른 HWPX로 안전하게 이식 | `get_document_node`/`query_document_nodes` → `dump_document_blueprint` → `replay_document_blueprint` (dry-run → commit) | [workflows-agent-blueprint](references/workflows-agent-blueprint.md) |54| 일반 복합 HWPX 읽기·편집·생성 (아래 전문 양식·시험 경로 제외) | `start_workflow` → `continue_workflow` → 필요 시 `approve_workflow_decision` | [workflows-autonomous](references/workflows-autonomous.md) |55| 최종 산출물을 실제 한컴으로 렌더·검증 | `render_health` → `render_submit` → `render_status` | [workflows-real-hancom-render](references/workflows-real-hancom-render.md) |56| 양식 채움·기존 좌표 편집용 구조·표·필드·앵커 지도 | `get_document_map` | [workflows-editing](references/workflows-editing.md) |57| 텍스트·개요·표 내용 읽기 | `get_document_text` · `get_document_outline` · `get_table_text` | [api](references/api.md) |58| Markdown/HTML/JSON 변환·추출 | `hwpx_to_markdown` · `hwpx_to_html` · `hwpx_extract_json` · `document_to_markdown` · `document_extract_json` | [api](references/api.md) |59| 런서식(굵게·색·크기·글꼴) + 각주/미주 본문까지 충실 읽기 | `hwpx_extract_json` (`format_detail`·`doc.notes[]`) · `hwpx_to_markdown` (각주 부록) | [workflows-reading](references/workflows-reading.md) |60| 일반 텍스트 위치 찾기 | `find_text` | [workflows-editing](references/workflows-editing.md) |61| 이미 canonical path가 확정된 본문·표 좌표와 기존 단순 머리글 story 편집 (2건 이상) | `apply_document_commands` (dry-run → commit) | [workflows-agent-document](references/workflows-agent-document.md) |62| 바이트-스플라이스 다단 편집(표 구조+본문+셀 채움 혼합, 실패 시 부분 적용이 허용 안 되는 작업) | `run_edit_plan` (계획 1파일, `dry_run=true` → 실행 — all-or-nothing 원자, 개별 도구 연타 금지) | [workflows-editing](references/workflows-editing.md) |63| 단건 치환·문단·표 셀 편집 | `search_and_replace` · `batch_replace` · `insert_paragraph` · `set_table_cell_text` | [workflows-editing](references/workflows-editing.md) |64| 직전 편집 되돌리기 | `undo_last_edit` | [workflows-editing](references/workflows-editing.md) |65| 줄간격·정렬·들여쓰기·문단 간격 변경 | `set_paragraph_format` | [workflows-editing](references/workflows-editing.md) |66| 용지 크기·방향·여백·단 설정 | `set_page_setup` | [workflows-editing](references/workflows-editing.md) |67| 머리글/바닥글 추가·수정 | `set_header_footer` | [workflows-editing](references/workflows-editing.md) |68| 쪽번호 추가·수정 | `set_page_number` | [workflows-editing](references/workflows-editing.md) |69| 기존 문단을 불릿/번호 목록으로 | `set_list_format` | [workflows-editing](references/workflows-editing.md) |70| 그림 삽입 / 그림만 교체 | `insert_picture` · `replace_picture` | [workflows-editing](references/workflows-editing.md) |71| 굵게·색·글꼴 등 글자 서식, 사용자 스타일 | `format_text` · `create_custom_style` · `list_styles` | [workflows-editing](references/workflows-editing.md) |72| 표 병합·분할·머리행·테두리(선 종류/색/굵기)·셀 음영 | `merge_table_cells` · `split_table_cell` · `format_table` | [workflows-editing](references/workflows-editing.md) |73| 검토 메모 추가·삭제 | `add_memo` · `add_memo_by_anchor` · `remove_memo` | [workflows-editing](references/workflows-editing.md) |74| 충실도 민감·대형 문서의 문단 텍스트 패치 | `byte_preserving_patch` | [workflows-editing](references/workflows-editing.md) |75| 생성/편집 후 레이아웃 확인 | `render_preview` self-check 루프 | [workflows-editing](references/workflows-editing.md) |76| 한컴 없이 수식 포함 문서 스크롤 통독 검수 | `render_preview(viewer=true, screenshot="off")` | [workflows-preview](references/workflows-preview.md) |77| 자연어 요청으로 새 문서 생성 | `validate_document_plan` → `create_document_from_plan` | [workflows-creation](references/workflows-creation.md) |78| Markdown/비-HWPX 원본에서 HWPX 초안 생성 | `document_to_markdown` → `markdown_to_document_plan` → `create_document_from_plan` | [workflows-creation](references/workflows-creation.md) |79| 공문·보고서·가정통신문 (유형별 한컴 양식 프로파일 + 공문 구조 hard-gate·결문 메타·맞춤법 정직보고) | `create_document_from_plan` (`metadata.document_type` + `gyeolmun`) | [workflows-authoring](references/workflows-authoring.md) |80| 살아있는 목차(한컴이 재계산)·쪽 번호 상호참조 | `add_toc` · `add_cross_reference` · `verify_toc` | [workflows-toc](references/workflows-toc.md) |81| 변경추적 redline 저작 (삽입/삭제/치환 + 코멘트, 사람이 한컴서 수락/거부) | `add_tracked_edit` (+ `add_memo_by_anchor`) | [workflows-redline](references/workflows-redline.md) |82| 개인정보(PII) 탐지·마스킹 (읽기·추출 기본 마스킹, 쓰기 입력 사전 정제) | `scan_personal_info` · 읽기/추출 `mask` param | [workflows-pii](references/workflows-pii.md) |83| 정부보고서·공문형 보고서 (□/○/※ 불릿) | `parse_government_report_text` → document plan 구성·검증 → `create_document_from_plan` | [workflows-creation](references/workflows-creation.md) |84| 운영 계획서 제출 후보 | document-plan + `quality_profile="operating_plan"` | [workflows-creation](references/workflows-creation.md) |85| 운영 계획서 하우스 스타일·섹션칩 변주 | skill이 genre/profile/variable slot 판단 → 기존 document-plan MCP 경로 | [workflows-house-style](references/workflows-house-style.md) |86| 제안서·기획안 | proposal document plan → `create_document_from_plan` → `inspect_document_quality` | [workflows-creation](references/workflows-creation.md) |87| 기안문 서식 저작 (별지 제1호 일반기안문 / 제2호 간이기안문) | `compose_official_draft` · `compose_simple_draft` → `validate_document_plan` → `create_document_from_plan` (결재란 칸은 결재자 수만큼만·결문 라벨 미인쇄·선택항목은 `[ ]`+√) | [workflows-authoring](references/workflows-authoring.md) |88| 체크박스 양식개체가 실제로 쓰이는 서식(공문서 아님) | `add_check_box` 계열 core API (공문서는 `[ ]` 텍스트 관례) | [workflows-authoring](references/workflows-authoring.md) |89| 공문서 작성규정 lint·결재란 | `inspect_official_document_style` | [workflows-creation](references/workflows-creation.md), [규정](references/official-document-rules.md) |90| 직인/관인 날인 (발신명의 끝글자에 도장) · 날인 규정 pass/fail 검사 | `place_seal` · `check_seal_compliance` | [workflows-forms](references/workflows-forms.md) |91| 출제 md를 학교 시험지 양식에 재조판 (문항 keep-together, 그림은 placeholder) | `compose_exam` · `verify_question_splits` | [workflows-exam](references/workflows-exam.md) |92| LaTeX 수식을 네이티브 `<hp:equation>`으로 삽입 (커버리지 밖 typed 거부) | `add_equation` | [workflows-authoring](references/workflows-authoring.md) |93| 데이터 시리즈를 네이티브 차트로 삽입 (막대·꺾은선·원, 밖은 typed 거부) | `add_chart` | [workflows-authoring](references/workflows-authoring.md) |94| 운영계획서를 백지에서 장르-충실하게 저작(섹션칩·개조식·박스 조직도) | `get_genre_grammar` · `compose_section_chip` · `add_boxed_org_chart` | [workflows-authoring](references/workflows-authoring.md) |95| **평가계획(교수학습운영 및 평가계획) 전문 채움** (J1~J6 두뇌 판단·붙여넣기용 MD 저작) | `apply_evalplan_fill(filename=..., review_md=..., output=..., phase="clean", render_check="required", score_gold_path=...)` → 필요 시 advanced `score_form_fill` | [workflows-evalplan](references/workflows-evalplan.md) |96| 낯선 양식·누름틀·라벨 셀·경로 셀·표 밖 본문이 섞인 채움 | `analyze_form_fill(plan=...)` → plan 승인 → `apply_form_fill(plan=...)` (`plan.dryRun` dry-run → commit) → `verify_form_fill(plan=...)` | [workflows-forms](references/workflows-forms.md) |97| 메일머지 N부 대량생산 (상장·수료증·안내장·명부 CSV/XLSX) · 셀 넘침 격리(fit) | `mail_merge` (`fit_mode`) | [workflows-bulk-compare](references/workflows-bulk-compare.md) |98| 표 합계·평균·소계 계산 | `table_compute` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |99| 두 문서/문단 비교 (신구 diff) | `doc_diff` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |100| 신구대조표 문서 생성 | `doc_diff` → comparison document plan → `create_document_from_plan` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |101| 사진대지 생성 | `build_image_grid` → `create_document_from_plan` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |102| 회의 명패 생성 | `build_meeting_nameplates` → `create_document_from_plan` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |103| 조직도 생성 | `build_organization_chart` → `create_document_from_plan` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |104| 참조 문서 서식 이식·템플릿 등록 | `extract_style_profile` · `apply_style_profile_to_plan` · `register_template` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |105| 붙임·표/그림 번호 정합성 검사 | `inspect_reference_consistency` | [workflows-bulk-compare](references/workflows-bulk-compare.md) |106| 깨졌거나 한컴에서 안 열리는 파일 | `repair_hwpx` (복구 복사본 생성) | [api](references/api.md) |107| 원본 보존용 사본 만들기 | `copy_document` | [api](references/api.md) |108| MCP 없음: 텍스트 추출·표 포함 전역 치환 | `scripts/text_extract.py` · `scripts/zip_replace_all.py` | [api](references/api.md) |109110### 양식 채움 우선순위111112시험은 `compose_exam`, 평가계획은 `apply_evalplan_fill`, 그 밖의 양식은113`analyze_form_fill` → `apply_form_fill` 순서다. mixed plan에는 native field, label cell,114canonical path, body anchor를 함께 넣고 **한 트랜잭션**으로 적용한다. public 저수준115프리미티브 `apply_table_ops`/`apply_body_ops`는 양식 채움 밖의 표·본문 구조 작업에 직접116쓸 수 있으나, 양식 채움에서는 canonical 한 트랜잭션을 쪼개지 않는다. `fill_form_field`,117`fill_by_path`, `find_cell_by_label`, `analyze_template_formfit`/`apply_template_formfit`은118새 요청의 1차 경로가 아니다(DEPRECATED, 5.0 경계 확정 — 동작 유지·제거는 다음 major).119전환이 필요한 기존 호출에서만 generated contract의 deprecation/replacement guidance를 따른다.120121## 공통 안전 수칙122123- **원본 보존**: 기존 문서를 편집할 때는 원본을 직접 덮어쓰지 말고 `copy_document` 사본 또는124 별도 destination에서 작업한다. 양식 채움은 항상 원본과 다른 destination에만 적용한다.125- **openSafety**: 생성 계약이 `openSafety`를 선언한 쓰기 도구는 `openSafety.ok == true`126 (또는 도구별 verification receipt의 대응 필드)를 확인한다. 필드가 없는 도구는 해당127 도구가 선언한 전용 영수증과 재열기 검증을 사용하며, 존재하지 않는 공통 필드를 추정하지 않는다.128- **dry_run 우선**: 생성 계약이 `dry_run`과 `semanticDiff`를 선언한 쓰기 도구는 이를 먼저129 검토한 뒤 확정 저장한다. 미지원 도구에는 인자를 임의로 추가하지 말고 도구별 안전 절차를 따른다.130- **blueprint 정직성**: `unsupported`가 비었고 strict `fidelity.ok == true`인 replayable bundle만131 이식한다. raw XML·ZIP 내부 XML·package path를 직접 편집하거나 degraded를 exact로 부르지 않는다.132- **증거 계약**: `visual_review_required=true`이면133 [`references/evidence-contract.md`](references/evidence-contract.md)의 요건134 (`current.status == "observed_pass"` + `current.screenshot_path`)을 충족하기 전에는135 최종 제출 가능 상태라고 주장하지 않는다.136- 깨졌거나 열리지 않는 파일은 편집 전에 `repair_hwpx`로 복구 복사본을 만든다.137- 치환 키에 `<`, `>` 같은 XML 조각을 넣지 않는다. 태그가 아닌 텍스트 플레이스홀더만 치환한다.138139## 낯선 문서 구조 편집 루프1401411. `get_document_node(filename, path="/", depth=2)`로 bounded 구조와 `revision`을 얻는다.1422. `query_document_nodes(..., limit=<bounded>)`로 후보를 좁히고 한 canonical path를 확정한다.143 여러 후보 중 첫 항목을 임의 선택하거나 `volatilePath`를 다른 revision에서 재사용하지 않는다.1443. 관련 변경을 한 `apply_document_commands(..., dry_run=true)` batch로 검토한다.1454. diff가 맞으면 **새 idempotency key**로 commit한다. commit 재시도에만 같은 key를 쓴다.1465. `ok`, `rolledBack == false`, `verificationReport.openSafety.ok`, 선언한 검증 영수증을 확인한다.147 머리글 story를 포함했다면 `verificationReport.storyPreservation.ok == true`와 대상 `stableId`도 확인한다.148149스키마·오류 복구·CLI replay는150[`references/workflows-agent-document.md`](references/workflows-agent-document.md)를 본다. 양식·시험·PII·151메일머지·lint 같은 도메인 작업은 이 generic 경로로 낮추지 않고 전문 도구를 유지한다.152153## 블루프린트 이식 루프1541551. source와 target을 각각 `get_document_node`/`query_document_nodes`로 읽어 revision-bound canonical156 path를 확정한다. 여러 후보 중 첫 항목을 임의 선택하지 않는다.1572. 교차 문서 이식은 `mode="portable"`로 `dump_document_blueprint`를 호출한다. 같은 source fingerprint에만158 재생할 때만 `source-bound`를 쓴다.1593. 반환 manifest의 `unsupported`, `fidelity`, dependency/resource 수, `blueprintHash`를 검토한다.160 inspect/edit가 필요하면 `hwpx dump --inspect`로 typed JSON만 꺼내고 `hwpx dump --repack`으로 안전하게161 재포장한다. ZIP/XML을 직접 고치지 않는다.1624. `replay_document_blueprint`에 bundle hash, target input/output, targetParent, position, mode,163 `expectedRevision`, strict mapping, idempotency key, 검증 요구사항을 모두 넣고 먼저 `dryRun=true`로 실행한다.1645. dry-run의 node/dependency map, `exact|mapped|degraded|unsupported` fidelity와 semantic diff를 확인한다.165 commit에는 새 idempotency key를 쓰고, 동일 요청 재시도에만 같은 key를 쓴다.1666. commit에서 `rolledBack == false`, package/reopen/reference/resource/byte preservation,167 `verificationReport.openSafety.ok`, domain 영수증을 확인한다. 실패하면 output이 보존됐는지 확인하고 성공으로 간주하지 않는다.1687. 실제 한컴 검증이 요구되면 `render_health` → `render_submit` → `render_status`의 matching full-page169 영수증까지 받아야 한다. oracle unavailable/mismatch는 `unverified`다.170171전체 envelope·CLI·실패 처리와 전문 workflow 경계는172[`references/workflows-agent-blueprint.md`](references/workflows-agent-blueprint.md)를 본다.173174## 확정 좌표 편집 표준 루프1751761. `get_document_map(filename)` — 개요·표·양식 필드·앵커와 `document_revision`을 확보한다.1772. 확정된 좌표·앵커를 command 목록으로 만들어 `apply_document_commands(filename, output,178 commands=[...], dry_run=true)`를 호출한다 — `semanticDiff`와179 `verificationReport.openSafety.ok`를 확인한다.1803. diff가 의도와 일치하면 같은 commands를 `dry_run=false`, 새 idempotency key,181 `expected_revision=<1의 document_revision>`으로 재실행해 확정한다.1824. 응답의 `ok`, `rolledBack == false`, `verificationReport.openSafety.ok`, `semanticDiff`를183 확인한다. `stale_revision`이면 문서를 다시 읽고 새 revision으로 재시도한다.1845. dry-run과 commit은 request hash가 달라 idempotency key를 공유하지 않는다 — commit185 재시도에만 같은 key를 쓴다.186187연산 스키마·selector·실패 코드 상세는188[`references/workflows-agent-document.md`](references/workflows-agent-document.md)를 본다.189기존 호출자를 위한 compatibility facade `apply_edits`(operation-list 스키마,190`undo_last_edit` 1단계 되돌리기)는 [`references/workflows-editing.md`](references/workflows-editing.md)를 본다.191192## 참조 인덱스193194- [`references/workflows-autonomous.md`](references/workflows-autonomous.md) — 서버 강제 5-family workflow, decision/재개/needs_review/사전 렌더 영수증 계약.195- [`references/workflows-agent-document.md`](references/workflows-agent-document.md) — 낯선 문서 semantic view/query, canonical path, 본문·표 셀·기존 단순 머리글 story의 원자 set과 add/remove/move/copy batch, structured failure와 CLI replay.196- [`references/workflows-agent-blueprint.md`](references/workflows-agent-blueprint.md) — typed `.hwpxbp` dump/inspect/repack, portable/source-bound dependency mapping, atomic replay, strict fidelity와 real-Hancom 검증.197- [`references/workflows-real-hancom-render.md`](references/workflows-real-hancom-render.md) — 비동기 실한컴 제출·폴링·artifact provenance·취소·degraded 처리.198- [`references/workflows-editing.md`](references/workflows-editing.md) — 트랜잭션 편집 루프, 서식 5종, 그림, byte patch, render_preview.199- [`references/workflows-creation.md`](references/workflows-creation.md) — document-plan, builder, 정부보고서, 운영계획서, 제안서, 공문서 레시피.200- [`references/workflows-redline.md`](references/workflows-redline.md) — 변경추적 저작(insert/delete/replace + 코멘트), 사람이 한컴서 수락/거부, verify 영수증. `add_tracked_edit`.201- [`references/workflows-pii.md`](references/workflows-pii.md) — 개인정보(PII) 탐지, 읽기·추출 기본 마스킹, 폼필·메일머지 입력 사전 정제 + 가명/비식별. `scan_personal_info` · 읽기/추출 `mask` param.202- [`references/workflows-reading.md`](references/workflows-reading.md) — 런서식(굵게·색·크기·글꼴)+각주/미주 본문 충실 읽기. `hwpx_extract_json`(`format_detail`·`doc.notes[]`)·`hwpx_to_markdown` 각주 부록, `document_to_markdown` 로컬 ingest.203- [`references/workflows-toc.md`](references/workflows-toc.md) — 네이티브 자동 차례·상호참조(재페이지네이션 시 한컴이 재번호). `add_toc`·`add_cross_reference`·`verify_toc`.204- [`references/workflows-preview.md`](references/workflows-preview.md) — 한컴 없는 스크롤 통독 문서 뷰어(수식 MathML 렌더 fail-closed 3단계), 환경별 전달(Claude Code=Artifact/Codex=local open), 충실도 티어 정직 라벨. `render_preview(viewer=true)`.205- **처음 이 스킬로 HWPX 작업 시작 시**: `describe_capabilities`로 실제 FastMCP 작업군을 확인한다. 정확한 default/advanced/필수 도구 계약은 자동 생성된 [`tool-contract.generated.md`](references/tool-contract.generated.md)가 정본이다.206- [`references/workflows-forms.md`](references/workflows-forms.md) — canonical mixed-form plan/apply/verify, 평가계획 facade, legacy replacement 경계.207- [`references/workflows-evalplan.md`](references/workflows-evalplan.md) — 평가계획 실채움 두뇌 판단(J1~J6): 붙여넣기용 MD 저작, `phase="clean"` 대표 경로, 신규 지시문·정상 본문 구별·측면 매핑·변형 선택·렌더 해석. 스코어≠제출가능·오너 검수 권위.208- [`references/workflows-exam.md`](references/workflows-exam.md) — 시험지 조판: 출제 md→학교 양식 재조판, 문항 keep-together, 커브-export 정직 게이트(시각 증거).209- [`references/workflows-bulk-compare.md`](references/workflows-bulk-compare.md) — 메일머지, 표 계산, 신구대조, 생성기 3종, 스타일 프로파일/템플릿.210- [`references/evidence-contract.md`](references/evidence-contract.md) — openSafety·visual-review v1·hard gates·제출 증거 계약.211- [`references/api.md`](references/api.md) — python-hwpx 시그니처, MCP 도구 표, repair/recover, 번들 스크립트.212- [`references/migration-mcp-5.0.md`](references/migration-mcp-5.0.md) — 5.0 경계: 제거 5종 대체표, DEPRECATED 1군, 2군 권장 경로.213- [`references/official-document-rules.md`](references/official-document-rules.md) — 공문서 항목 표시·끝 표시·붙임·날짜/금액 규칙.214- [`references/migration-core-5.0.md`](references/migration-core-5.0.md) — python-hwpx 5.0에서 응용 워크플로가 MCP로 이동한 내역과 직접 import 사용자를 위한 대체표.215- 설치 직후 최소 검증: `python3 examples/01_create_and_save.py` → `python3 scripts/text_extract.py examples/out/01_created.hwpx`.
airmang