컨텍스트 압축
압축은 긴 대화를 모델 컨텍스트 창 안에서 계속하게 합니다. 이전 컨텍스트를 요약하고 선택 분기의 최근 부분을 유지합니다. 원본 대화 항목은 저장되어 남습니다. 요약은 기록을 지우지 않고 후속 요청에 쓸 컨텍스트를 바꿉니다.
압축은 대화 컨텍스트 관리입니다. USER.md나 MEMORY.md에 사실을 쓰거나 작업을 완료하거나 모든 세부 보존을 보장하지 않습니다. 중요한 소스는 파일에 두고 정확한 텍스트가 필요하면 컨텍스트 참조를 쓰세요.
자동 압축
자동 압축은 기본 활성화입니다. 선택 모델의 컨텍스트 창과 사용량을 비교하고 다음 응답 공간을 남깁니다. 기본 16,384토큰을 예약하고 최근 약 20,000토큰을 유지합니다. 모델 세션 구성으로 예약·유지량을 재정의할 수 있습니다.
컨텍스트 초과 오류나 복구 가능한 응답 길이 한도 후에도 압축할 수 있습니다. 복구 가능하면 같은 실행에서 압축 후 재시도를 한 번 수행합니다. 다음에도 초과·잘림이 발생하면 컨텍스트를 줄이거나 더 큰 창의 모델을 고르세요. 자동 압축은 무제한 재시도 루프가 아닙니다.
요약 생성은 현재 모델 경로를 사용하고 공급자 사용량을 발생시킬 수 있습니다. 생성 동안 대화가 멈출 수 있습니다. 실패하면 불완전 요약을 적용하지 않고 보고합니다. 일부 보조 가상 모델 요약 실패는 기존 이력으로 원래 응답 준비를 계속할 수 있게 합니다.
수동 압축 API
연결 RPC 클라이언트는 다음을 요청할 수 있습니다.
{"method":"session.compress","params":{"session_id":"SESSION_ID","focus":"Preserve decisions and unresolved constraints"}}
focus는 선택 사항입니다. 메서드는 캡처한 활성 작업을 중지하고 안정될 때까지 기다려 요약 하나를 만듭니다. 중단 턴을 자동 재개하지 않습니다. 세션이 너무 작거나 이미 압축되었으면 압축할 내용 없음을 보고할 수 있습니다.
셸 CLI에 anyy compact 하위 명령은 없습니다. Dashboard 채팅과 TUI에 수동 압축 버튼이나 /compact·/compress 명령은 없습니다. 일반 대화의 자동 압축은 계속 적용됩니다.
분기 탐색과 변경
세션 유휴 상태에서 TUI /tree를 사용하세요.
- Up/Down으로 기존 항목을 선택합니다.
- 떠나는 분기의 요약이 필요하면 s를 누릅니다. 선택기에 요약 켜짐/꺼짐이 표시됩니다.
- Enter로 이동하거나 Esc로 선택기를 취소합니다.
사용자 메시지를 고르면 활성 컨텍스트가 그 메시지 직전으로 이동합니다. 입력창이 비어 있을 때만 텍스트가 돌아옵니다. 이전·형제 분기는 계속 사용할 수 있습니다. 다음 제출 메시지는 새 선택 지점부터 이어지며 탐색 자체는 응답을 시작하지 않습니다.
선택적 분기 요약은 떠나는 분기의 유용한 컨텍스트를 전달합니다. 별도 요약 항목이며 새 대화나 메모리 업데이트가 아닙니다. 모델·도구 복원은 선택 분기를 따릅니다. 연결 클라이언트는 session.tree, session.tree.navigate를 사용할 수 있습니다. 별도 대화 생성은 구별되는 session.fork API입니다.
재시도와 취소
압축과 분기 요약은 공급자 전송 재시도와 별개인 프로필 세션 재시도 정책을 공유합니다. 작업은 재시도 예산을 유지합니다. 요약 취소는 모델 호출 안정화를 기다리고 기존 이력을 유지하며 불완전·잘린 요약을 적용하지 않습니다.
에이전트 재시도 대기 중 TUI Esc는 해당 대기만 취소합니다. 요약 취소 단축키가 아닙니다. 중지·편집기 복귀 제어는 세션과 TUI를 참조하세요.
문제 해결
| 증상 | 조치 |
|---|---|
| 복구 후에도 컨텍스트 초과 | 참조 자료 축소, 더 큰 모델 선택, 새 세션 시작 |
| 요약 생성 실패 | 선택 모델·자격 증명 확인 후 필요하면 지원 API로 재시도 |
| 압축 후 정확한 정보 누락 | 원본 파일이나 제한 참조 재첨부 |
작업 중 /tree 사용 불가 | 응답을 완료하거나 중지한 뒤 탐색 |
| 분기의 사용자 텍스트 미복귀 | 입력창에 초안이 있었음. 탐색 전 보존 |
데이터베이스 압축은 모델 컨텍스트가 아닌 데이터베이스 저장량을 줄이는 다른 작업입니다.