OmniRoute/docs/i18n/hu/docs/compression/COMPRESSION_GUIDE.md

🗜️ Prompt Compression Guide — OmniRoute (Magyar)

🌐 Languages: 🇺🇸 English · 🇪🇹 am · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇨🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇸 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇦🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇾 ms · 🇲🇹 mt · 🇲🇲 my · 🇳🇵 ne · 🇳🇱 nl · 🇳🇴 no · 🇮🇳 or · 🇮🇳 pa · 🇵🇭 phi · 🇵🇱 pl · 🇵🇹 pt · 🇧🇷 pt-BR · 🇷🇴 ro · 🇷🇺 ru · 🇱🇰 si · 🇸🇰 sk · 🇸🇮 sl · 🇷🇸 sr · 🇸🇪 sv · 🇰🇪 sw · 🇮🇳 ta · 🇮🇳 te · 🇹🇭 th · 🇹🇷 tr · 🇺🇦 uk-UA · 🇵🇰 ur · 🇺🇿 uz · 🇻🇳 vi · 🇳🇬 yo · 🇨🇳 zh-CN · 🇹🇼 zh-TW

---

Automatikusan 15–95%-ot takaríthat meg a tömöríthető kontextuson. Gyors áttekintésért tekintse meg a README tömörítésről szóló szakaszát.

Áttekintés

Az OmniRoute moduláris prompttömörítési folyamatot valósít meg, amely proaktívan, még azelőtt fut le, hogy a kérések elérnék a felsőbb szintű szolgáltatókat. Ez azt jelenti, hogy a tokenmegtakarítás átlátható módon történik — nincs szükség a munkafolyamat módosítására.

Ügyfélkérés
  → Tömörítési stratégia kiválasztója
    → Van kombinációs felülbírálás? → A kombináció beállításának használata
    → Elérte az automatikus aktiválási küszöböt? → Automatikus mód használata
    → Van alapértelmezett mód? → Globális beállítás használata
    → Ki van kapcsolva? → Tömörítés kihagyása
  → Kiválasztott tömörítési mód
    → Kikapcsolva: Nincs tömörítés
    → Lite: Biztonságos térköz- és formázástisztítás (~15%)
    → Standard: Töltelékszavak eltávolítása tőmondatos stílusban (~30%)
    → Aggressive: Előzmények öregítése + összegzés (~50%)
    → Ultra: Heurisztikus ritkítás + kódblokkok csökkentése (~75%)
    → RTK: Parancstudatos terminál-/eszközkimenet-szűrés (60–90%-os felsőbb szintű tartomány)
    → Stacked: Rendezett, többmotoros folyamat, általában RTK, majd Caveman (78–95%-os tömöríthető tartomány)
  → Tömörített kérés → Szolgáltató

---

Tömörítési módok

Kikapcsolva

Nincs alkalmazva tömörítés. Minden üzenet változatlanul halad tovább.

Lite mód (~15%-os megtakarítás, <1 ms késleltetés)

A legbiztonságosabb mód — nincs szemantikai változás, csak formázástisztítás:

Technika	Leírás
collapseWhitespace	Az egymást követő üres sorok és a sorvégi szóközök összevonása
dedupSystemPrompt	Az ismétlődő rendszerüzenetek eltávolítása
compressToolResults	A terjengős eszköz-/függvénykimenetek tömörítése
removeRedundantContent	Az ismétlődő utasítások eltávolítása
replaceImageUrls	A base64-kódolású képadat-URI-k rövidítése

Ideális: Folyamatos használathoz és biztonságkritikus munkafolyamatokhoz.

Standard mód (~30%-os megtakarítás)

A Caveman ihlette — eltávolítja a töltelékszavakat és a terjengős megfogalmazást, miközben megőrzi a jelentést:

• Eltávolítja a töltelékszavakat („please”, „I think”, „basically”, „actually”)
• Tömöríti a terjengős kifejezéseket („in order to” → „to”, „as a result of” → „because”)
• Eltávolítja az udvarias bizonytalankodást („Would you mind...”, „If you could possibly...”)
• Több mint 30, kódolási promptokhoz hangolt reguláris kifejezési szabály

Ideális: Mindennapi kódolási munkafolyamatokhoz és költségtudatos csapatok számára.

Aggressive mód (~50%-os megtakarítás)

Intelligens előzménykezelés hosszú munkamenetekhez:

• Üzenetek öregítése — a régebbi üzenetek fokozatosan egyre tömörebbé válnak
• Eszközeredmények összegzése — a hosszú eszközkimeneteket összefoglalók váltják fel
• Strukturális integritási védelmek — biztosítják, hogy a tool_use + tool_result párok konzisztensek maradjanak
• Kontextusablak figyelembevétele — betartja az egyes modellek tokenkorlátait

Ideális: Hosszabb hibakeresési munkamenetekhez és nagy kódbázisokhoz.

Ultra mód (~75%-os megtakarítás)

Maximális tömörítés olyan helyzetekhez, ahol kritikus fontosságú a tokenek mennyisége:

• Heurisztikus ritkítás — eltávolítja a relevanciaküszöb alatti üzeneteket
• Kódblokkok csökkentése — tömöríti az ismétlődő kódpéldákat
• Bináris kereséses csonkolás — megtalálja a kontextusablak optimális vágási pontját
• Tartalmazza az Aggressive mód összes funkcióját

Ideális: Ha ismételten eléri a kontextuskorlátokat.

RTK mód (60–90%-os felsőbb szintű tartomány)

Az RTK mód a kódolási ügynökök munkameneteiben megjelenő terjengős eszközkimenetekre van optimalizálva:

• Felismeri többek között az olyan parancs-/kimenetosztályokat, mint a git status, git diff, git log, a tesztfuttatók, a TypeScript/Vite/Webpack buildek, az ESLint/Biome/Prettier, az npm audit/telepítések, a Docker-naplók, az infrastruktúra- kimenetek és az általános shellkimenetek
• Alkalmazza az open-sse/services/compression/engines/rtk/filters/ könyvtárban található JSON-szűrőcsomagokat
• RTK TOML schema v1 szűrőket importál projekt- vagy globális filters.toml fájlokból, beágyazott tesztekkel végzett ellenőrzéssel és a projektfájlokra vonatkozó bizalmi korlátozással
• 49 beépített szűrőt tartalmaz beágyazott ellenőrzési mintákkal
• Eltávolítja az ANSI vezérlőszekvenciákat, a folyamatjelző sávokat, az ismétlődő sorokat és a műveletet nem igénylő zajt
• Megőrzi a hibákat, figyelmeztetéseket, módosított fájlokat, összegzéseket és a hosszú kimenetek végét
• Támogatja a bizalmi korlátozású projektszűrőket, a globális szűrőket és a kitakart nyers kimenet opcionális visszaállítását

Ideális: Shell-, build-, teszt-, git-, grep- és fájlkimeneti átiratokat tartalmazó ügynökmunkamenetekhez.

Stacked mód (78–95%-os tömöríthető tartomány)

A Stacked mód több tömörítési motort futtat determinisztikus sorrendben. Az alapértelmezett folyamat:

RTK -> Caveman

Ebben a sorrendben először a terminál-/eszközkimenet válik tömörré, majd a Caveman szemantikai tömörítést alkalmaz a fennmaradó természetes nyelvű promptra. A Stacked folyamatok globálisan vagy az útválasztási kombinációkhoz rendelt tömörítési kombinációkon keresztül konfigurálhatók.

Ideális: Nagy eszköznaplókat, valamint emberi utasításokat vagy asszisztensi összefoglalókat tartalmazó vegyes kontextushoz.

---

Az upstream megtakarítások számítása

Az OmniRoute két forrás alapján dokumentálja a tömörítési megtakarításokat: az upstream projektek teljesítménytesztjei és az OmniRoute saját motor-összeállítása alapján.

