# 🗜️ Prompt Compression Guide — OmniRoute (עברית)

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

---

> חסכו 15%-95% מההקשר המתאים באופן אוטומטי. לסקירה מהירה, ראו את [סעיף הדחיסה ב-README](../README.md#%EF%B8%8F-prompt-compression--save-15-95-eligible-tokens-automatically).

## סקירה כללית

OmniRoute מממשת צינור מודולרי לדחיסת פרומפטים, שפועל **באופן יזום** לפני שהבקשות מגיעות לספקים במעלה הזרם. פירוש הדבר שהחיסכון בטוקנים מתרחש בשקיפות — ללא צורך בשינויים בתהליך העבודה שלכם.

```
בקשת לקוח
  → בורר אסטרטגיית דחיסה
    → יש דריסה של שילוב? → שימוש בהגדרת השילוב
    → סף הפעלה אוטומטית? → שימוש במצב אוטומטי
    → מצב ברירת מחדל? → שימוש בהגדרה הגלובלית
    → כבוי? → דילוג על הדחיסה
  → מצב הדחיסה שנבחר
    → כבוי: ללא דחיסה
    → קל: ניקוי בטוח של רווחים/עיצוב (~15%)
    → רגיל: הסרת מילות מילוי בסגנון דיבור טלגרפי (~30%)
    → אגרסיבי: יישון היסטוריה + סיכום (~50%)
    → אולטרה: גיזום היוריסטי + דילול בלוקי קוד (~75%)
    → RTK: סינון פלט מסוף/כלים עם מודעות לפקודות (טווח של 60%-90% במעלה הזרם)
    → מוערם: צינור רב-מנועי מסודר, בדרך כלל RTK ואז Caveman (טווח של 78%-95% מהתוכן המתאים)
  → בקשה דחוסה → ספק
```

---

## מצבי דחיסה

### כבוי

לא מוחלת דחיסה. כל ההודעות עוברות ללא שינוי.

### מצב קל (חיסכון של ~15%, השהיה של <1ms)

המצב הבטוח ביותר — ללא שינוי סמנטי כלל, רק ניקוי עיצוב:

| טכניקה                   | תיאור                                        |
| ------------------------ | -------------------------------------------- |
| `collapseWhitespace`     | מיזוג שורות ריקות רצופות ורווחים בסופי שורות |
| `dedupSystemPrompt`      | הסרת הודעות מערכת כפולות                     |
| `compressToolResults`    | דחיסת פלטים מפורטים של כלים/פונקציות         |
| `removeRedundantContent` | הסרת הוראות חוזרות                           |
| `replaceImageUrls`       | קיצור URI של נתוני תמונה בקידוד base64       |

**מתאים במיוחד עבור:** שימוש קבוע, תהליכי עבודה שבהם הבטיחות קריטית.

### מצב רגיל (חיסכון של ~30%)

בהשראת [Caveman](https://github.com/JuliusBrussee/caveman) — מסיר מילות מילוי וניסוחים ארכניים תוך שימור המשמעות:

- מסיר מילות מילוי ("בבקשה", "אני חושב", "בעיקרון", "למעשה")
- מצמצם ביטויים ארכניים ("על מנת" → "כדי", "כתוצאה מכך ש-" → "כי")
- מסיר הסתייגויות מנומסות ("האם יהיה אכפת לך...", "אם תוכל אולי...")
- יותר מ-30 כללי regex המותאמים לפרומפטים של תכנות

**מתאים במיוחד עבור:** תהליכי תכנות יומיומיים, צוותים שמודעים לעלויות.

### מצב אגרסיבי (חיסכון של ~50%)

ניהול חכם של ההיסטוריה עבור הפעלות ארוכות:

- **יישון הודעות** — הודעות ישנות יותר נדחסות בהדרגה
- **דחיסת תוצאות כלים** — פלטים ארוכים של כלים נקטמים או מושמטים (שורות ראשונות/אחרונות,
  סינון שורות תואמות, דחיסת מפתחות JSON)
- **מנגנוני הגנה על שלמות מבנית** — מוודאים שצמדי `tool_use` + `tool_result` נשארים עקביים
- **מודעות לחלון ההקשר** — מכבדת מגבלות טוקנים לפי מודל

**מתאים במיוחד עבור:** הפעלות ניפוי שגיאות ממושכות, בסיסי קוד גדולים.

### מצב אולטרה (חיסכון של ~75%)

דחיסה מרבית לתרחישים שבהם טוקנים הם משאב קריטי:

- **גיזום היוריסטי** — גיזום טוקנים בטקסט לפי ציון
- **שימור מבנה** — בלוקי קוד מגודרים, קוד בתוך השורה, כתובות URL ומזהים
  מוחלפים זמנית בסמנים ומשולבים מחדש ללא שינוי, ולעולם אינם נגזמים
- **שכבת SLM אופציונלית** — מודל מקומי קטן יכול לעדן את הגיזום כאשר הוא מוגדר
- בלתי תלוי במצב אגרסיבי: הוא אינו מפעיל יישון הודעות, דחיסת תוצאות כלים
  או את מסכם הגיבוי (רק כשל בשכבת SLM יכול לנתב מעבר גיבוי דרך
  המצב האגרסיבי)

**מתאים במיוחד עבור:** מצבים שבהם מגיעים שוב ושוב למגבלות ההקשר.

### מצב RTK (טווח של 60%-90% במעלה הזרם)

מצב RTK ממוטב לפלטים מפורטים של כלים שמופיעים בהפעלות של סוכני תכנות:

- מזהה סוגי פקודות/פלט כגון `git status`, `git diff`, `git log`, מריצי בדיקות,
  תהליכי בנייה של TypeScript/Vite/Webpack,‏ ESLint/Biome/Prettier, ביקורות/התקנות npm, יומני Docker, פלט תשתיות
  ופלט מעטפת כללי
- מחיל חבילות מסנני JSON מתוך `open-sse/services/compression/engines/rtk/filters/`
- מייבא מסננים בסכמת RTK TOML v1 מקובצי `filters.toml` של הפרויקט או מההגדרות הגלובליות, עם אימות
  בדיקות מוטבעות ובקרת אמון עבור קובצי פרויקט
- כולל 55 מסננים מובנים עם דוגמאות אימות מוטבעות
- מסיר רצפי בקרה של ANSI, פסי התקדמות, שורות חוזרות ורעש שאינו בר-פעולה
- משמר כשלים, שגיאות, אזהרות, קבצים שהשתנו, סיכומים ואת החלק האחרון של פלט ארוך
- תומך במסנני פרויקט מבוקרי אמון, במסננים גלובליים ובשחזור אופציונלי של פלט גולמי מושחר

**מתאים במיוחד עבור:** הפעלות סוכן הכוללות תמלילים של מעטפת, בנייה, בדיקות, git,‏ grep ופלט קבצים.

### מצב מוערם (טווח של 78%-95% מהתוכן המתאים)

מצב מוערם מפעיל מספר מנועי דחיסה בסדר דטרמיניסטי. צינור ברירת המחדל הוא:

```txt
RTK -> Caveman
```

סדר זה מכווץ תחילה את פלט המסוף/הכלים, ולאחר מכן מחיל את הצמצום הסמנטי של Caveman על
יתר הפרומפט בשפה טבעית. ניתן להגדיר צינורות מוערמים באופן גלובלי או באמצעות
שילובי דחיסה המוקצים לשילובי ניתוב.

**מתאים במיוחד עבור:** הקשר מעורב הכולל יומני כלים גדולים לצד הוראות אנושיות או סיכומי עוזר.

---

## חישוב החיסכון ממקורות במעלה הזרם

OmniRoute מתעד את החיסכון באמצעות דחיסה משני מקורות: מדדי ביצועים של פרויקטים במעלה הזרם והרכב המנועים של
OmniRoute עצמו.

| מקור    | הנתון מה-README במעלה הזרם שבו נעשה שימוש כאן                                                                       |
| ------- | ------------------------------------------------------------------------------------------------------------------- |
| Caveman | `~75%` פחות טוקני פלט, חיסכון ממוצע של `65%` בפלט במדדי ביצועים, טווח של `22-87%`, וכלי לדחיסת קלט בשיעור של `~46%` |
| RTK     | חיסכון של `60-90%` בפלט פקודות; הפעלה לדוגמה של `~118,000 -> ~23,900` טוקנים, או חיסכון של `79.7%` (`~80%`)         |

עבור מטענים חופפים של כלים/הקשר, שילוב ברירת המחדל של OmniRoute מערים את המנועים:

```txt
RTK -> Caveman
```

החיסכון המשולב הוא כופלי, לא חיבורי:

```txt
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%
```

הנתון `78-95%` חל כאשר גם RTK וגם Caveman יכולים לצמצם את אותו מטען קלט/הקשר.
מצב פלט התשובה של Caveman הוא נפרד: כאשר הוא מופעל, יש להשתמש בחיסכון הפלט של Caveman עצמו (`65%`
בממוצע, נתון מוביל של `~75%`, טווח של `22-87%`). החיסכון הכולל בחיוב תלוי בתמהיל הפרומפטים/הפלט שלכם.

### מה המשמעות בפועל של "כשיר"

הטווח המוביל של 15-95% הוא אמיתי, אך הוא חל רק על תוכן **מיותר או מילולי מדי** — שורות
שגיאה חוזרות, יומן בנייה שמציף שוב ושוב את אותה אזהרה, פלט גדול מדי של `grep`/קריאת קובץ. אין
פירוש הדבר שכל בקשה תחסוך בשיעור כזה.

אומת באופן אמפירי (`tests/unit/compression/stacked-compression-tool-result-savings.test.ts`): הפעלת
`stacked` (RTK + Caveman) על בלוק `tool_result` במבנה של Anthropic, המכיל 300 שורות
שגיאה זהות, הניבה **חיסכון של 95.93% בטוקנים / חיסכון של 96.26% בתווים** — בדיוק בתוך הטווח
המפורסם. אולם הפעלת אותו צינור עיבוד על פלט כלי רגיל שאינו מיותר (רשימת התאמות נקייה של `grep`,
קריאת קובץ קצרה, טקסט שיחה רגיל) מניבה, כצפוי, **חיסכון הקרוב לאפס**, מכיוון
שאין תוכן חוזר להסרה ו-`validateCompression()` (`validation.ts`) מסרבת לשלוח
שכתוב שעלול להסיר או לשנות בלוקי קוד, כתובות URL, כותרות, גרסאות או מזהי קבועים באותיות רישיות בלבד.

זוהי התנהגות צפויה ובטוחה, ולא באג: סשן תכנות שבעיקר קורא קבצים נקיים או מחפש בהם באמצעות grep
יציג חיסכון כולל מתון גם כשהדחיסה מופעלת במלואה, בעוד שסשן שנתקל בלולאה כושלת
או ב-linter פטפטן יציג את מלוא הטווח של 78-95% עבור תעבורה זו. אל תשתמשו באחוז
חיסכון מצטבר נמוך של סשן יחיד כהוכחה לכך שהדחיסה מוגדרת באופן שגוי — בדקו תחילה אם
פלט הכלי הבסיסי אכן היה מיותר.

---

## המחשה חזותית של החיסכון בטוקנים

```
ללא דחיסה:          47K טוקנים נשלחו ל-LLM
עם Lite:            40K טוקנים נשלחו          (חיסכון של 15% — בטוח, מופעל תמיד)
עם Standard:        33K טוקנים נשלחו          (חיסכון של 30% — כללי דיבור בסגנון Caveman)
עם Aggressive:      24K טוקנים נשלחו          (חיסכון של 50% — התיישנות + סיכום)
עם Ultra:           12K טוקנים נשלחו          (חיסכון של 75% — גיזום היוריסטי)
עם RTK:             19K-5K טוקנים נשלחו       (חיסכון של 60-90% בפלט פקודות/כלים)
עם Stacked:         10K-2.5K טוקנים נשלחו     (טווח כשיר של 78-95% עבור RTK+Caveman)
```

---

## הגדרות

### לוח הבקרה

נווטו אל `Dashboard → Context & Cache`:

- **Caveman** — בחירת מצב, חבילות שפה, תצוגה מקדימה וברירות מחדל גלובליות
- **RTK** — תצוגה מקדימה של מסנן פקודות, הגדרות בטיחות של RTK וקטלוג מסננים
- **Compression Combos** — צינורות עיבוד בעלי שמות של מנועי דחיסה, המוקצים לשילובי ניתוב
- **Auto-Trigger Threshold** — הפעלה אוטומטית של דחיסה כאשר מספר הטוקנים חורג מהסף

### דריסה לפי שילוב

ב-`Dashboard → Context & Cache → Compression Combos`, הקצו שילוב דחיסה לשילוב ניתוב:

```txt
Combo: "free-tier-fallback"
  Compression Combo: "coding-agent-stack"
  Pipeline: RTK -> Caveman
  Targets:
    1. if/kimi-k2.7-code
    2. if/qwen3.8-max-preview
```

כך ניתן להשתמש בדחיסה משולבת אצל ספקים חינמיים או ספקי קידוד, תוך שמירה על מצב lite במינויים
בתשלום.

הקצאת "דריסה לפי שילוב" זו היא פקד נפרד מדריסת **מצב הדחיסה של שילוב הניתוב**
(Default/Off/Lite/Standard/Aggressive/Ultra/Codex Responses — הסכימה של השדה מקבלת גם את
`rtk`,‏ `stacked` ו-`omniglyph`) — דריסה זו אינה בוחרת צינור עיבוד של שילוב דחיסה בעל שם;
היא רק מגדירה את השדה `compressionMode` שבו משתמש `resolveCompressionPlan`. ניתן להגדיר אותה
בכרטיס השילוב (`Dashboard → Combos`) או, החל מ-#6760, לכל שילוב ניתוב בנפרד ברשימה
"Assign to routing" שב-`Dashboard → Context & Cache → Compression Combos`, ממש לצד תיבת הסימון
להקצאת צינור העיבוד המתועדת לעיל. שני הממשקים שומרים את הנתונים באמצעות אותה נקודת קצה
`PUT /api/combos/{id}`.

### דריסה לפי בקשה

שלחו את כותרת הבקשה `x-omniroute-compression` כדי לדרוס את תוכנית הדחיסה עבור בקשה יחידה.
יש לה את העדיפות הגבוהה ביותר — היא גוברת על דריסת שילוב הניתוב, הפרופיל הפעיל,
ההפעלה האוטומטית וברירת המחדל של הלוח. המערכת מתעלמת מערכים לא מוכרים (הבקשה לעולם אינה נדחית),
והמתג הראשי הגלובלי עדיין שולט בכול: כאשר הדחיסה כבויה באופן גלובלי, הכותרת אינה יכולה
להפעיל אותה. ערכים:

| ערך           | השפעה                                                                                     |
| ------------- | ----------------------------------------------------------------------------------------- |
| `off`         | ללא דחיסה עבור בקשה זו.                                                                   |
| `default`     | פרופיל ברירת המחדל שנגזר מהלוח (מתעלם מהפרופיל הפעיל). מנועים מאבדי מידע נותרים כבויים.   |
| `safe`        | זהה להשמטת הכותרת: הסרת כפילויות וצמצום רווחים בלבד.                                      |
| `allow-lossy` | שימור תוכנית המפעיל של בקשה זו, לרבות סיכומים, מסנני רלוונטיות ושכתובים סגנוניים.         |
| `engine:<id>` | מנוע יחיד, כאשר הוא מופעל, למשל `engine:rtk`. זוהי הסכמה מפורשת לפי בקשה לשימוש במנוע זה. |
| `<combo>`     | שילוב בעל שם, שמותאם תחילה לפי שם (ללא תלות ברישיות) ולאחר מכן לפי מזהה.                  |

ללא `allow-lossy`,‏ `engine:<id>` או שילוב בעל שם, מנועים מאבדי מידע אינם מופעלים. כאשר הדחיסה
פעילה, הבקשה עדיין עוברת הסרת כפילויות ברמת ההפעלה וצמצום רווחים.

התוכנית שהופעלה מוחזרת בכותרת התגובה `X-OmniRoute-Compression: <mode>; source=<source>`,
כאשר `<source>` הוא אחד מהערכים `request-header`,‏ `routing-override`,‏ `active-profile`,
‏`auto-trigger`,‏ `default` או `off`.

### API

```bash
# קבלת הגדרות הדחיסה
curl http://localhost:20128/api/settings/compression

# עדכון הגדרות הדחיסה
curl -X PUT http://localhost:20128/api/settings/compression \
  -H "Content-Type: application/json" \
  -d '{"defaultMode":"stacked","autoTriggerMode":"stacked","autoTriggerTokens":32000}'

# תצוגה מקדימה של מטען RTK/stacked מסוים
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
curl http://localhost:20128/api/context/rtk/filters

# בדיקת RTK ישירות עם מטא-נתונים אופציונליים של הפקודה
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"}'
```

---

## מה מוגן

מנוע הדחיסה **תמיד משמר:**

- ✅ בלוקי קוד (מגודרים ובתוך השורה)
- ✅ כתובות URL ונתיבי קבצים
- ✅ מבני JSON ונתונים מובְנים
- ✅ מזהים ואסימונים טכניים מוגנים
- ✅ ביטויים מתמטיים
- ✅ הגדרות של קריאות לכלים/פונקציות
- ✅ הנחיות מערכת (במצב Lite)

שחזור הפלט הגולמי של RTK משחיר מפתחות API נפוצים, אסימוני bearer, אסימוני Slack, מפתחות גישה של AWS,
סיסמאות, אסימונים וסודות לפני שמשהו נשמר.

---

## סטטיסטיקות דחיסה

כל בקשה דחוסה כוללת נתונים סטטיסטיים ביומני השרת:

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

---

## מפת הדרכים לפי שלבים

| שלב    | מצבים                                                                                                                            | סטטוס   |
| ------ | -------------------------------------------------------------------------------------------------------------------------------- | ------- |
| שלב 1  | Off, Lite                                                                                                                        | ✅ הושק |
| שלב 2  | Standard, Aggressive, Ultra                                                                                                      | ✅ הושק |
| שלב 3  | RTK, Stacked, Compression Combos                                                                                                 | ✅ הושק |
| שלב 4  | Output Styles, SLM-tier Ultra, ערכת הערכה                                                                                        | ✅ הושק |
| שלב 4C | תקציב הקשר אדפטיבי ("חוגה") — מנוע חישוב + API (`contextBudget` ב-`PUT /api/settings/compression`) + פקדי מצב/מדיניות בלוח הבקרה | ✅ הושק |

---

## תודות

כללי הדחיסה של מצב Standard נוצרו בהשראת **[Caveman](https://github.com/JuliusBrussee/caveman)** מאת **[JuliusBrussee](https://github.com/JuliusBrussee)** (⭐ 51K+) — הפרויקט הוויראלי "למה להשתמש בהרבה אסימונים כשמעט אסימונים עושים את העבודה". Caveman מדווח על `~75%` פחות אסימוני פלט, חיסכון ממוצע של `65%` בפלט במדדי ביצועים, טווח חיסכון בפלט של `22-87%` וכלי לדחיסת קלט בהיקף של `~46%`.

מצב RTK נוצר בהשראת **[RTK - Rust Token Killer](https://github.com/rtk-ai/rtk)** מאת **[RTK AI](https://github.com/rtk-ai)** — פרויקט עתיר ביצועים לדחיסת פלט פקודות עבור מסוף, בנייה, בדיקות, git וסינון פלט של כלים. RTK מדווח על חיסכון של `60-90%`, כאשר הפעלת הדוגמה ב-README שלו מציגה חיסכון של `~80%`.

---

## מערכות דחיסה מתקדמות

מעבר ל-7 המצבים שתוארו לעיל (קוד המקור מקבל גם את המצבים `codex-responses` ו-
`omniglyph`, שאינם מכוסים במדריך זה), הסעיפים הבאים עוסקים בתכונות
שפועלות בתוך מצבים אלה או לצידם: דחיסת תוצאות כלים ויישון הדרגתי
הם שלבים 1 ו-2 של המנוע האגרסיבי (מצב Aggressive ושלב `aggressive` של
צינור עיבוד מוערם), צינור העיבוד המוערם הוא האופן שבו מצב Stacked פועל, דחיסה מודעת למטמון
משנמכת את `aggressive` ואת `ultra` ל-`standard` עבור ספקים המשתמשים במטמון כאשר הדחיסה
מופעלת, ומצב פלט איש מערות וסגנונות פלט הם הוראות אופציונליות לפרומפט המערכת,
המושבתות כברירת מחדל, שמעצבות את פלט המודל במקום לדחוס את הבקשה.

### דחיסה מודעת למטמון

ספקים מסוימים (כמו Anthropic עם שמירת פרומפטים במטמון) תומכים ב**שמירת פרומפטים במטמון**,
שמאפשרת להם לשמור חלקים מהפרומפט במטמון כדי להפחית עלויות וזמן השהיה. כאשר
שמירה במטמון מופעלת, דחיסה אגרסיבית עלולה למעשה **לפגוע** בביצועים
מכיוון שהיא משנה את הטוקנים השמורים במטמון ובכך מבטלת את תוקף המטמון.

המודול `cachingAware.ts` פותר זאת באמצעות **זיהוי הקשר של שמירה במטמון**
ו**התאמת אסטרטגיית הדחיסה** בהתאם.

#### כיצד זה עובד

1. **זיהוי הקשר של שמירה במטמון** — סורק את גוף הבקשה לאיתור סמני `cache_control`
2. **זיהוי ספקים התומכים במטמון** — בודק אם ספק היעד תומך בשמירה במטמון
3. **התאמת האסטרטגיה** — משנמך את `aggressive`/`ultra` ל-`standard` עבור ספקים התומכים במטמון
4. **דילוג על פרומפט המערכת** — פרומפטים של המערכת נשמרים בדרך כלל במטמון, ולכן אין לדחוס אותם

פונקציית העזר של האסטרטגיה מחזירה גם דגל `deterministicOnly`, אך בונה התוכנית משתמש
רק באסטרטגיה — נכון להיום שום רכיב בהמשך התהליך אינו קורא את הדגל.

#### דוגמת קוד

```ts
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" }, // ← סמן מטמון
};

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

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

#### מתי להשתמש

דחיסה מודעת למטמון **מופעלת תמיד** — אין צורך בהגדרה. היא נכנסת לפעולה בכל פעם
שהדחיסה מופעלת וספק היעד תומך בשמירת פרומפטים במטמון (Anthropic, OpenAI,
וכדומה); סמני `cache_control` מפורשים אינם נדרשים — ספק התומך במטמון לבדו
מפעיל את השנמוך, וסמנים לבדם לעולם אינם עושים זאת (זיהוי הסמנים מזין טלמטריית
מטמון, ולא את החלטת האסטרטגיה).

### יישון הדרגתי

שיחות ארוכות צוברות תורות רבים של הודעות, אך תורות ישנים נעשים פחות
רלוונטיים. המודול `progressiveAging.ts` **מפחית את רמת הפירוט של הודעות לפי מרחק התור**
(המרחק נמדד מסוף השיחה). עם ברירות המחדל המסופקות
(`verbatim: 2, light: 2, moderate: 3`):

- **2 התורות האחרונים (מרחק ≤ 2)**: נשמרים כלשונם
- **מרחק 3**: דחיסת איש מערות (הסרת מילות מילוי)
- **מרחק 4 ומעלה**: הודעות עוזר מסוכמות; הודעות משתמש מצומצמות לשורה הראשונה שלהן,
  עד 120 תווים; תפקידים אחרים נותרים ללא שינוי. פרומפטים של המערכת, הודעות שכבר
  עברו יישון והודעת המשתמש האחרונה נשמרים תמיד כלשונם ללא קשר למרחק.
  דבר אינו נמחק לחלוטין, והטווח `light`
  אינו נגיש עם ברירות המחדל המסופקות (`light` שווה ל-`verbatim`).

#### דוגמת קוד

```ts
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" },
  // ... 50 תורות נוספים ...
];

const { messages: aged, saved } = applyAging(messages, {
  verbatim: 3, // 3 התורות האחרונים: כלשונם
  light: 8, // מרחק <= 8: דחיסה קלה
  moderate: 20, // מרחק <= 20: דחיסת איש מערות
  fullSummary: 5, // נדרש על ידי הטיפוס, אך אינו נקרא על ידי קוד חלוקת הטווחים
  // מרחק > 20: מסוכם (עוזר) / השורה הראשונה נשמרת (משתמש)
});

// saved = מספר הטוקנים שנחסכו
```

#### מתי להשתמש

יישון הדרגתי **מופעל תמיד** במצב `aggressive` — זהו שלב 2 של
`compressAggressive()`. מצב Ultra אינו מפעיל אותו. הוא
יעיל במיוחד עבור:

- הפעלות תכנות ממושכות
- שיחות הנמשכות מספר ימים
- תהליכי עבודה סוכניים עם קריאות רבות לכלים

### מצב פלט איש מערות

מצב פלט איש מערות מוסיף **הוראות לפרומפט המערכת** המבקשות מהמודל עצמו להפיק
פלט תמציתי — הרמה `lite` מבקשת תשובות תמציתיות השומרות על משפטים מלאים, `full`
מבקשת ממנו "להשיב בתמציתיות כמו איש מערות חכם", ו-`ultra` מבקשת פלט טלגרפי;
ההוראות רק מבקשות זאת ואינן יכולות להבטיח זאת. בקשות מקבלות אותן דרך
`applyOutputStyles()` (`open-sse/services/compression/outputStyles/apply.ts`):
תחילה `open-sse/handlers/chatCore.ts` מכריע את הבחירה באמצעות שכבת התאימות לאחור
(`resolveOutputStyleSelection()` בתוך
`open-sse/services/compression/outputStyles/backCompat.ts`), אשר, כל עוד `outputStyles`
ריק, ממפה `cavemanOutputMode` מופעל לסגנון הפלט `terse-prose` בעוצמה
`cavemanOutputMode.intensity` (ראו תאימות לאחור להלן); בחירת `outputStyles`
שאינה ריקה משמשת כפי שהיא, ואז ל-`cavemanOutputMode.enabled` ול-`intensity` אין
השפעה, בעוד שהמתג `autoClarity` שלה עדיין חל. הקובץ `outputMode.ts` מכיל את
טקסטי ההוראות (`CAVEMAN_INSTRUCTION_BY_LANGUAGE`), את עקיפת התוכן ואת
פונקציית העזר למיקום שבה משתמשת ההזרקה; למזריק `applyCavemanOutputMode()` שלו עצמו אין
גורם קורא בסביבת הייצור.

#### כיצד זה עובד

מצב זה אינו דוחס את הקלט. הוא מוסיף בלוק הוראות להנחיית המערכת
(ראו כיצד ההזרקה פועלת להלן), וכל מצב דחיסת קלט שנבחר עבור הבקשה
עדיין מופעל לאחר מכן, על גוף הבקשה שכעת מכיל את הבלוק. לפני סעיף
הגבולות המשותפים שבו מסתיימת כל רמה, רמת `full` באנגלית אומרת:

> "השב בתמציתיות כמו איש מערות חכם. השמט תוויות יידוע (a/an/the), מילות מילוי (just/really/basically/actually/simply), דברי נימוס והסתייגויות. קטעי משפטים מותרים. השתמש במילים נרדפות קצרות (big ולא extensive,‏ fix ולא implement). שמור במדויק על כל התוכן הטכני, הקוד, השגיאות, כתובות ה-URL והמזהים."

מצב זה מתאים במיוחד עבור:

- יצירת קוד (פלט תמציתי יותר = פחות טוקנים)
- שאלות ותשובות מהירות (אין צורך בהסברים מפורטים)
- עיבוד באצווה (למיצוי התפוקה)

#### מתי להשתמש

מצב פלט איש מערות הוא **אופציונלי**. כאשר הדחיסה מופעלת (`enabled: true`, המתג הראשי
בדף הגדרות הדחיסה), הפעילו אותו באמצעות `cavemanOutputMode.enabled`;‏ `intensity`
בוחר `lite`,‏ `full` או `ultra`:

```json
{
  "enabled": true,
  "cavemanOutputMode": {
    "enabled": true,
    "intensity": "full"
  }
}
```

מתג **מצב הפלט** של שילוב דחיסה (`outputMode`, כאשר הרמה נמצאת ב-`outputModeIntensity`)
מגדיר את אותו מתג עבור הבקשות שעליהן השילוב חל, וכלי ה-MCP
`omniroute_set_compression_engine` כותב אותו דרך הארגומנט הבוליאני `outputMode`
שלו. בחירה שאינה ריקה ב-`outputStyles` מקבלת קדימות על פני מתג זה. בלוח הבקרה,
הפעלת סגנון הפלט **פרוזה תמציתית** מזריקה את אותו בלוק (ראו סגנונות פלט
להלן).

### סגנונות פלט (קטלוג)

מצב פלט איש המערות שלעיל הוא **הנתיב הישן של סגנון יחיד**. שלב 4 הכליל אותו
לקטלוג של סגנונות פלט הניתנים להרכבה: `OUTPUT_STYLE_CATALOG` בקובץ
`open-sse/services/compression/outputStyles/catalog.ts`. כל סגנון הוא הוראה בהנחיית המערכת
המבקשת מהמודל עצמו להפיק פלט חסכוני יותר; ניתן להפעיל סגנונות
יחד, והם מוזרקים לפי סדר הקטלוג.

| סגנון                            | `id`            | מה הוא עושה                                                                                                                                                                                                                         | שפות ההוראות                                  |
| -------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| פרוזה תמציתית                    | `terse-prose`   | השמטת מילות מילוי/תוויות יידוע/הסתייגויות; שמירה מדויקת על התוכן הטכני. אותו טקסט כמו מצב פלט איש המערות הישן (מופנה ולא נכתב מחדש).                                                                                                | en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi |
| פחות קוד                         | `less-code`     | סולם YAGNI: השינוי הפעיל הקטן ביותר, ללא הפשטות שלא התבקשו.                                                                                                                                                                         | en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi |
| קוקו (מפתח בכיר עצלן)            | `ponytail`      | "הקוד הטוב ביותר הוא הקוד שמעולם לא נכתב": שימוש חוזר > כתיבה מחדש, גורם שורש > תסמין, ה-diff הפעיל הקצר ביותר.                                                                                                                     | en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi |
| יש לי ADHD (פעולה תחילה)         | `i-have-adhd`   | הפעולה תחילה (פקודה/נתיב/קטע קוד לפני הפרוזה), שלבים ממוספרים ומוגבלים, צעד המשך קונקרטי אחד, ללא הקדמה/סיכום/דברי סיום. מותאם מתוך [ayghri/i-have-adhd](https://github.com/ayghri/i-have-adhd) (MIT).                              | en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi |
| מסנן ממשק משתמש נגד תוכן ירוד    | `antislop-ui`   | כל טכניקה חזותית חייבת לעבור מבחן תכלית (היררכיה, זהות, קריאות); ללא מעברי צבע/זכוכית/זוהר כברירת מחדל, עם פלטת צבעים מוגבלת וללא פריסות תבניתיות. שני סגנונות האנטי-תוכן-הירוד מוסיפים גבול האוסר פקדים לא פעילים / טענות מומצאות. | en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi |
| מסנן נגד תוכן ירוד לטקסט ולאנשים | `antislop-copy` | טקסט ספציפי (ללא קו מפריד ארוך, קריאות כלליות לפעולה, מילות באזז, סיומות של צ'אטבוט או עובדות מומצאות), לצד כללים לאנשים: ניגודיות WCAG AA, מיקוד גלוי, נגישות במקלדת, מצבי ריק/טעינה/שגיאה והתאמה מחדש לנייד.                      | en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi |
| CJK תמציתי (文言)                | `terse-cjk`     | תשובה ברמות `full`/`ultra` בסינית קלאסית (文言); ברמת `lite` מתבקש רק מענה קצר ללא מילות תפקוד, דברי נימוס או קישוטים.                                                                                                              | zh (מוגבל לפי אזור ושפה, ראו להלן)            |

כל סגנון מספק שלוש רמות עוצמה — `lite`,‏ `full`,‏ `ultra` — וכל רמה
מסתיימת בסעיף הגבולות המשותפים (`SHARED_BOUNDARIES` ב-`outputMode.ts`), אשר
שומר במדויק על בלוקי קוד, נתיבי קבצים, פקודות, שגיאות וכתובות URL. הטקסטים של רמות
`terse-prose` ו-`terse-cjk` מוסיפים גם מזהים לרשימה זו.

`terse-cjk` מוגבל לאזור ולשפה `zh` בשני מקומות. דף הגדרות הדחיסה מציג
את השורה שלו רק כאשר שפת ממשק המשתמש של לוח הבקרה היא סינית (`zh-CN` או `zh-TW`), ו-
`applyOutputStyles()` מזריק אותו רק כאשר השפה שנקבעה עבור הבקשה (ראו בחירת
שפה להלן) היא `zh`. הסתרת השורה אינה מוחקת בחירת `terse-cjk` שמורה:
ממשק ה-API של ההגדרות מקבל כל מזהה סגנון, ושמירת סגנונות אחרים בדף משמרת אותה. בזמן
הבקשה, בדיקת השפה של `applyOutputStyles()` היא מגבלת האזור והשפה היחידה.

#### כיצד ההזרקה פועלת

`applyOutputStyles()` (`open-sse/services/compression/outputStyles/apply.ts`) פותרת
את הבחירה מול הקטלוג (מזהים לא מוכרים וסגנונות שאינם תואמים לאזור ולשפה
מושמטים, ולעולם אינם גורמים לשגיאה; בחירה שלא נפתרת לשום סגנון משאירה את גוף
הבקשה ללא שינוי, תוך דילוג בסיבה `no_styles`), משרשרת את ההנחיות שנבחרו לפי סדר
הקטלוג,
מוסיפה את סעיף הגבולות **פעם אחת** (וכן את סעיף הבטיחות, `SAFETY_BOUNDARIES` או
התרגום שלו, כאשר `less-code` או `ponytail` נבחרים), ומתחילה את הבלוק בסמן
אידמפוטנטיות יחיד (`[OmniRoute Output Styles]`), כך שהפעלה חוזרת אינה עושה דבר. כאשר
לשפה שנפתרה (ראו בחירת שפה להלן) יש תרגום, ההנחיה המתורגמת מוזרקת במקום זו שבאנגלית.

בגוף בקשה עם מערך `messages` שאינו ריק, בדיקת האידמפוטנטיות רצה לפני
עקיפת התוכן: כאשר הסמן `[OmniRoute Output Styles]` כבר נמצא בשדה `system`
ברמה העליונה (מחרוזת או מערך של בלוקי תוכן) או בהודעת מערכת עם תוכן מסוג
מחרוזת, גוף הבקשה נותר ללא שינוי במצב `already_applied` ולא מתבצעת בדיקת מילות מפתח.
אחרת, עקיפת תוכן (`shouldBypassCavemanOutputMode()` בקובץ
`open-sse/services/compression/outputMode.ts`) בודקת את הטקסט של שלוש
ההודעות האחרונות, ללא קשר לתפקיד שלהן, ומדלגת על הסגנונות עבור כל התור כאשר הטקסט
תואם למילות המפתח שלה בנושאי אבטחה, פעולה בלתי הפיכה או הבהרה, או
לרצף תלוי-סדר: `first`, `then`, `after that`, `before`, `rollback` או
`backup`, שאחריהם, בתוך 240 תווים, מופיעים `delete`, `drop`, `migrate`, `deploy` או
`release`. העקיפה פועלת כל עוד המתג **Auto-Clarity Bypass**
(`cavemanOutputMode.autoClarity`, מופעל כברירת מחדל) פועל; כיבוי המתג מדלג על
בדיקת מילות המפתח.

כאשר העקיפה מאפשרת לתור לעבור, `placeSystemInstruction()` (באותו קובץ), אשר
לעולם אינה יוצרת `messages[0]` חדש, ממקמת את הבלוק במקום הראשון מבין הבאים שהיא מוצאת:

1. הודעת מערכת פותחת עם תוכן מסוג מחרוזת: הבלוק מצורף לאחר הטקסט שלה.
2. השדה `system` ברמה העליונה: הבלוק מצורף לאחר הטקסט של מחרוזת, או
   נוסף כבלוק טקסט חדש למערך של בלוקי תוכן.
3. הודעת המערכת המאוחרת הראשונה עם תוכן מסוג מחרוזת: הבלוק מצורף לאחר
   הטקסט שלה.
4. אף אחד מהאמורים לעיל: הבלוק מוכנס להודעת מערכת חדשה בסוף `messages`.

בגוף בקשה ללא מערך `messages` (או עם מערך ריק), לא מתבצעת עקיפת תוכן
והשדה `system` ברמה העליונה אינו נבדק. הבלוק מצורף לאחר הטקסט של
שדה `instructions` מסוג מחרוזת, אלא אם שדה זה כבר מכיל את הסמן
`[OmniRoute Output Styles]`, ובמקרה כזה גוף הבקשה נותר ללא שינוי במצב
`already_applied`. כאשר לגוף הבקשה אין שדה `instructions` מסוג מחרוזת אך הוא מכיל `input`
(מחרוזת או מערך), הבלוק הופך לערך של `instructions`, ומחליף כל ערך שאינו מחרוזת
שהשדה הכיל. גוף בקשה שאין בו לא שדה `instructions` מסוג מחרוזת ולא `input` מסוג מחרוזת או
מערך נותר ללא שינוי ומדולג במצב `no_messages`.

#### כיצד להפעיל

בלוח הבקרה: **הקשר דחיסה ← הגדרות דחיסה**
(`/dashboard/context/settings`), במקטע סגנונות פלט: שורה אחת לכל סגנון, עם מתג הפעלה/כיבוי
ובורר רמה. הסגנונות מוזרקים כאשר הדחיסה עצמה פועלת (המתג הראשי של הדף,
`enabled`). המתג **Auto-Clarity Bypass** נמצא בדף **Caveman**
(`/dashboard/context/caveman`), בכרטיס **Output Mode** שלו. באופן תכנותי,
תצורת הדחיסה שומרת את הבחירה כך:

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

תאימות לאחור: כל עוד `outputStyles` ריק, ההגדרה הישנה `cavemanOutputMode.enabled`
ממופה אל `terse-prose` ברמה `cavemanOutputMode.intensity`. לאחר מכן הבלוק מתחיל
בסמן `[OmniRoute Output Styles]`, בעוד שהמזריק הישן `applyCavemanOutputMode()`
כתב את `[OmniRoute Caveman Output Mode]`. מתחת לסמן, הטקסט תואם להזרקה
הישנה בשפות en, pt-BR, es, de, fr, it, ru, id ו-vi; בשפות ja ו-zh הוא כולל רווח
נוסף אחד לפני סעיף הגבולות. `terse-prose` מתורגם ל-pt-BR, es, de,
fr, it, ru, zh, ja, id ו-vi, ולכן בקשה שהשפה שנפתרה עבורה היא `hu` מקבלת את
הטקסט באנגלית, בעוד שהמזריק הישן השתמש בטקסט שלו בהונגרית.

בחירת השפה של סגנון הפלט (`resolveOutputStyleLanguage()` בתוך
`outputStyles/apply.ts`): כאשר `languageConfig.enabled` מופעל, `autoDetect` דוגם את
הודעת המשתמש האחרונה במערך `messages` של הבקשה שיש בה טקסט (תוכן מסוג מחרוזת, או
ה-`text` של חלקי התוכן שלה) ומפעיל עליה את המזהה של מנוע Caveman
(`detectCompressionLanguage()`). המזהה מחזיר `zh` עבור טקסט עם תווי האן
וללא קאנה; אחרת הוא מחזיר את השפה מבין `it`, `pt-BR`, `es`, `de`,
`fr`, `ru`, `ja`, `hu` ו-`id` שלה מספר ההתאמות הרב ביותר לרמזים, ואת `en` כשאין התאמות —
טקסט שאינו יכול לסווג מקבל אנגלית, ולעולם לא `defaultLanguage`, ו-`vi` לעולם אינה
מזוהה אף על פי שהסגנונות כוללים טקסט ב-`vi`. גוף בקשה של Responses API שומר את התורים שלו
ב-`input`, שאינו נדגם, ולכן הוא מקבל את `defaultLanguage`, ולאחר מכן אנגלית. כאשר אין
הודעת משתמש עם טקסט ב-`messages`, או כאשר `autoDetect` כבוי, `defaultLanguage` מוחל,
ולאחר מכן אנגלית. כאשר `languageConfig.enabled` כבוי, השפה היא אנגלית — אלא אם
משולב צירוף דחיסה בבקשה (צירוף שהוקצה לצירוף הניתוב של הבקשה, או צירוף הדחיסה
המוגדר כברירת מחדל שאליו chatCore חוזר עבור צינור העיבוד המובנה והמשורשר): החלת צירוף
מפעילה את `languageConfig.enabled` עבור אותה בקשה ומגדירה את `defaultLanguage` מתוך
חבילות השפה של הצירוף (הערך השמור, אם הוא אחת מחבילות הצירוף, ואחרת החבילה הראשונה
של הצירוף, שברירת המחדל שלה היא `en`), בעוד שהערך השמור של `autoDetect` (מופעל כברירת
מחדל) עדיין חל. מנוע הקלט של Caveman בוחר את שפת חבילת הכללים שלו באופן שונה — לכל
חלק טקסט בנפרד, וכאשר הזיהוי האוטומטי כבוי, בכפוף ל-`enabledPacks`.

מטריצת הסגנון × השפה מקובעת על ידי
`tests/unit/compression/output-styles-i18n-matrix.test.ts`: לכל סגנון בקטלוג חייבת להיות
רשומה ב-`BASELINE_LANGUAGES` של הבדיקה; סגנון שאינו מוגבל לפי אזור חייב לכלול
תרגום ל-pt-BR (הסגנון `terse-cjk`, המוגבל לפי אזור, פטור מכלל זה), אלא אם הוא
מופיע ב-`KNOWN_ENGLISH_ONLY`, שיכול להכיל רק סגנונות שאין להם תרגומים כלל —
סגנון שמופיע ברשימה ויש לו תרגום כלשהו גורם לכישלון הבדיקה; וסגנון גורם לכישלון הבדיקה כאשר
הוא מאבד שפה שמופיעה ברשומת ה-`BASELINE_LANGUAGES` שלו. כדי להוסיף סגנון, ראו
[EXTENDING_COMPRESSION.md](./EXTENDING_COMPRESSION.md#adding-an-output-style).

### דחיסת תוצאות כלים

`compressToolResult()` בקובץ `open-sse/services/compression/toolResultCompressor.ts`
דוחסת טקסט של תוצאות כלים באמצעות **5 אסטרטגיות**. היא מנסה אותן בסדר הבא, והאסטרטגיה
הפעילה הראשונה שהבדיקה שלה תואמת לתוכן קובעת את התוצאה:

1. **`fileContent`**: תוכן בן 3 שורות או יותר שבו לפחות שורה אחת, בהתעלם
   מהזחה בתחילתה, מתחילה ב-`import `, ב-`export `, ב-`function `, ב-`class `,
   ב-`const `, ב-`let `, ב-`var ` או ב-`return ` (מילת המפתח ואחריה רווח), או ב-`if`,
   ב-`for` או ב-`while` שאחריהם `(` או ` (`, משאיר את 20 השורות הראשונות ואת 5
   השורות האחרונות, ומסמן את החלק האמצעי שהושמט.
2. **`grepSearch`**: תוכן הכולל לפחות שורה אחת בתבנית `<path>:<digits>:`,
   שבה הטקסט שלפני הנקודתיים הראשונות אינו מכיל רווחים, משאיר רק את השורות האלה, עד
   30 לכל היותר, ולאחריהן את מספר ההתאמות הנוספות ואת רשימת הקבצים התואמים;
   כל שורה אחרת מוסרת. די בשורה אחת כזו כדי להפעיל את האסטרטגיה, ולכן גם
   שורת יומן שמתחילה בחותמת זמן כגון `12:30:45` נחשבת.
3. **`shellOutput`**: פלט שמכיל רצף ANSI CSI‏ (`ESC[` ואחריו ספרות או
   נקודה-ופסיק ולאחר מכן אות, כמו בקודי צבע) או `$` שאחריו רווח לבן
   במקום כלשהו בטקסט, מאבד את הרצפים האלה (רצפי escape אחרים, כגון `ESC[?25l` או
   רצף OSC לכותרת חלון, נשמרים) ומשאיר את 50 השורות האחרונות, תוך איחוד
   שורות זהות רצופות. מכיוון שבדיקה זו פועלת לפני `json` ו-`errorMessage`,
   פלט JSON או פלט שגיאה שמכיל `$` כזה לעולם אינו מגיע אליהן כל עוד
   `shellOutput` פעילה.
4. **`json`**: מטען JSON שאורכו יותר מ-2,000 תווים, מתחיל ב-`{` או ב-`[` (לאחר
   רווח לבן אופציונלי) וניתן לניתוח, מסוכם כך: מערך בן יותר מ-7 פריטים משאיר
   את 5 הפריטים הראשונים ואת 2 האחרונים וכן את המספר הכולל שלהם, ואובייקט משאיר את 20
   המפתחות הראשונים, כאשר כל ערך שהוא אובייקט או מערך מקונן מוחלף במציין מיקום
   `{…N keys}` (עבור מערך, N הוא אורכו) ובסמן `_remaining_<N>_keys` שסופר את המפתחות
   שהושמטו לאחר 20 הראשונים. ערכים סקלריים מועתקים במלואם, ולכן אובייקט בן 20 מפתחות
   או פחות ללא ערכים מקוננים רק מוזח מחדש — אובייקט ממוזער צובר תווים
   ונשאר ללא שינוי.
5. **`errorMessage`**: פלט שמכיל, במקום כלשהו וללא תלות ברישיות, `error:`,
   `error ` (המילה ואחריה רווח, כמו ב-`no error found`),‏ `[error]`,
   `exception:`,‏ `exception `,‏ `[exception]` או `traceback`, משאיר את השורה הראשונה, את
   10 השורות הבאות ואת 3 האחרונות, עם הסמן `… [N frames elided] …` במקום
   השורות שביניהן. הסמן מופיע רק כאשר אחרי השורה הראשונה יש יותר מ-13 שורות,
   ולכן פלט שגיאה בן 14 שורות או פחות אינו מתקצר (כאשר יש 12 או 13 שורות,
   3 השורות האחרונות חוזרות על שורות שכבר נשמרו).

לאחר שאסטרטגיה תואמת, גם אם היא אינה חוסכת דבר, האסטרטגיות הבאות אינן
נבדקות. כאשר האסטרטגיה התואמת אינה חוסכת טוקנים משוערים (האורך חלקי 4, בעיגול כלפי מעלה) —
לדוגמה, קובץ דמוי קוד בן 25 שורות או פחות, או מערך JSON שאורכו יותר מ-2,000
תווים ובו 7 פריטים או פחות — המנוע האגרסיבי משאיר את תוצאת הכלי המקורית:
שני הקוראים (`compressAggressive()` ו-`compressAnthropicToolResultBlock()`)
משאירים את המקור כאשר `saved` הוא 0 או פחות, בעוד `compressToolResult()` עצמה עדיין
מחזירה את הפלט של אותה אסטרטגיה. שלב תוצאת הכלי אינו המילה האחרונה:
מסכם ברירת המחדל של המנוע עדיין יכול לקצר הודעת `tool` או `function` שאורכה עולה
על 8,192 תווים (`maxTokensPerMessage`,‏ 2,048, כפול 4).

#### מתי להשתמש

דחיסת תוצאות כלים היא שלב 1 במנוע האגרסיבי (`compressAggressive()` בקובץ
`open-sse/services/compression/aggressive.ts`), ולכן היא פועלת במצב Aggressive ובשלב
`aggressive` של צינור עיבוד מוערם. היא דוחסת הודעות `tool` ו-`function`
במבנה של OpenAI, ואת הטקסט שבתוך בלוקי `tool_result` של Anthropic. לכל אסטרטגיה
מתג משלה תחת `aggressive.toolStrategies`, וכולן פעילות כברירת מחדל. בלוח המחוונים,
המתגים נמצאים בתצוגת **Advanced** של עמוד Caveman כאשר הדחיסה פעילה ומצב
ברירת המחדל הוא Aggressive.

### צינור עיבוד מוערם

המצב המוערם מפעיל **מספר מנועים ברצף** — בדרך כלל RTK תחילה
(חיסכון של 60-90% בפלט כלים), ולאחר מכן Caveman על הטקסט שנותר (חיסכון של כ-46%
בקלט). בשילוב מתקבל **טווח זכאות של 78-95%** (ראו חישוב החיסכון במעלה המסמך):
`1 - (1 - 0.60..0.90) × (1 - 0.46)` נותן ממוצע של כ-89%.

#### כיצד זה פועל

```
קלט (1000 טוקנים)
  → RTK (מסנן מודע לפקודות) → 200 טוקנים
    → Caveman (הסרת מלל מיותר) → 108 טוקנים
  → פלט (108 טוקנים, חיסכון של כ-89%)
```

#### מתי להשתמש

השתמשו במצב מוערם עבור:

- תהליכי עבודה עתירי כלים (כתיבת קוד סוכנית, מחקר)
- עיבוד אצווה רגיש לעלויות
- כאשר נדרש חיסכון מרבי בטוקנים

צינורות עיבוד מוערמים מוגדרים באמצעות הגדרת הדחיסה הגלובלית `stackedPipeline`,
או באמצעות צירוף דחיסה בעל שם שמוקצה לצירוף ניתוב (ראו עקיפה לפי צירוף לעיל) —
לא באמצעות `modePack` של צירוף אוטומטי (שדה זה רק משנה את המשקל של בחירת המודל
בצירוף האוטומטי, ו-`stacked` אינו שם חבילה תקין).

---

## דריסות דחיסה לשילובים

ניתן לדרוס את מצב הדחיסה הגלובלי **עבור כל שילוב בנפרד** כדי לכוונן את ההתנהגות
למקרי שימוש שונים:

```json
{
  "id": "coding-combo",
  "strategy": "priority",
  "config": {
    "weights": { "taskFit": 0.5 },
    "modePack": "quality-first"
  },
  "compressionOverride": "aggressive"
}
```

אפשרות זו שימושית עבור:

- **שילובי קידוד**: השתמשו במצב `aggressive` להפעלות ארוכות
- **שילובי שאלות ותשובות מהירות**: השתמשו במצב `lite` לתגובות מהירות
- **שילובים עתירי כלים**: השתמשו במצב `stacked` לחיסכון מרבי
- **שילובי ייצור**: השאירו את הדריסה כבויה עבור ספקים המשתמשים במטמון — ההתאמה
  המודעת למטמון, שפועלת תמיד, משנמכת את `aggressive`/`ultra` ל-`standard` באופן אוטומטי
  (אין מצב `cache-aware` שניתן לבחור בו)

---

## ראו גם

- [תצורת סביבה](../reference/ENVIRONMENT.md) — משתני סביבה של דחיסה
- [מדריך ארכיטקטורה](../architecture/ARCHITECTURE.md) — הרכיבים הפנימיים של צינור עיבוד הדחיסה
- [מדריך למשתמש](../guides/USER_GUIDE.md) — תחילת העבודה עם דחיסה
- [דחיסת RTK](./RTK_COMPRESSION.md) — מסנני RTK, מודל אמון, שער אימות ושחזור פלט גולמי
- [מנועי דחיסה](./COMPRESSION_ENGINES.md) — Caveman,‏ RTK,‏ stacked, ממשקי API,‏ MCP ולוח מחוונים
- [תבנית כללי דחיסה](./COMPRESSION_RULES_FORMAT.md) — תבנית חבילת כללים ב-JSON
- [חבילות שפה לדחיסה](./COMPRESSION_LANGUAGE_PACKS.md) — כללי Caveman ייעודיים לשפה