세션과 메모리

q가 워크스페이스 실행 사이에 무엇을 저장하고 압축하고 학습하고 복원하는지 이해합니다.

Markdown 보기

영구 세션

각 워크스페이스는 .q/sessions/ 아래에 여러 UUID 기반 세션을 가질 수 있습니다. 시작 화면은 제목과 최근 활동을 보여줍니다.

프로세스 하나가 선택된 세션을 소유합니다. 다른 q 프로세스는 같은 워크스페이스의 다른 세션을 열 수 있지만 세션 잠금은 저장소 파일 편집을 직렬화하지 않습니다.

q는 보이는 전체 대화와 모델에 보내는 압축된 요청 컨텍스트를 따로 저장합니다. 컨텍스트 메타데이터가 있으면 모델 입력을 줄이면서 사용자에게 보이는 기록은 그대로 유지합니다.

기본 세션 레코드는 다음 위치에 있습니다.

text

.q/sessions/<uuid>/session.json

승인된 계획 실행은 같은 위치에 재개 가능한 plan-execution.json을 추가합니다.

Workspace Memory는 영구 메시지, 도구 활동, 실패, 생명주기 이벤트, 검색 인덱스를 저장합니다. 하나의 채팅 컨텍스트에 모든 과거 이벤트를 넣지 않고도 검색할 수 있습니다.

큰 도구 결과는 불변 Loom 아티팩트로 저장됩니다. 프롬프트에는 제한된 영수증이 전달되고 모델은 나중에 필요한 범위만 읽을 수 있습니다.

성공한 턴 이후 Thinker는 확립된 워크플로, 영구 프로젝트 사실, 재사용 가능한 해결책, 향후 작업에 영향을 줄 증거 기반 발견을 proposition으로 추출할 수 있습니다.

Librarian은 각 proposition을 생성, 병합, 폐기할지 결정합니다. /learn off는 수집과 큐 처리를 중지하지만 이미 큐에 들어간 데이터는 삭제하지 않습니다.

빌드, 테스트, 포맷, 감사 같은 실행별 스냅샷은 영구 프로젝트 사실이 아니라 작업 기록에 남습니다.