Forrás	Az itt használt szám az upstream README-ből
Caveman	~75%-kal kevesebb kimeneti token, 65% átlagos kimeneti megtakarítás a teljesítménytesztekben, 22-87%-os tartomány és ~46%-os bemenettömörítő eszköz
RTK	60-90% megtakarítás a parancskimeneteken; mintamenet: ~118,000 -> ~23,900 token, azaz 79.7% megtakarítás (~80%)

Az egymást átfedő eszköz-/kontextustartalmaknál az alapértelmezett OmniRoute-kombináció egymás után alkalmazza a motorokat:

RTK -> Caveman

Az összesített megtakarítás multiplikatív, nem additív:

combined = 1 - (1 - RTK savings) * (1 - Caveman input savings)
average  = 1 - (1 - 0.80) * (1 - 0.46) = 89.2%
range    = 1 - (1 - 0.60..0.90) * (1 - 0.46) = 78.4-94.6%

Ez a 78-95%-os érték akkor érvényes, amikor az RTK és a Caveman is képes csökkenteni ugyanazt a bemeneti-/kontextustartalmat. A Caveman válaszkimeneti módja ettől különálló: ha engedélyezve van, a Caveman saját kimeneti megtakarításait kell figyelembe venni (65% átlagosan, ~75% kiemelt érték, 22-87%-os tartomány). A teljes számlázási megtakarítás a promptok és kimenetek arányától függ.

Mit jelent valójában a „jogosult”

A kiemelt 15-95%-os tartomány valós, de csak a redundáns vagy terjengős tartalmakra vonatkozik — ismétlődő hibasorokra, ugyanazt a figyelmeztetést ontó buildnaplóra, túlméretezett grep-/fájlolvasási kimenetre. Ez nem jelenti azt, hogy minden kérésnél ekkora megtakarítás érhető el.

Empirikusan ellenőrizve (tests/unit/compression/stacked-compression-tool-result-savings.test.ts): egy stacked (RTK + Caveman) futtatás egy 300 azonos hibasort tartalmazó, Anthropic-formátumú tool_result blokkon 95.93%-os tokenmegtakarítást / 96.26%-os karaktermegtakarítást eredményezett — egyértelműen a meghirdetett tartományon belül. Ugyanez a folyamat normál, nem redundáns eszközkimeneten futtatva (egy tiszta grep-találati listán, egy rövid fájlolvasáson vagy hétköznapi társalgási szövegen) helyesen közel nulla megtakarítást eredményez, mert nincs eltávolítható ismétlődés, és a validateCompression() (validation.ts) nem enged tovább olyan átírást, amely elhagyná vagy módosítaná a kódblokkokat, URL-eket, címsorokat, verziókat vagy CSUPA NAGYBETŰS konstansazonosítókat.

Ez elvárt és biztonságos működés, nem hiba: egy olyan programozási munkamenet, amely többnyire tiszta fájlokat olvas vagy keres bennük, teljesen engedélyezett tömörítés mellett is csak mérsékelt összesített megtakarítást ér el, míg egy hibás ciklusba kerülő vagy bőbeszédű linterrel találkozó munkamenet az érintett forgalmon a teljes 78-95%-os tartományt kihasználhatja. Ne tekintse egyetlen munkamenet alacsony összesített megtakarítási százalékát annak bizonyítékaként, hogy a tömörítés hibásan van konfigurálva — először ellenőrizze, hogy az alapul szolgáló eszközkimenet valóban redundáns volt-e.

---

A tokenmegtakarítás szemléltetése

Tömörítés nélkül: 47K token elküldve az LLM-nek
Lite móddal:      40K token elküldve          (15% megtakarítás — biztonságos, mindig aktív)
Standard móddal:  33K token elküldve          (30% megtakarítás — caveman-speak szabályok)
Aggressive móddal: 24K token elküldve         (50% megtakarítás — öregítés + összegzés)
Ultra móddal:     12K token elküldve          (75% megtakarítás — heurisztikus ritkítás)
RTK-val:          19K-5K token elküldve       (60-90% megtakarítás a parancs-/eszközkimeneten)
Stacked móddal:   10K-2.5K token elküldve     (78-95%-os tartomány a jogosult RTK+Caveman-tartalmaknál)

---

