HWPX→HWP 재저장 파일 열기 실패 시 오류 미표시

[edwardkim]

재현 절차

1. 우리 웹뷰어에서 HWPX 파일 열기
2. 편집 후 저장 → .hwpx.hwp로 저장됨 (HWP 바이너리)
3. 다시 열기 → 렌더링 안 됨, 오류 로그 없음

근본 원인

• hwpctl/index.ts:74: SaveAs()가 항상 exportHwp() (HWP 바이너리) 호출
• 원본이 HWPX여도 HWP로 저장됨
• HWPX→HWP 변환 시 용지 크기 0mm 등 메타데이터 손실로 다시 열면 렌더링 실패

수정 방향

1. 원본 파일 형식(HWP/HWPX) 추적
2. HWPX 원본이면 serialize_hwpx로 저장 (WASM API 노출 필요 — HWPX 저장 WASM API 노출 및 사용자 오류 전달 #176)
3. 저장 실패 시 사용자에게 오류 알림
4. 파일 확장자를 원본 형식에 맞게 지정

관련

• HWPX 저장 WASM API 노출 및 사용자 오류 전달 #176 WASM API 노출
• HWPX Serializer: line_seg 정확한 계산으로 줄 넘김 정상화 #177 HWPX line_seg 정확화
• HWPX Serializer 구현 — Document IR → HWPX(ZIP+XML) 저장 #164 HWPX Serializer

[edwardkim]

2026-04-19 작업지시자 결정 — 방향 전환

배경

이슈 본문은 #176 (HWPX serializer WASM 노출) 완료를 전제로 "HWPX 원본이면 HWPX 저장" 으로 가는 방향이었으나, 다음 사정 발생:

1. 크롬 익스텐션 다운로드 10k 도달, 사용자 빠르게 증가
2. 사용자 리뷰 분석: HWPX 저장 시 한컴에서 깨지는 현상으로 큰 혼란
3. HWPX 완전 저장은 HWPX section.xml 완전 동적화 — secPr + 다중 run + Control dispatcher #186 (SectionWriter 완전 동적화) 등 추가 작업 필요 — 단기 해결 불가
4. 반면 HWP 저장 경로는 안정적, 한컴에서 정상 열림

결정

HWPX → HWPX 저장 안정화 전까지, HWPX 출처도 HWP로 저장:

1. file:save 분기에서 getSourceFormat() 결과와 무관하게 exportHwp() 호출
2. 파일명 확장자: .hwpx → .hwp
3. 모든 저장 경로 (File System Access API, 다운로드 폴백, save-as) 통일
4. 상태바 메시지: 문서.hwp 로 저장됨 (변환 사실 미표시 — 다음 패치에서 사용자 반응 확인 후 보강)
5. 모달 없음 (사용자 흐름 방해 최소화)

진행

• 정식 단계별 절차 (수행계획서 → 구현계획서 → 단계별 구현)
• 브랜치: local/task178
• 마일스톤: M100 (v1.0.0)

향후

#186 (SectionWriter 완전 동적화 + Control dispatcher) 완료 후 HWPX 저장 경로 복구 검토. 본 결정은 베타 단계의 임시 조치.

[edwardkim]

2026-04-19 첫 시도 실패 + 차기 방향

시도 (실패)

local/task178 (커밋 4587685, 폐기됨):

• rhwp-studio/src/command/commands/file.ts:save 에서 HWPX 출처도 exportHwp() 호출
• hwpctl/index.ts::SaveAs 도 동일

가정: HWP serializer 가 안정적이므로 HWPX → HWP 변환이 한컴 호환을 보장.

작업지시자 사용자 검증 결과 (실패)

samples/hwpx/hwpx-h-01.hwpx 로드 → 저장 (편집 없음 / reflow 보정 후 둘 다):

• rhwp: 회색 캔버스, 캐럿만 깜빡임 (페이지 렌더링 0)
• 한컴: "파일을 읽거나 저장하는데 오류가 있습니다"

자동 진단

시나리오	rhwp page_count
HWP 원본 → HWP 저장 → 재로드	1 → 1 (정상)
HWPX-h-01 → HWP 저장 → 재로드	9 → 209 (23배 폭주)
HWPX-02 → HWP 저장 → 재로드	6 → 155 (26배 폭주)
reflow_linesegs_on_demand 강제 후	효과 없음

진짜 원인 (작업지시자 통찰)

hwpx 의 경우 저장할 때는 hwp 시리얼라이제이션에 대한 매핑이 필요한건 당연한 것 아닌가?

HWPX-IR 과 HWP-IR 사이의 매핑 어댑터 부재.

• HWPX 파서: vpos=0, raw_ctrl_data 비움, attr=0, Section.raw_stream=None, table.common 사용
• HWP serializer: raw_ctrl_data 우선, attr 비트 연산, raw_stream 우선, table.attr 사용

HWPX 파서가 채운 IR 을 HWP serializer 에 그대로 넣으면 다층 손상 발생. 페이지 컨트롤·문단 break_type·표 attr·셀 list_attr 등 광범위한 영역에서 의미 불일치.

정리 결정

• local/task178 브랜치 폐기 (방법 1, 작업지시자 결정)
• local/devel 은 HWPX Serializer: line_seg 정확한 계산으로 줄 넘김 정상화 #177 완료 시점 그대로 유지 — HWPX 저장은 기존 깨진 동작 유지 (배포 전과 동일)
• 디버그 샘플 samples/hwpx/hwpx-h-0[123].hwpx 보존 (cc90db4)
• 진단 문서: mydocs/troubleshootings/task178_hwpx_to_hwp_first_attempt_failure.md

차기 방향: HWPX→HWP IR 매핑 어댑터

새 타스크에서 진행. 후보 매핑 영역:

1. 페이지 컨트롤: HWPX <hp:secPr> → HWP SECTION_DEF + raw_ctrl_data 재구성
2. 문단 break_type: HWPX pageBreak/columnBreak → HWP PARA_HEADER break_type 바이트
3. 표 속성: HWPX table.common → HWP table.attr 비트 + raw_ctrl_data 재구성
4. 셀 속성: apply_inner_margin → list_attr bit 16
5. lineseg vpos: HWPX 항상 0 → HWP 사전계산 (reflow + paginate 결과)
6. Section.raw_stream 합성: HWP serializer 가 raw_stream 우선이라면 HWPX 출처에는 합성 필요
7. FileHeader / DocProperties: HWPX 정보 부족 → HWP 기본값 채우기

기존 문서 mydocs/tech/hwp_hwpx_ir_differences.md (8 항목) 활용 + 추가 영역 발견 예정.

일정 추정

수일 ~ 1~2주 — HWPX 출처 IR 의 차이 영역이 광범위.

본 실패에서 얻은 교훈

1. "안정적 경로" 가정의 한계 — HWP serializer 는 HWP 출처 IR 에 한해 안정. HWPX 출처는 검증되지 않음.
2. 단일 필드 진단의 한계 — lineseg 는 차이의 한 단면. 매핑 차이는 다층적.
3. 작업지시자 논리적 검증의 가치 — "당연히 매핑이 필요" 라는 질문이 잘못된 진단을 정정.

본 이슈 OPEN 유지. 차기 방향은 새 작업 (수행계획서 → 구현계획서 → 단계별)으로 진행.