---
name: hwpx-verification
description: HWPX 수정본의 이미지·차이를 확인하고 검증 결과를 보고하거나 검증된 최종본을 만들 때 사용합니다.
---

# 결과 확인

수정본 생성과 검증 완료는 별개입니다. `apply_edit_plan` 성공 시 modified_path를 “수정본 · 시각 검증 전”으로 전달할 수 있습니다.

- `render_document`: 페이지 이미지 생성.
- `compare_document_versions`: 원본·수정본의 구조 및 시각 차이 비교.
- `review_document_vision`: 시각 검토. 호스트 검토 번들이 반환되면 이미지를 확인하고 `submit_host_vision_review`에 실제 판정을 기록합니다.
- `finalize_document`: Vision PASS가 기록된 수정본을 검증된 최종본으로 확정.

## 사용자 결과 확인

- `apply_edit_plan`이 성공하면 반환된 `user_preview_paths`의 실제 절대경로를 사용해 변경된 페이지 PNG를 답변에 직접 표시합니다. `![수정 결과](/Users/.../실제-preview.png)` 형식을 사용하며 내부 작업 폴더의 이미지 경로를 추측하거나 검색하지 않습니다. 변경 위치가 불명확할 때만 diff PNG도 함께 표시합니다.
- 이미지와 함께 “이 결과로 최종본을 만들까요?”라고 묻고 답변을 기다립니다. 최초 수정 요청이나 계획 승인은 결과 확인을 대신하지 않습니다.
- 사용자가 결과를 확인하기 전에는 `review_document_vision`, `submit_host_vision_review`, `finalize_document`를 호출하지 않습니다.
- 사용자가 맞다고 답하면 이미지를 실제로 검토하여 Vision 판정을 기록하고, PASS인 경우에만 최종화합니다. 사용자 확인 자체를 Vision PASS로 기록하지 않습니다.
- 사용자가 틀렸다고 답하면 해당 피드백만 반영해 계획을 교체하고 새 수정본 PNG를 다시 보여줍니다. 파일 가져오기·분석·인터뷰를 처음부터 반복하지 않습니다.

요청 범위 밖 변경, 글자 잘림, 사진 위치 등을 확인합니다. 확인하지 않은 상태를 PASS라고 기록하지 않습니다.
원본과 같은 레이아웃 경고는 새 편집 실패로 취급하지 않습니다. 기존 경고가 유지된다는 점을 알리고 나머지 검증을 진행합니다. 페이지/대상 경로가 표 전체를 가리키면 특정 입력 칸의 잘못이라고 추정하거나 전체 입력값을 줄이지 않습니다.
검증 도구가 지원되지 않으면 수정본과 확인하지 못한 범위를 전달합니다. 검증 실패본을 정상 최종본으로 표현하지 않습니다.
인자 오류는 해당 호출만 수정하고, 승인 오류는 승인 단계에서 처리합니다. 전체 분석·인터뷰를 무조건 다시 시작하지 않습니다.
넘침·잘림이 확인되면 `hwpx-styling`의 '넘침 발생 시 사용자에게 질문' 안내로 처리 방법을 묻습니다. 검증 실패 통보만 하고 끝내거나 이름·날짜·내용을 임의로 줄이지 않습니다.