Konfiguráció

Vezérlőpult

Lépjen a Dashboard → Context & Cache oldalra:

• Caveman — módválasztás, nyelvi csomagok, előnézet és globális alapértelmezések
• RTK — parancsszűrési előnézet, RTK biztonsági beállítások és szűrőkatalógus
• Compression Combos — útválasztási kombinációkhoz rendelt, elnevezett motorfolyamatok
• Auto-Trigger Threshold — a tömörítés automatikus aktiválása, amikor a tokenszám meghaladja a küszöbértéket

Kombinációnkénti felülbírálás

A Dashboard → Context & Cache → Compression Combos oldalon rendeljen hozzá egy tömörítési kombinációt egy útválasztási kombinációhoz:

Kombináció: "free-tier-fallback"
  Tömörítési kombináció: "coding-agent-stack"
  Folyamat: RTK -> Caveman
  Célok:
    1. if/kimi-k2.7-code
    2. if/qwen3.8-max-preview

Ez lehetővé teszi a halmozott tömörítés használatát az ingyenes/kódolási szolgáltatóknál, miközben a fizetős előfizetéseknél megtartja az egyszerűsített módot.

Ez a „kombinációnkénti felülbírálási” hozzárendelés eltér az útválasztási kombináció tömörítési módjának felülbírálásától (Default/Off/Lite/Standard/Aggressive/Ultra) — ez a felülbírálás nem választ ki elnevezett tömörítésikombináció-folyamatot; csupán beállítja a resolveCompressionPlan által figyelembe vett compressionMode mezőt. Ez beállítható a kombináció kártyáján (Dashboard → Combos), illetve a #6760 óta útválasztási kombinációnként az „Assign to routing” listában is, a Dashboard → Context & Cache → Compression Combos oldalon, közvetlenül a fent dokumentált folyamathozzárendelési jelölőnégyzet mellett. Mindkét felületen végzett módosítás ugyanazon PUT /api/combos/{id} végponton keresztül marad meg.

Kérésenkénti felülbírálás

Küldje el az x-omniroute-compression kérésfejlécet egyetlen kérés tömörítési tervének felülbírálásához. Ennek van a legmagasabb prioritása — felülírja az útválasztási kombináció felülbírálását, az aktív profilt, az automatikus aktiválást és a panel alapértelmezését. Az ismeretlen értékeket a rendszer figyelmen kívül hagyja (a kérést soha nem utasítja el), és továbbra is a globális főkapcsoló szabályoz mindent: ha a tömörítés globálisan ki van kapcsolva, a fejléc nem kapcsolhatja be. Értékek:

Érték	Hatás
off	Nincs tömörítés ennél a kérésnél.
default	A panelből származtatott alapértelmezett profil (figyelmen kívül hagyja az aktív profilt).
engine:<id>	Egyetlen motor, ha engedélyezve van, például engine:rtk.
<combo>	Elnevezett kombináció; először név alapján (kis- és nagybetűktől függetlenül), majd azonosító alapján egyeztetve.

Az alkalmazott tervet a rendszer visszaküldi az X-OmniRoute-Compression: <mode>; source=<source> válaszfejlécben, ahol a <source> a következők egyike: request-header, routing-override, active-profile, auto-trigger, default vagy off.

API

# Tömörítési beállítások lekérése
curl http://localhost:20128/api/settings/compression

# Tömörítési beállítások frissítése
curl -X PUT http://localhost:20128/api/settings/compression \
  -H "Content-Type: application/json" \
  -d '{"defaultMode":"stacked","autoTriggerMode":"stacked","autoTriggerTokens":32000}'

# Egy adott RTK/halmozott adathasznos teher előnézete
curl -X POST http://localhost:20128/api/compression/preview \
  -H "Content-Type: application/json" \
  -d '{"mode":"rtk","messages":[{"role":"tool","content":"npm test output here"}]}'

# RTK-szűrőcsomagok listázása
curl http://localhost:20128/api/context/rtk/filters

