Clarity

1. 01

   어떤 앱 위에서도 바로 열리는 오버레이

   문제

   화면을 캡처하고 파일을 옮기기 위해 작업 중인 앱과 브라우저의 챗봇을 오가는 과정이 반복됐습니다.

   선택

   작은 알약형 창으로 대기하다가 누르면 대화 패널로 확장되고, 드래그로 원하는 위치에 둘 수 있는 상시 오버레이를 만들었습니다.

   구현

   Tauri 창을 pill과 panel 두 크기로 전환하고 항상 위·작업 표시줄 제외 상태를 유지했습니다. 클릭과 드래그를 구분하고 마지막 위치를 로컬에 저장해 다음 실행 때 복원했습니다.

   확인된 영향

   Windows 설치본에서 다른 작업 화면 위에 Clarity를 두고, 필요할 때 확장하거나 위치를 바꾸는 흐름이 작동했습니다.

2. 02

   자동 기록보다 요청형 맥락과 전송 전 통제

   문제

   초기에는 최근 1분의 화면을 자동으로 구성했지만, 여러 이미지가 세부 텍스트와 작업 흐름을 충분히 전달하지 못했고 화면 기록을 일시 정지하는 통제도 없었습니다.

   선택

   현재 공개본에서는 카메라 버튼을 눌렀을 때만 현재 화면을 첨부하고, 준비 상태를 확인하거나 제외한 뒤 질문을 보내도록 바꿨습니다.

   구현

   캡처 순간에는 오버레이를 잠시 숨긴 뒤 연결된 화면을 이미지로 만들고, 화면·이미지·문서를 reading·ready·error 상태로 정규화했습니다. ready 상태의 항목만 요청에 포함했습니다.

   확인된 영향

   공개본에서는 백그라운드 화면 기록을 제거하고, 질문에 포함될 항목과 처리 상태를 전송 전에 드러냈습니다.

3. 03

   서로 다른 AI 제공자를 하나의 대화 상태로 통합

   문제

   OpenAI·Anthropic·Gemini·OpenRouter는 요청 본문, 이미지 전달 방식, 스트리밍 이벤트와 종료 사유가 서로 달랐습니다.

   선택

   제공자별 요청과 응답 처리를 어댑터로 분리하고, 대화 UI에는 공통 상태만 전달했습니다.

   구현

   허용된 제공자 URL만 통과하는 네이티브 HTTP 경계를 두고, 제공자별 스트림을 응답 조각·완료·오류로 정규화해 공통 reducer에 연결했습니다.

   확인된 영향

   같은 인터페이스에서 제공자를 바꿀 수 있게 했고, 현재 통과하는 39개 단위 테스트 중 19개가 제공자 연동 경계를 확인합니다.

초기 Windows 설치본을 약 1주일간 직접 사용하며 핵심 흐름의 작동을 확인했습니다. 다만 최근 화면만으로는 세부적인 작업 맥락을 충분히 재구성하지 못했고, 현재 공개본은 필요한 순간의 화면만 직접 첨부하도록 단순화했습니다.

• 약 1주일간의 개인 사용

  다른 Windows 기기에 설치한 초기 로컬 버전에서 오버레이·캡처·첨부·질문·응답 흐름이 작동하는 것을 확인했습니다.

• 맥락 인식의 한계

  첨부 자체는 작동했지만 세부 텍스트와 작업 의도를 충분히 파악하지 못해, 상황을 직접 설명하는 편이 더 빨랐습니다.

• 현재 공개 코드의 자동화 테스트

  상태 전이, 첨부 파싱, 프로필, SSE와 네 제공자 요청·응답을 다루는 39개 단위 테스트가 통과합니다.

• 제품 흐름을 설명하는 가상 시나리오

  Excel에서 예상과 다른 계산 결과를 발견한 뒤 오버레이에서 현재 화면을 첨부하고 수식의 문제를 질문하는 흐름으로 검토했습니다. 실제 사용 성과를 뜻하지 않습니다.