내부 구현

Cue가 내부적으로 어떻게 연결되어 있는지 — 동작을 변경해야 하는 컨트리뷰터를 위한 페이지들. 대부분 CLAUDE.md의 해당 섹션을 미러하므로, 서브시스템 변경 시 양쪽 다 업데이트하세요.

서브시스템 맵

mindmap
  root((Cue))
    메뉴바 / 팝업
      핫키 경로
      선택 텍스트 캡처
      제안 팝업 (Opus)
    스트리밍 레코더
      ocap 서브프로세스
      Pruner (키프레임)
      Evictor (보존)
    디지스트 파이프라인
      Frame selector
      Image preprocess
      Cloud / local backend
      PII 출력 scrub
    Memory
      Opus 재작성
      memory.md
      핫키 시 RAG 주입
    프라이버시 일시정지
      5가지 사유
      수동 핫키
      Purge cascade
      빨간 테두리 오버레이
    온디바이스 비전
      llama-server 서브프로세스
      Gemma 4 GGUF + mmproj
      Fail-closed 정책
    플랫폼 추상화
      cue.platform
      CGEventTap / pynput
      AX / UIA
    설정
      서브프로세스 + IPC-via-disk
      Apply / Revert
      파일락 단일 인스턴스

페이지

아키텍처 개요 →   프로젝트 레이아웃, 공유 모듈, 메뉴바 프로세스와 그 서브프로세스의 top-down 맵.

스트리밍 레코더 →   ocap 서브프로세스, rotator, pruner, evictor, digest 스레드.

디지스트 파이프라인 →   프레임 선택, 이미지 전처리, cloud vs local 백엔드 결정, fail-closed 정책 게이트, PII 출력 scrub.

온디바이스 비전 →   번들된 llama-server, Gemma 4 매니페스트, lockdown 규칙, Apple Silicon Metal bf16 caveat.

Memory →   Opus가 memory.md를 어떻게 유지하는지, 핫키 경로의 RAG 주입 지점.

프롬프트 →   앱의 모든 Claude 프롬프트, src/cue/prompts.py에서 가져옴.

프라이버시 일시정지 →   사유 집합, 모니터/컨트롤러 분리, 일시정지 진입 시퀀스, 스레드 모델 + 락 순서.

플랫폼 추상화 →   cue.platform.{macos,windows}에 무엇이 있고 주요 동작 차이.

설정 서브프로세스 →   설정 창 IPC 모델, Apply/Revert 흐름, 파일락 단일 인스턴스.