# Az RTK közvetlen tesztelése opcionális parancsmetaadatokkal
curl -X POST http://localhost:20128/api/context/rtk/test \
  -H "Content-Type: application/json" \
  -d '{"command":"npm test","text":"FAIL tests/example.test.ts\nError: boom"}'

---

Mi kap védelmet

A tömörítőmotor mindig megőrzi:

• ✅ Kódblokkokat (körülhatárolt és soron belüli)
• ✅ URL-eket és fájlútvonalakat
• ✅ JSON-struktúrákat és strukturált adatokat
• ✅ Azonosítókat és védett technikai tokeneket
• ✅ Matematikai kifejezéseket
• ✅ Eszköz-/függvényhívások definícióit
• ✅ Rendszerpromptokat (lite módban)

Az RTK nyers kimenetének helyreállítása kitakarja a gyakori API-kulcsokat, bearer tokeneket, Slack-tokeneket, AWS-hozzáférési kulcsokat, jelszavakat, tokeneket és titkos adatokat, mielőtt bármi tárolásra kerülne.

---

Tömörítési statisztikák

Minden tömörített kéréshez statisztikák tartoznak a szervernaplókban:

{
  "originalTokens": 47200,
  "compressedTokens": 40120,
  "savingsPercent": 15.0,
  "techniquesUsed": ["collapseWhitespace", "dedupSystemPrompt"],
  "mode": "lite",
  "engine": "caveman",
  "compressionComboId": "coding-agent-stack",
  "durationMs": 0.8,
  "rtkRawOutputPointers": []
}

---

Fázisütemterv

Fázis	Módok	Állapot
1. fázis	Off, Lite	✅ Kiadva
2. fázis	Standard, Aggressive, Ultra	✅ Kiadva
3. fázis	RTK, Stacked, tömörítési kombinációk	✅ Kiadva
4. fázis	Kimeneti stílusok, SLM-szintű Ultra, kiértékelési keretrendszer	✅ Kiadva
4C fázis	Adaptív kontextuskeret („tárcsa”) — számítási motor + API (contextBudget a PUT /api/settings/compression végponton) + irányítópult mód-/házirend-vezérlői	✅ Kiadva

---

Köszönetnyilvánítás

A Standard mód tömörítési szabályait JuliusBrussee Caveman projektje (⭐ 51K+) ihlette — a virálissá vált „miért használni sok token, amikor kevés token is megteszi” projekt. A Caveman jelentése szerint ~75%-kal kevesebb kimeneti tokent használ, a benchmarkokon átlagosan 65%-os kimeneti megtakarítást ér el, kimeneti megtakarítási tartománya 22-87%, bemenettömörítő eszköze pedig ~46%-os megtakarítást biztosít.

Az RTK módot az RTK AI RTK - Rust Token Killer projektje ihlette — ez egy nagy teljesítményű parancskimenet-tömörítési projekt terminál-, build-, teszt-, git- és eszközkimenetek szűrésére. Az RTK jelentése szerint 60-90%-os megtakarítást ér el, a README-ben szereplő mintamenet pedig ~80%-os megtakarítást mutat.

---

Fejlett tömörítési rendszerek

A 7 szabványos módon túl az OmniRoute több fejlett tömörítési rendszert is tartalmaz, amelyek a kontextus alapján automatikusan működnek.

Gyorsítótár-tudatos tömörítés

Egyes szolgáltatók (például az Anthropic prompt-gyorsítótárazással) támogatják a promptok gyorsítótárazását, amely lehetővé teszi számukra a prompt egyes részeinek gyorsítótárazását a költségek és a késleltetés csökkentése érdekében. Ha a gyorsítótárazás engedélyezve van, az agresszív tömörítés valójában ronthatja a teljesítményt, mert megváltoztatja a gyorsítótárazott tokeneket, érvénytelenítve ezzel a gyorsítótárat.

A cachingAware.ts modul ezt a gyorsítótárazási kontextus észlelésével és a tömörítési stratégia ennek megfelelő módosításával oldja meg.

Működése

1. A gyorsítótárazási kontextus észlelése — Átvizsgálja a kérés törzsét cache_control jelölők után
2. A gyorsítótárazást támogató szolgáltatók azonosítása — Ellenőrzi, hogy a célszolgáltató támogatja-e a gyorsítótárazást
3. A stratégia módosítása — Az aggressive/ultra módot standard módra állítja vissza a gyorsítótárazást támogató szolgáltatóknál
4. A rendszerprompt kihagyása — A rendszerpromptokat általában gyorsítótárazzák, ezért ne tömörítse őket
5. Determinisztikus átalakítások használata — Csak konzisztens kimenetet eredményező átalakításokat használ

Kódpélda

import {
  detectCachingContext,
  getCacheAwareStrategy,
} from "@omniroute/open-sse/services/compression/cachingAware";

const body = {
  model: "anthropic/claude-sonnet-4.5",
  messages: [{ role: "user", content: "Hello" }],
  cache_control: { type: "ephemeral" }, // ← Gyorsítótár-jelölő
};

const ctx = detectCachingContext(body, { provider: "anthropic" });
// → { hasCacheControl: true, provider: "anthropic", isCachingProvider: true }

const strategy = getCacheAwareStrategy("aggressive", ctx);
// → { strategy: "standard", skipSystemPrompt: true, deterministicOnly: true }

Mikor használandó

A gyorsítótár-tudatos tömörítés mindig be van kapcsolva — nincs szükség konfigurációra. Csak akkor lép működésbe, ha:

• A kérés cache_control jelölőket tartalmaz
• A célszolgáltató támogatja a promptok gyorsítótárazását (Anthropic, OpenAI stb.)

Progresszív öregítés

A hosszú beszélgetésekben sok üzenetváltás halmozódik fel, de a régebbi váltások egyre kevésbé relevánsak. A progressiveAging.ts modul a fordulók távolsága alapján fokozatosan csökkenti az üzenetek részletességét:

• Legutóbbi fordulók (0-3): Változtatás nélkül megmaradnak (teljes részletesség)
• Középtávoli fordulók (4-8): Lite tömörítés (szóközök és formázás rendezése)
• Régi fordulók (9+): Caveman tömörítés (töltelékszöveg eltávolítása, összegzés)
• Nagyon régi fordulók (20+): Erőteljesen összegzi vagy elhagyja őket

Kódpélda

import { applyAging } from "@omniroute/open-sse/services/compression/progressiveAging";

const messages = [
  { role: "system", content: "You are a helpful assistant" },
  { role: "user", content: "What is 2+2?" },
  { role: "assistant", content: "4" },
  // ... további 50 forduló ...
];

const { messages: aged, saved } = applyAging(messages, {
  verbatim: 3, // Az első 3 forduló: változtatás nélkül
  light: 8, // 4–8. forduló: lite tömörítés
  moderate: 20, // 9–20. forduló: caveman tömörítés
  // 21. fordulótól: erőteljes összegzés
});

// saved = a megtakarított tokenek száma

Mikor használandó

A progresszív öregítés mindig be van kapcsolva az aggressive és ultra módokban. Különösen hatékony a következő esetekben:

• Hosszú ideig tartó kódolási munkamenetek
• Többnapos beszélgetések
• Sok eszközhívást tartalmazó ágensalapú munkafolyamatok

Barlanglakó kimeneti mód

Az outputMode.ts modul rendszerprompt-utasításokat szúr be, hogy maga a modell tömör, szűkszavú kimenetet hozzon létre („barlanglakó” stílusban).

Működése

A bemenet tömörítése helyett ez a mód egy ehhez hasonló rendszerpromptot ad hozzá:

„Válaszolj a lehető legkevesebb szóval. Hagyd ki az udvariassági formulákat. Használj rövid mondatokat.”

Ez különösen jól működik a következő esetekben:

• Kódgenerálás (tömörebb kimenet = kevesebb token)
• Gyors kérdések és válaszok (nincs szükség részletes magyarázatokra)
• Kötegelt feldolgozás (az áteresztőképesség maximalizálása)

Mikor érdemes használni

A barlanglakó kimeneti mód használata külön bekapcsolandó — állítsa be a kombinált konfiguráción keresztül:

{
  "strategy": "auto",
  "config": {
    "auto": {
      "outputMode": "caveman"
    }
  }
}

Kimeneti stílusok (katalógus)

A fenti barlanglakó kimeneti mód az örökölt, egyetlen stílust használó megoldás. A 4. fázis ezt összeállítható kimeneti stílusok katalógusává általánosította: ez az OUTPUT_STYLE_CATALOG az open-sse/services/compression/outputStyles/catalog.ts fájlban. Minden stílus egy rendszerprompt-utasítás, amely arra készteti magát a modellt, hogy olcsóbb kimenetet állítson elő; a stílusok együtt is engedélyezhetők, és a katalógus sorrendjében kerülnek beszúrásra.

Stílus	id	Mit csinál	Az utasítás nyelvei
Tömör próza	terse-prose	Elhagyja a töltelékszavakat, névelőket és bizonytalankodást; a műszaki tartalmat pontosan megőrzi. Ugyanaz a szöveg, mint az örökölt barlanglakó kimeneti módban (hivatkozva, nem újra beírva).	en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
Kevesebb kód	less-code	YAGNI-létra: a legkisebb működő módosítás, nem kért absztrakciók nélkül.	en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
Lófarok (lusta vezető fejlesztő)	ponytail	„A legjobb kód az, amelyet soha nem írtak meg”: újrafelhasználás > újraírás, kiváltó ok > tünet, a legrövidebb működő diff.	en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
ADHD-m van (cselekvésközpontú)	i-have-adhd	Először a művelet (parancs/útvonal/kódrészlet a próza előtt), számozott és korlátozott számú lépések, EGY konkrét következő lépés, bevezető/összefoglalás/záróformula nélkül. Az ayghri/i-have-adhd alapján adaptálva (MIT).	en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
Tömör CJK (文言)	terse-cjk	Klasszikus kínai, rendkívül tömör stílus.	zh (területi beállításhoz kötött: csak akkor érhető el, ha a feloldott nyelv zh)

Minden stílus három intenzitási szintet kínál — lite, full, ultra —, és minden szint a közös korlátozási záradékkal végződik, amely változatlanul megőrzi a kódblokkokat, fájlútvonalakat, parancsokat, hibaüzeneteket, URL-eket és azonosítókat.

A beszúrás működése

Az applyOutputStyles() (open-sse/services/compression/outputStyles/apply.ts) feloldja a kiválasztást a katalógus alapján (az ismeretlen id-k és a területi beállítással nem egyező stílusok elvetésre kerülnek, de soha nem okoznak hibát), a kiválasztott utasításokat a katalógus sorrendjében összefűzi, egyszer hozzáfűzi a korlátozási záradékot, majd az eredményt egyetlen idempotenciajelölő ([OmniRoute Output Styles]) mögé, a rendszerprompt elejére helyezi — az ismételt alkalmazás nem végez műveletet. Ha az észlelt kérési nyelvhez elérhető fordítás, az angol helyett a lokalizált utasítás kerül beszúrásra.

Engedélyezés

Az irányítópulton: Kontextus → Beállítások → Tömörítés — stílusonként egy sor be-/kikapcsolóval és szintválasztóval. Programozott használat esetén a tömörítési konfiguráció így tárolja a kiválasztást:

{
  "outputStyles": [
    { "id": "i-have-adhd", "level": "full" },
    { "id": "less-code", "level": "lite" }
  ]
}

Visszafelé kompatibilitás: az örökölt outputMode: "caveman" kombinált beállítás továbbra is működik, és a terse-prose stílusra képeződik le; minden örökölt nyelven bájtról bájtra megegyezik a régi beszúrással.

Nyelvválasztás: ha a languageConfig.enabled be van kapcsolva, az autoDetect a legutóbbi felhasználói üzenet nyelvét választja ki (ugyanazzal az érzékelővel, mint a bemeneti motorok); az autoDetect kikapcsolása a defaultLanguage értékéhez rögzíti a nyelvet. Kikapcsolva → angol.

