CODE_ASSISTANT/specs/002-capture-to-chat/quickstart.md

Quickstart: 화면 캡쳐 → 챗 첨부 검증

end-to-end "돌아간다" 확인 가이드. 구현은 tasks.md/구현 단계.

전제

• Windows + WebView2. 3_windowsApp 빌드(.NET SDK), 2_frontend npm install.
• DEBUG 실행은 WebView2 안에 vite dev 물어 띄움 → 브릿지 살아있음.

실행

# 데스크톱 런처(DEBUG) — CodeAssist.App 빌드/실행

단위 검증 (호스트 없이)

cd 2_frontend; npm run test    # Composer 이미지 첨부 상태·capture.image 수신(consume) 로직
dotnet test 3_windowsApp/CodeAssist.Tests   # (있으면) 좌표/DPI 변환 순수부

end-to-end 시나리오 (수동 — 오버레이·CopyFromScreen은 헤드리스 불가)

1. 오버레이 (AS-1): 아무 창 포커스 → Ctrl+Shift+9 → 모든 모니터가 어두워지며 캡쳐 오버레이 뜸(십자 커서).
2. 캡쳐→첨부 (AS-2): 영역 드래그 후 놓음 → 오버레이 닫히고 앱 창이 떠 새 대화로 이동, 입력창에 그 영역 썸네일 첨부 붙음.
3. 내용 일치 (SC-002): 첨부 썸네일이 드래그로 고른 영역과 내용·경계 일치.
4. 취소 (AS-3): 오버레이서 Esc 또는 드래그 없이 클릭 → 아무 캡쳐 없이 닫힘, 챗·클립보드 변화 없음.
5. 멀티모니터 (AS-5/SC-003): 보조 모니터 영역 드래그 → 그 영역 정확히 캡쳐.
6. 제거 (AS-4): 첨부의 X → 그 첨부 사라짐.
7. 누적 (AS-6): 한 번 더 캡쳐 → 첨부 하나 더 추가(기존 유지).
8. v1 전송 경계 (FR-009): 이미지 첨부 있는 상태로 메시지 전송 → 텍스트만 나가고 이미지는 백엔드로 안 감(분석 안 일어남). (백엔드 붙기 전까지 정상.)

참조

• 메시지·표면 계약: contracts/bridge-capture.md
• 데이터/상태: data-model.md
• 결정 근거(캡쳐 API·DPI·전달): research.md