Compression Engines (한국어)

압축 콤보

압축 콤보는 라우팅 콤보에 할당할 수 있는 이름 있는 압축 프로필입니다.

• compression_combos: 모드, 파이프라인, RTK 구성, 언어 구성 및 기본값 표시를 저장합니다
• compression_combo_assignments: 압축 콤보를 라우팅 콤보에 매핑합니다
• 런타임 통합은 일반 콤보 재정의보다 먼저 할당된 압축 콤보를 확인합니다
• 분석에는 compression_combo_id 및 engine이 포함됩니다

대시보드 위치: Dashboard -> Context & Cache -> Compression Combos.

API 인터페이스

경로	용도
/api/settings/compression	전역 압축 설정(mcpAccessibility 구성 포함)
/api/compression/preview	모든 압축 모드 미리 보기
/api/compression/language-packs	사용 가능한 Caveman 언어 팩 목록 조회
/api/context/caveman/config	Caveman 설정 별칭
/api/context/rtk/config	RTK 기본값 및 설정
/api/context/rtk/filters	RTK 필터 카탈로그
/api/context/rtk/test	RTK 미리 보기/테스트 엔드포인트
/api/context/rtk/raw-output/[id]	인증된 민감 정보 제거 원시 출력 복구
/api/context/combos	압축 콤보 CRUD
/api/context/combos/[id]/assignments	라우팅 콤보 할당 CRUD
/api/context/analytics	압축 분석 별칭

관리 경로에는 관리 인증 또는 API 키 정책 검사가 필요합니다.

MCP 도구

압축 기능은 5개의 MCP 도구를 제공합니다.

도구	범위	용도
omniroute_compression_status	read:compression	설정, 분석, 캐시 통계
omniroute_compression_configure	write:compression	전역 설정 업데이트
omniroute_set_compression_engine	write:compression	모드 및 선택적 파이프라인 설정
omniroute_list_compression_combos	read:compression	압축 콤보 목록 조회
omniroute_compression_combo_stats	read:compression	콤보/엔진 분석 조회

범위 및 제외 사항

임베딩은 절대 압축되지 않습니다. open-sse/handlers/embeddings.ts는 어떠한 압축 엔진도 호출하지 않으며, 요청/응답 본문은 변경 없이 실행기로 곧바로 전달됩니다. 현재 이는 런타임 검사가 아니라 구조적인 특성입니다(임베딩과 채팅 완성은 서로 분리된 핸들러임). 따라서 #8034의 벡터 왜곡 우려는 임베딩 경로에서 발생할 여지가 없습니다.

모델별/엔드포인트별 제외 필터(#8034). 채팅 완성의 경우 운영자는 절대 압축하면 안 되는 모델 ID / provider/model 대상을 지정할 수 있습니다. 이는 향후 압축 기능이 임베딩 인접 경로에 더 가깝게 연결될 경우 유용한 안전장치이며, 정확한 바이트 단위의 프롬프트가 중요한 모든 모델(결정론적 평가, 캐시에 민감한 접두사 등)에도 일반적으로 유용합니다.

• 설정 필드: 전역 압축 구성의 exclusions?: string[] (GET/PUT /api/settings/compression). 기존 key_value 압축 네임스페이스 (src/lib/db/compression.ts)를 통해 영속화되며 새 테이블은 필요하지 않습니다.
• 대시보드 탭: Dashboard → Compression → Exclusions (/dashboard/compression/exclusions).
• 패턴 구문: *가 유일한 와일드카드입니다. 패턴의 다른 모든 정규식 메타 문자는 매칭 전에 이스케이프되므로 gpt-5.6은 리터럴 문자열에만 일치하며 gpt-5x6에는 절대 일치하지 않습니다(ReDoS에 안전하고 범위가 제한되며 중첩 수량자가 없음). 패턴은 대소문자를 구분하지 않고 모델 ID 자체와 provider/model 조합 모두에 매칭됩니다. gpt-5-6, openai/gpt-5-6, openai/*가 모두 동작하며 *만 지정하면 모든 모델이 제외됩니다.
• 매칭: open-sse/services/compression/exclusions.ts의 isCompressionExcluded() / normalizeCompressionExclusions(). chatCore.ts는 압축 설정을 확인한 직후, 어떠한 엔진도 실행되기 전에 제외 대상을 검사하며, 일치 항목을 전역적으로 압축이 비활성화된 경우와 정확히 동일하게 처리합니다. 따라서 요청 본문은 바이트 단위로 동일함이 보장됩니다. 건너뛰기는 분석 가시성을 위해 writeCompressionSkip(..., "excluded")를 통해 기록됩니다.
• 기본값(목록이 비어 있거나 없음): #8034 이전 동작과 동일하게 아무것도 제외되지 않습니다.

알려진 제한 사항

• LLMLingua-2(SLM)에는 동일 위치에 배치된 선택적 종속성이 필요합니다. 워커는 @atjsh/llmlingua-2와 피어 종속성이 dist/node_modules에 함께 배치된 경우에만 프로덕션 빌드에서 실행됩니다(scripts/build/colocateOptionals.mjs, #4286 참조). 이러한 종속성이 없으면 엔진은 장애 허용 방식으로 동작하여 원본 텍스트를 반환합니다. 워커 확인은 더 이상 import.meta.url에 의존하지 않습니다(독립 실행형 번들에서는 작동하지 않음). 대신 런타임 cwd / argv[1]을 기준으로 삼습니다.
• Caveman 언어 팩 de / fr / ja는 일부만 제공됩니다. 이러한 팩에는 context + filler + structural 규칙이 포함되어 있지만 dedup / ultra 팩은 없으므로, 해당 언어에서 ultra 강도는 full보다 강하지 않습니다(자체 규칙만 사용하며, 외국어 텍스트를 훼손할 수 있는 영어 dedup/ultra 규칙으로 암묵적으로 폴백하지 않음). en / es / id / pt-BR은 완전하게 제공됩니다. 일부만 제공되는 팩에 대한 dedup.json + ultra.json 기여를 환영합니다.
• 스택형 원격 분석에는 압축을 수행한 엔진만 나열됩니다. 엔진이 실행되었지만 절감률이 0%인 스택형 파이프라인 단계는 stats:null을 반환하므로 engineBreakdown에 나타나지 않습니다. 따라서 건너뛴 단계와 구분할 수 없습니다. “실행됨, 0%“과 “건너뜀”을 구분하려면 분석 모델을 변경해야 하므로 추후로 연기되었습니다.

유효성 검사

이 영역에 대한 집중 게이트는 다음과 같습니다:

node --import tsx/esm --test tests/unit/compression/rtk-*.test.ts tests/unit/compression/pipeline-integration.test.ts tests/unit/compression/context-compression-api.test.ts
node --import tsx/esm --test tests/unit/compression/*.test.ts tests/golden-set/*.test.ts tests/integration/compression-pipeline.test.ts tests/unit/api/compression/compression-api.test.ts
node --import tsx/esm --test tests/unit/compression/mcpAccessibility*.test.ts
npm run typecheck:core

---

OmniRoute 소스 코드 (a58000c7685f)