A stílus × nyelv mátrixot a tests/unit/compression/output-styles-i18n-matrix.test.ts rögzíti: új stílus nem adható ki legalább egy pt-BR fordítás (vagy egy kifejezetten nyilvántartott kivétel) nélkül, és egy meglévő stílusból nem tűnhet el észrevétlenül egyetlen területi beállítás sem. Stílus hozzáadásához lásd az EXTENDING_COMPRESSION.md dokumentumot.

Eszközeredmények tömörítése

A toolResultCompressor.ts modul 5 speciális tömörítési stratégiát biztosít az eszközeredményekhez (függvényhívások, ágensek kimenetei, keresési eredmények stb.):

1. Keresési eredmények tömörítése — Eltávolítja a redundáns eredményeket, és megtartja a legjobb N-et
2. Fájlolvasás tömörítése — Csonkolja a nagy fájlokat, megőrzi a fejléceket/importokat
3. Kódvégrehajtás tömörítése — Csak a lényeges stdout/stderr tartalmat tartja meg
4. Adatbázis-lekérdezések tömörítése — Korlátozza a sorok számát, eltávolítja a terjengős metaadatokat
5. API-válaszok tömörítése — Eltávolítja a null mezőket, tömöríti a tömböket

Mikor érdemes használni

Az eszközeredmények tömörítése mindig be van kapcsolva, ha vannak eszközhívások. Nincs szükség konfigurációra.

Egymásra épülő feldolgozási folyamat

Az egymásra épülő mód több motort futtat egymás után — általában először az RTK-t (60–90%-os megtakarítás az eszközkimeneten), majd a Cavemant (további 30%-os megtakarítás a fennmaradó szövegen). Ez 78–95%-os teljes megtakarítást eredményez.

Működése

Bemenet (1000 token)
  → RTK (parancstudatos szűrő) → 200 token
    → Caveman (töltelékszavak eltávolítása) → 140 token
  → Kimenet (140 token, 86%-os megtakarítás)

Mikor érdemes használni

Használja az egymásra épülő módot a következőkhöz:

• Sok eszközt használó munkafolyamatok (ágensalapú kódolás, kutatás)
• Költségérzékeny kötegelt feldolgozás
• Ha maximális tokenmegtakarításra van szükség

Konfigurálja kombinált beállítással:

{
  "strategy": "auto",
  "config": {
    "auto": {
      "modePack": "stacked"
    }
  }
}

---

Kombinációnkénti tömörítési felülbírálások

A globális tömörítési módot kombinációnként felülbírálhatja, így finomhangolhatja a működést a különböző felhasználási esetekhez:

{
  "id": "coding-combo",
  "strategy": "priority",
  "config": {
    "auto": {
      "weights": { "taskFit": 0.5 },
      "modePack": "quality-first"
    }
  },
  "compressionOverride": {
    "mode": "aggressive",
    "stackedPipelines": ["rtk", "caveman"],
    "preserveToolDefinitions": true
  }
}

Ez a következő esetekben hasznos:

• Kódolási kombinációk: Használja az aggressive módot hosszú munkamenetekhez
• Gyors kérdés-válasz kombinációk: Használja a lite módot a gyors válaszokhoz
• Eszközigényes kombinációk: Használja a stacked módot a maximális megtakarítás érdekében
• Éles környezetben használt kombinációk: Használja a cache-aware módot a gyorsítótárazást támogató szolgáltatókhoz

---

Lásd még

• Környezeti konfiguráció — Tömörítési környezeti változók
• Architektúra-útmutató — A tömörítési folyamat belső működése
• Felhasználói útmutató — A tömörítés használatának első lépései
• RTK-tömörítés — RTK-szűrők, bizalmi modell, ellenőrzési kapu és a nyers kimenet helyreállítása
• Tömörítési motorok — Caveman, RTK, egymásra épülő folyamatok, API-k, MCP és irányítópult
• Tömörítési szabályok formátuma — JSON-szabálycsomagok formátuma
• Tömörítési nyelvi csomagok — Nyelvspecifikus Caveman-szabályok