Skip to content

Feature: rhwpDev 디버깅 툴킷 개선 - activeId 매핑 실패 대응 강화 #449

@edwardkim

Description

@edwardkim

문제 상황 (Context)

서드파티 애플리케이션(예: 윤문 프로그램 등)에서 rhwp 렌더링 뷰어와 연동 시, AI 모델이 제공한 activeId가 실제 DOM에 존재하지 않거나 찾지 못하는 매핑 실패 이슈가 간헐적으로 발생합니다.
예: [InlineDocView] activeId 11 에 해당하는 요소를 찾지 못했습니다.

원인 추정

  1. AI의 환각(Hallucination)에 의한 잘못된 ID 참조
  2. 표/글상자 내부 등 DOM 깊은 곳에 위치하여 서드파티의 단순 선택자로 탐색 불가
  3. 비동기 렌더링 지연에 따른 타이밍 이슈

제안하는 개선 사항 (Proposed Solutions)

외부 개발자의 디버깅 경험(DX) 향상을 위해 rhwpDev 디버깅 툴킷에 다음 기능들을 추가합니다.

  1. rhwpDev.showAllIds() (시각적 ID 오버레이)
    • 렌더링된 요소들 위에 data-id 또는 pi/ci 값을 직접 반투명 오버레이하여 직관적인 확인 지원
  2. 스마트 에러 로깅 (가장 가까운 ID 추천)
    • ID 매핑 실패 시 단순 에러가 아닌, "존재하지 않는 이유"나 "가장 인접한 유효 ID"를 분석하여 콘솔에 안내
  3. rhwpDev.search(text) 헬퍼 함수 추가
    • 텍스트를 인자로 넣으면 내부 파싱 트리를 역추적하여 해당 텍스트 블록의 정확한 activeId 및 좌표를 반환 (AI 환각/매핑 오류 시 Fallback 용도)

Metadata

Metadata

Assignees

Labels

enhancementNew feature or request

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions