Update README.md

README.md

@@ -60,6 +60,20 @@ UI 선택:
 MEGUMIN_UI=messenger
 ```
 
+## 메신저 레이아웃 메모
+
+`app_gradio_messenger.py`는 데스크톱 환경에서 Gradio 래퍼가 세로로 늘어나는 문제를 피하기 위해 고정 높이 메신저 레이아웃을 사용합니다.
+
+- 좌측과 우측 섹터는 Gradio `Column(scale=3)`과 `Column(scale=7)`로 `3:7` 비율을 사용합니다.
+- 메신저 패널 높이는 뷰포트 의존 flex 확장이 아니라 CSS 변수로 고정합니다.
+- 우측 섹터는 세 개의 고정 역할을 갖는 3행 grid로 나뉩니다.
+  `상단 헤더 = 96px`, `입력 영역 = 176px`, `메시지 표시 영역 = 나머지 높이`
+- 메신저 UI에서는 `gr.Blocks(fill_height=True)`를 의도적으로 사용하지 않습니다. Gradio의 자동 stretch 래퍼가 고정 높이 동작을 다시 깨뜨릴 수 있기 때문입니다.
+- 프로필 이미지는 외부 URL 대신 프로젝트 내부 `source_file` 폴더의 로컬 이미지를 사용합니다.
+- 우선순위는 `megumin_profile.png`, `megumin_profile.jpg`, `megumin_profile.jpeg`, `megumin_profile.webp`이며, 없으면 같은 폴더의 첫 번째 이미지 파일을 사용합니다.
+- 기본 SVG는 이미지 로드 실패 시에만 보이며, `source_file` 폴더는 메신저 단독 실행과 `app.py` 경유 실행 모두에서 `allowed_paths`로 명시적으로 서빙합니다.
+- 이후 메신저 레이아웃을 변경하면 `app_gradio_messenger.py`와 `docs/agent-architecture.md`를 함께 수정합니다.
+
 ## Hugging Face 구성
 
 앱 repo: