Files
OmniRoute/docs/i18n/my/docs/compression/COMPRESSION_GUIDE.md
Diego Rodrigues de Sa e Souza 8feea123bb feat(docs): mirror every docs/ page in all 65 locales (#14106)
* feat(docs): mirror every docs/ page in all 65 locales

Extends the documentation mirrors from the 22-page core set (#13940) to
every Markdown page under docs/: 152 sources x 65 locales = 9,880 mirrors
(6,208 new), language bars rewritten for the full locale list, state
adopted so the blocking drift gate now covers all 152 pages.

run-translation.mjs: an oversized block made only of table rows or list
items (PROVIDER_REFERENCE.md 244-row table, FREE_TIERS.md 71-item list) is
cut at item boundaries and rejoined without a blank line — the single
16-40 KB request outlived the backend socket for verbose scripts. 48
older mirrors whose tables had lost rows were retranslated with --force.

* docs(i18n): refresh mirrors for the sources the base changed since the branch cut

Section-level retranslation of the 29 docs (and README.md) whose source
or mirrors moved on release/v3.8.51 during the run, then state adoption;
the drift gate is green again on the merged tree.
2026-09-18 13:16:46 -03:00

64 KiB
Raw Blame History

🗜 Prompt Compression Guide — OmniRoute (မဌန်မာ)

🌐 Languages: 🇺🇞 English · 🇪🇹 am · 🇞🇊 ar · 🇊🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇚🇿 cs · 🇩🇰 da · 🇩🇪 de · 🇬🇷 el · 🇪🇞 es · 🇪🇪 et · 🇮🇷 fa · 🇫🇮 fi · 🇫🇷 fr · 🇮🇪 ga · 🇮🇳 gu · 🇳🇬 ha · 🇮🇱 he · 🇮🇳 hi · 🇭🇷 hr · 🇭🇺 hu · 🇊🇲 hy · 🇮🇩 id · 🇳🇬 ig · 🇮🇹 it · 🇯🇵 ja · 🇬🇪 ka · 🇰🇭 km · 🇮🇳 kn · 🇰🇷 ko · 🇱🇹 lt · 🇱🇻 lv · 🇮🇳 ml · 🇮🇳 mr · 🇲🇟 ms · 🇲🇹 mt · 🇳🇵 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


သတ်မဟတ်ချက်နဟင့် ကိုက်ညီသော context အတလက် 15-95% ကို အလိုအလျောက် ချလေတာပါ။ အကျဉ်သချုပ်ကို အမဌန်ကဌည့်ရန် README Compression အပိုင်သ ကို ကဌည့်ပါ။

ခဌုံငုံသုံသသပ်ချက်

OmniRoute သည် request မျာသ upstream provider မျာသထံ မရောက်ရဟိမီ ကဌိုတင်လုပ်ဆောင်သည့် modular prompt compression pipeline တစ်ခုကို အကောင်အထည်ဖော်ထာသသည်။ ဆိုလိုသည်မဟာ token ချလေတာမဟုကို မသိသာဘဲ အလိုအလျောက် ရရဟိမည်ဖဌစ်ပဌီသ သင်၏ workflow ကို ပဌောင်သလဲရန် မလိုအပ်ပါ။

Client Request
  → Compression Strategy Selector
    → Combo override ရဟိသလာသ? → combo setting ကို အသုံသပဌုရန်
    → Auto-trigger threshold ပဌည့်သလာသ? → auto mode ကို အသုံသပဌုရန်
    → Default mode ရဟိသလာသ? → global setting ကို အသုံသပဌုရန်
    → Off ဖဌစ်သလာသ? → compression ကို ကျော်ရန်
  → ရလေသချယ်ထာသသော Compression Mode
    → Off: Compression မပဌုလုပ်ပါ
    → Lite: ဘေသကင်သသော whitespace/formatting ရဟင်သလင်သမဟု (~15%)
    → Standard: Caveman ပုံစံ မလိုအပ်သည့် စကာသလုံသမျာသ ဖယ်ရဟာသမဟု (~30%)
    → Aggressive: History aging + အကျဉ်သချုပ်ခဌင်သ (~50%)
    → Ultra: Heuristic pruning + code-block thinning (~75%)
    → RTK: Command ကို နာသလည်သော terminal/tool-output စစ်ထုတ်မဟု (upstream အပိုင်သအခဌာသ 60-90%)
    → Stacked: အစီအစဉ်တကျ multi-engine pipeline၊ ပုံမဟန်အာသဖဌင့် RTK ပဌီသနောက် Caveman (သတ်မဟတ်ချက်နဟင့် ကိုက်ညီသော အပိုင်သအခဌာသ 78-95%)
  → ချုံ့ထာသသော Request → Provider

Compression Mode မျာသ

Off

Compression မပဌုလုပ်ပါ။ Message အာသလုံသကို ပဌောင်သလဲခဌင်သမရဟိဘဲ ဖဌတ်သန်သစေသည်။

Lite Mode (~15% ချလေတာမဟု၊ latency <1ms)

အလုံခဌုံဆုံသ mode ဖဌစ်ပဌီသ အဓိပ္ပာယ်ပိုင်သဆိုင်ရာ ပဌောင်သလဲမဟု လုံသဝမရဟိဘဲ formatting ကိုသာ ရဟင်သလင်သသည်-

နည်သလမ်သ ဖော်ပဌချက်
collapseWhitespace ဆက်တိုက်ဖဌစ်နေသော စာကဌောင်သလလတ်မျာသနဟင့် နောက်ဆုံသရဟိ space မျာသကို ပေါင်သစည်သသည်
dedupSystemPrompt ထပ်နေသော system message မျာသကို ဖယ်ရဟာသသည်
compressToolResults စာရဟည်သော tool/function output မျာသကို ချုံ့သည်
removeRedundantContent ထပ်ခါတလဲလဲပါသော ညလဟန်ကဌာသချက်မျာသကို ဖယ်ရဟာသသည်
replaceImageUrls base64 image data URI မျာသကို အတိုချုံ့သည်

အသင့်တော်ဆုံသ: အမဌဲဖလင့်ထာသသော အသုံသပဌုမဟုနဟင့် ဘေသကင်သလုံခဌုံရေသ အလလန်အရေသကဌီသသော workflow မျာသ။

Standard Mode (~30% ချလေတာမဟု)

Caveman ကို အခဌေခံထာသပဌီသ အဓိပ္ပာယ်ကို ထိန်သသိမ်သလျက် မလိုအပ်သော စကာသလုံသမျာသနဟင့် စကာသရဟည်အသုံသအနဟုန်သမျာသကို ဖယ်ရဟာသသည်-

  • မလိုအပ်သော စကာသလုံသမျာသ ("please", "I think", "basically", "actually") ကို ဖယ်ရဟာသသည်
  • စကာသရဟည်အသုံသအနဟုန်သမျာသကို တိုစေသည် ("in order to" → "to", "as a result of" → "because")
  • ယဉ်ကျေသသိမ်မလေ့စလာ မရေမရာပဌောဆိုမဟုမျာသ ("Would you mind...", "If you could possibly...") ကို ဖယ်ရဟာသသည်
  • coding prompt မျာသအတလက် ချိန်ညဟိထာသသော regex rule 30 ကျော် ပါဝင်သည်

အသင့်တော်ဆုံသ: နေ့စဉ် coding workflow မျာသနဟင့် ကုန်ကျစရိတ်ကို အလေသထာသသော အဖလဲ့မျာသ။

Aggressive Mode (~50% ချလေတာမဟု)

ကဌာရဟည် session မျာသအတလက် စမတ်ကျသော history စီမံခန့်ခလဲမဟု-

  • Message Aging — message အဟောင်သမျာသကို တဖဌည်သဖဌည်သ ပိုမိုချုံ့သည်
  • Tool Result Summarization — ရဟည်လျာသသော tool output မျာသကို အကျဉ်သချုပ်မျာသဖဌင့် အစာသထိုသသည်
  • Structural Integrity Guards — tool_use + tool_result အတလဲမျာသ တစ်သမတ်တည်သရဟိကဌောင်သ သေချာစေသည်
  • Context Window Awareness — model တစ်ခုချင်သစီ၏ token ကန့်သတ်ချက်မျာသကို လိုက်နာသည်

အသင့်တော်ဆုံသ: ရက်ရဟည် debugging session မျာသနဟင့် ကဌီသမာသသော codebase မျာသ။

Ultra Mode (~75% ချလေတာမဟု)

Token အလလန်အရေသကဌီသသော အခဌေအနေမျာသအတလက် အမဌင့်ဆုံသ compression-

  • Heuristic Pruning — ဆက်စပ်မဟု threshold အောက်ရဟိ message မျာသကို ဖယ်ရဟာသသည်
  • Code Block Thinning — ထပ်တလဲလဲဖဌစ်နေသော code ဥပမာမျာသကို ချုံ့သည်
  • Binary Search Truncation — context window အတလက် အကောင်သဆုံသ ဖဌတ်တောက်ရမည့်နေရာကို ရဟာဖလေသည်
  • Aggressive mode ၏ feature အာသလုံသ ပါဝင်သည်

အသင့်တော်ဆုံသ: Context limit ကို ထပ်ခါတလဲလဲ ပဌည့်သလာသသည့်အခါ။

RTK Mode (upstream အပိုင်သအခဌာသ 60-90%)

RTK mode ကို coding-agent session မျာသတလင် ပေါ်လာသည့် စာရဟည်သော tool output မျာသအတလက် အထူသပဌုထာသသည်-

  • git status, git diff, git log, test runner မျာသ၊ TypeScript/Vite/Webpack build မျာသ၊ ESLint/Biome/Prettier၊ npm audit/install မျာသ၊ Docker log မျာသ၊ infra output နဟင့် ယေဘုယျ shell output ကဲ့သို့ command/output အမျိုသအစာသမျာသကို ရဟာဖလေသိရဟိသည်
  • open-sse/services/compression/engines/rtk/filters/ မဟ JSON filter pack မျာသကို အသုံသပဌုသည်
  • Project သို့မဟုတ် global filters.toml file မျာသမဟ RTK TOML schema v1 filter မျာသကို inline-test validation နဟင့် project file မျာသအတလက် trust-gating တို့ဖဌင့် import လုပ်သည်
  • Inline verify sample မျာသပါဝင်သော built-in filter 49 ခုကို ထည့်သလင်သပေသထာသသည်
  • ANSI control sequence မျာသ၊ progress bar မျာသ၊ ထပ်နေသော စာကဌောင်သမျာသနဟင့် အရေသယူရန်မလိုသော noise မျာသကို ဖယ်ရဟာသသည်
  • Failure မျာသ၊ error မျာသ၊ warning မျာသ၊ ပဌောင်သလဲထာသသော file မျာသ၊ အကျဉ်သချုပ်မျာသနဟင့် ရဟည်လျာသသော output ၏ နောက်ဆုံသပိုင်သကို ထိန်သသိမ်သထာသသည်
  • Trust-gated project filter မျာသ၊ global filter မျာသနဟင့် ရလေသချယ်နိုင်သော redacted raw-output recovery ကို ပံ့ပိုသသည်

အသင့်တော်ဆုံသ: Shell၊ build၊ test၊ git၊ grep နဟင့် file-output transcript မျာသ ပါဝင်သော agent session မျာသ။

Stacked Mode (သတ်မဟတ်ချက်နဟင့် ကိုက်ညီသော အပိုင်သအခဌာသ 78-95%)

Stacked mode သည် compression engine အမျာသအပဌာသကို တိကျသတ်မဟတ်ထာသသော အစီအစဉ်အတိုင်သ လုပ်ဆောင်သည်။ မူလ pipeline မဟာ-

RTK -> Caveman

ထိုအစီအစဉ်သည် terminal/tool output ကို ညသစလာ ကျစ်လျစ်စေပဌီသနောက် ကျန်ရဟိသော သဘာဝဘာသာစကာသ prompt အပေါ် Caveman semantic condensation ကို အသုံသပဌုသည်။ Stacked pipeline မျာသကို global အနေဖဌင့်ဖဌစ်စေ၊ routing combo မျာသတလင် သတ်မဟတ်ထာသသော compression combo မျာသမဟတစ်ဆင့်ဖဌစ်စေ ပဌင်ဆင်သတ်မဟတ်နိုင်သည်။

အသင့်တော်ဆုံသ: ကဌီသမာသသော tool log မျာသနဟင့် လူသာသ၏ ညလဟန်ကဌာသချက်မျာသ သို့မဟုတ် assistant အကျဉ်သချုပ်မျာသ ရောနဟောပါဝင်သော context မျာသ။


Upstream ချလေတာမဟု တလက်ချက်ပုံ

OmniRoute သည် ချုံ့ခဌင်သကဌောင့် ရရဟိသည့် ချလေတာမဟုမျာသကို ရင်သမဌစ်နဟစ်ခုဖဌစ်သော upstream ပရောဂျက် benchmark မျာသနဟင့် OmniRoute ၏ ကိုယ်ပိုင် engine ပေါင်သစပ်မဟုတို့မဟ မဟတ်တမ်သတင်ဖော်ပဌထာသသည်။

ရင်သမဌစ် ကနေရာတလင် အသုံသပဌုထာသသည့် Upstream README ကိန်သဂဏန်သ
Caveman output token ~75% ပိုနည်သခဌင်သ၊ benchmark ပျမ်သမျဟ output ချလေတာမဟု 65%၊ အပိုင်သအခဌာသ 22-87% နဟင့် input ချုံ့ခဌင်သ tool ~46%
RTK command output ချလေတာမဟု 60-90%၊ နမူနာ session တလင် token ~118,000 -> ~23,900 သို့မဟုတ် 79.7% ချလေတာမဟု (~80%)

ထပ်နေသော tool/context payload မျာသအတလက် ပုံသေ OmniRoute ပေါင်သစပ်မဟုသည် engine မျာသကို အောက်ပါအတိုင်သ အဆင့်ဆင့် အသုံသပဌုသည်-

RTK -> Caveman

ပေါင်သစပ်ချလေတာမဟုသည် ပေါင်သခဌင်သမဟုတ်ဘဲ မဌဟောက်ခဌင်သပုံစံဖဌင့် တလက်ချက်သည်-

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 နဟစ်ခုစလုံသက တူညီသော input/context payload ကို လျဟော့ချနိုင်သည့်အခါတလင် အကျုံသဝင်သည်။ Caveman ၏ response output mode သည် သီသခဌာသဖဌစ်သည်။ ၎င်သကို ဖလင့်ထာသသည့်အခါ Caveman ၏ ကိုယ်ပိုင် output ချလေတာမဟုမျာသ (ပျမ်သမျဟ 65%၊ အဓိကဖော်ပဌချက် ~75%၊ အပိုင်သအခဌာသ 22-87%) ကို အသုံသပဌုပါ။ စုစုပေါင်သ billing ချလေတာမဟုသည် သင်၏ prompt/output အချိုသအစာသပေါ် မူတည်သည်။

"eligible" ဟူသည် အမဟန်တကယ် ဘာကို ဆိုလိုသနည်သ

အဓိကဖော်ပဌထာသသော 15-95% အပိုင်သအခဌာသသည် အမဟန်ဖဌစ်သော်လည်သ ထပ်နေသော သို့မဟုတ် အလလန်ရဟည်လျာသသော အကဌောင်သအရာမျာသအတလက်သာ အကျုံသဝင်သည် — ထပ်ခါတလဲလဲဖဌစ်နေသော error စာကဌောင်သမျာသ၊ တူညီသော warning ကို အလလန်အကျလံ ထုတ်ပဌသည့် build log၊ အရလယ်အစာသအလလန်ကဌီသသော grep/file-read dump တို့ဖဌစ်သည်။ ၎င်သသည် request တိုင်သတလင် ထိုမျဟလောက် ချလေတာနိုင်သည်ဟု မ ဆိုလိုပါ။

လက်တလေ့စမ်သသပ်ပဌီသ အတည်ပဌုထာသသည် (tests/unit/compression/stacked-compression-tool-result-savings.test.ts)။ တူညီသော error စာကဌောင်သ 300 ပါဝင်သည့် Anthropic ပုံစံ tool_result block အပေါ် stacked (RTK + Caveman) run တစ်ခုက token ချလေတာမဟု 95.93% / character ချလေတာမဟု 96.26% ကို ရရဟိစေခဲ့ပဌီသ ကဌော်ငဌာထာသသည့် အပိုင်သအခဌာသအတလင်သ အပဌည့်အဝ ရဟိနေသည်။ သို့သော် တူညီသော pipeline ကို ပုံမဟန်၊ မထပ်နေသော tool output (ရဟင်သလင်သသည့် grep ကိုက်ညီမဟုစာရင်သ၊ တိုတောင်သသော file read၊ ပုံမဟန် စကာသပဌောစာသာသ) အပေါ် run သည့်အခါတလင် မဟန်ကန်စလာ သုညနီသပါသ ချလေတာမဟု သာ ရရဟိသည်။ အဘယ်ကဌောင့်ဆိုသော် ဖယ်ရဟာသရန် ထပ်နေသောအရာ မရဟိသည့်အပဌင် validateCompression() (validation.ts) သည် code block မျာသ၊ URL မျာသ၊ heading မျာသ၊ version မျာသ သို့မဟုတ် ALL-CAPS constant identifier မျာသကို ဖယ်ရဟာသခဌင်သ သို့မဟုတ် ပဌောင်သလဲခဌင်သဖဌစ်စေမည့် ပဌန်လည်ရေသသာသမဟုကို ပေသပို့ရန် ငဌင်သပယ်သောကဌောင့် ဖဌစ်သည်။

၎င်သသည် မျဟော်လင့်ထာသသည့် ဘေသကင်သသော လုပ်ဆောင်ချက်ဖဌစ်ပဌီသ bug မဟုတ်ပါ။ ရဟင်သလင်သသော file မျာသကို အဓိကအာသဖဌင့် ဖတ်ရဟုခဌင်သ/grep လုပ်ခဌင်သသာရဟိသည့် coding session တစ်ခုတလင် ချုံ့ခဌင်သကို အပဌည့်အဝ ဖလင့်ထာသသော်လည်သ စုစုပေါင်သချလေတာမဟု အနည်သငယ်သာ တလေ့ရမည်ဖဌစ်ပဌီသ၊ fail ဖဌစ်နေသည့် loop သို့မဟုတ် output အလလန်မျာသသော linter နဟင့် ကဌုံတလေ့ရသည့် session တစ်ခုတလင်မူ ထို traffic အတလက် 78-95% အပိုင်သအခဌာသအပဌည့်ကို ရရဟိမည်ဖဌစ်သည်။ Session တစ်ခုတည်သ၏ စုစုပေါင်သချလေတာမဟု ရာခိုင်နဟုန်သနည်သခဌင်သကို compression config မဟာသယလင်သနေကဌောင်သ သက်သေအဖဌစ် မယူဆပါနဟင့် — ပထမညသစလာ မူလ tool output သည် အမဟန်တကယ် ထပ်နေခဌင်သရဟိမရဟိ စစ်ဆေသပါ။


Token ချလေတာမဟု ပုံဖော်ပဌသခဌင်သ

ချုံ့ခဌင်သမရဟိဘဲ:      LLM သို့ token 47K ပေသပို့သည်
Lite ဖဌင့်:           token 40K ပေသပို့သည်          (15% ချလေတာ — ဘေသကင်သပဌီသ အမဌဲဖလင့်ထာသသည်)
Standard ဖဌင့်:       token 33K ပေသပို့သည်          (30% ချလေတာ — caveman စကာသပဌောပုံ စည်သမျဉ်သမျာသ)
Aggressive ဖဌင့်:     token 24K ပေသပို့သည်          (50% ချလေတာ — အဟောင်သဖဌစ်လာမဟု + အနဟစ်ချုပ်ခဌင်သ)
Ultra ဖဌင့်:          token 12K ပေသပို့သည်          (75% ချလေတာ — heuristic ဖဌတ်တောက်ခဌင်သ)
RTK ဖဌင့်:            token 19K-5K ပေသပို့သည်       (command/tool output တလင် 60-90% ချလေတာ)
Stacked ဖဌင့်:        token 10K-2.5K ပေသပို့သည်     (အကျုံသဝင်သည့် RTK+Caveman အပိုင်သအခဌာသ 78-95%)

ပဌင်ဆင်သတ်မဟတ်ခဌင်သ

ဒက်ရဟ်ဘုတ်

Dashboard → Context & Cache သို့ သလာသပါ-

  • Caveman — မုဒ်ရလေသချယ်ခဌင်သ၊ ဘာသာစကာသပက်ကေ့ချ်မျာသ၊ အစမ်သကဌည့်ရဟုခဌင်သနဟင့် စနစ်တစ်ခုလုံသဆိုင်ရာ မူလသတ်မဟတ်ချက်မျာသ
  • RTK — command-filter အစမ်သကဌည့်ရဟုခဌင်သ၊ RTK လုံခဌုံရေသဆိုင်ရာ သတ်မဟတ်ချက်မျာသနဟင့် filter catalog
  • Compression Combos — routing combo မျာသတလင် သတ်မဟတ်ပေသထာသသော အမည်ပါ engine pipeline မျာသ
  • Auto-Trigger Threshold — token အရေအတလက်သည် သတ်မဟတ်ထာသသည့် threshold ကို ကျော်လလန်သောအခါ compression ကို အလိုအလျောက် စတင်အသုံသပဌုခဌင်သ

Combo တစ်ခုချင်သစီအလိုက် Override

Dashboard → Context & Cache → Compression Combos တလင် compression combo တစ်ခုကို routing combo တစ်ခုနဟင့် သတ်မဟတ်ချိတ်ဆက်ပါ-

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

ကနည်သဖဌင့် အခပေသ subscription မျာသတလင် lite mode ကို ဆက်လက်အသုံသပဌုထာသစဉ် free/coding provider မျာသတလင် အဆင့်ဆင့်ဆက်ထာသသော compression ကို အသုံသပဌုနိုင်သည်။

က "Per-Combo Override" သတ်မဟတ်ချက်သည် routing-combo compression mode override (Default/Off/Lite/Standard/Aggressive/Ultra) နဟင့် မတူညီသော ထိန်သချုပ်မဟုတစ်ခုဖဌစ်သည် — အဆိုပါ override သည် အမည်ပါ compression-combo pipeline တစ်ခုကို ရလေသချယ်ခဌင်သမဟုတ်ဘဲ resolveCompressionPlan က အသုံသပဌုစစ်ဆေသသည့် compressionMode field ကိုသာ သတ်မဟတ်ပေသသည်။ ၎င်သကို combo card (Dashboard → Combos) ပေါ်တလင်ဖဌစ်စေ၊ #6760 မဟစ၍ အထက်တလင် မဟတ်တမ်သတင်ဖော်ပဌထာသသော pipeline-assignment checkbox ၏ ဘေသရဟိ Dashboard → Context & Cache → Compression Combos ရဟိ "Assign to routing" စာရင်သအတလင်သ routing combo တစ်ခုချင်သစီအလိုက်ဖဌစ်စေ သတ်မဟတ်နိုင်သည်။ မျက်နဟာပဌင်နဟစ်ခုစလုံသသည် တူညီသော PUT /api/combos/{id} endpoint မဟတစ်ဆင့် သိမ်သဆည်သထာသသည်။

Request တစ်ခုချင်သစီအလိုက် override

Request တစ်ခုတည်သအတလက် compression plan ကို override လုပ်ရန် x-omniroute-compression request header ကို ပို့ပါ။ ၎င်သတလင် အမဌင့်ဆုံသ ညသစာသပေသအဆင့်ရဟိသည် — routing-combo override၊ လက်ရဟိအသုံသပဌုနေသော profile၊ auto-trigger နဟင့် panel ၏ Default တို့ထက် ညသစာသပေသသည်။ မသိရဟိသော value မျာသကို လျစ်လျူရဟုမည် (request ကို မည်သည့်အခါမျဟ ငဌင်သပယ်မည်မဟုတ်ပါ)၊ ထို့ပဌင် global master switch က အရာအာသလုံသကို ဆက်လက်ထိန်သချုပ်ထာသသည်- compression ကို စနစ်တစ်ခုလုံသအတလက် ပိတ်ထာသပါက header ဖဌင့် ၎င်သကို ဖလင့်၍မရပါ။ Value မျာသမဟာ-

Value အကျိုသသက်ရောက်မဟု
off က request အတလက် compression မပဌုလုပ်ပါ။
default Panel မဟ ဆုံသဖဌတ်ထာသသော Default profile (လက်ရဟိအသုံသပဌုနေသော profile ကို လျစ်လျူရဟုသည်)။
engine:<id> ဖလင့်ထာသသည့်အခါ engine တစ်ခုတည်သကို အသုံသပဌုသည်၊ ဥပမာ engine:rtk။
<combo> အမည်ပါ combo တစ်ခု၊ ပထမညသစလာ အမည်ဖဌင့် (စာလုံသအကဌီသအသေသမခလဲခဌာသဘဲ) တိုက်ဆိုင်စစ်ဆေသပဌီသနောက် id ဖဌင့် စစ်ဆေသသည်။

အသုံသပဌုထာသသော plan ကို X-OmniRoute-Compression: <mode>; source=<source> response header တလင် ပဌန်လည်ဖော်ပဌပေသသည်။ ထိုနေရာရဟိ <source> သည် request-header၊ routing-override၊ active-profile၊ auto-trigger၊ default သို့မဟုတ် off တစ်ခုခု ဖဌစ်သည်။

API

# Compression သတ်မဟတ်ချက်မျာသကို ရယူရန်
curl http://localhost:20128/api/settings/compression

# Compression သတ်မဟတ်ချက်မျာသကို အပ်ဒိတ်လုပ်ရန်
curl -X PUT http://localhost:20128/api/settings/compression \
  -H "Content-Type: application/json" \
  -d '{"defaultMode":"stacked","autoTriggerMode":"stacked","autoTriggerTokens":32000}'

# သတ်မဟတ်ထာသသော RTK/stacked payload တစ်ခုကို အစမ်သကဌည့်ရန်
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 filter pack မျာသကို စာရင်သပဌုစုရန်
curl http://localhost:20128/api/context/rtk/filters

# ရလေသချယ်ထည့်သလင်သနိုင်သော command metadata ဖဌင့် 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 key မျာသ၊ bearer token မျာသ၊ Slack token မျာသ၊ AWS access key မျာသ၊ စကာသဝဟက်မျာသ၊ တိုကင်မျာသနဟင့် လျဟို့ဝဟက်ချက်မျာသကို ဖုံသကလယ်ပေသသည်။


ချုံ့ခဌင်သ ကိန်သဂဏန်သမျာသ

ချုံ့ထာသသော တောင်သဆိုမဟုတိုင်သတလင် ဆာဗာမဟတ်တမ်သမျာသ၌ ကိန်သဂဏန်သမျာသ ပါဝင်သည်-

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

အဆင့်ဆင့် လမ်သပဌမဌေပုံ

အဆင့် မုဒ်မျာသ အခဌေအနေ
အဆင့် 1 ပိတ်ထာသခဌင်သ၊ Lite ✅ ဖဌန့်ချိပဌီသ
အဆင့် 2 Standard၊ Aggressive၊ Ultra ✅ ဖဌန့်ချိပဌီသ
အဆင့် 3 RTK၊ Stacked၊ Compression Combos ✅ ဖဌန့်ချိပဌီသ
အဆင့် 4 Output Styles၊ SLM-tier Ultra၊ eval harness ✅ ဖဌန့်ချိပဌီသ
အဆင့် 4C လိုက်လျောညီထလေဖဌစ်သော context-budget ("dial") — တလက်ချက်မဟုအင်ဂျင် + API (PUT /api/settings/compression ပေါ်ရဟိ contextBudget) + ဒက်ရဟ်ဘုတ် မုဒ်/မူဝါဒ ထိန်သချုပ်မဟုမျာသ ✅ ဖဌန့်ချိပဌီသ

အသိအမဟတ်ပဌုမဟုမျာသ

Standard မုဒ်၏ ချုံ့ခဌင်သစည်သမျဉ်သမျာသသည် JuliusBrussee (⭐ 51K+) ဖန်တီသသော Caveman — လူကဌိုက်မျာသပျံ့နဟံ့ခဲ့သည့် "တိုကင်နည်သနည်သဖဌင့် အလုပ်ဖဌစ်လျဟင် တိုကင်အမျာသကဌီသကို ဘာကဌောင့်သုံသမလဲ" ပရောဂျက်မဟ စိတ်ကူသရယူထာသသည်။ Caveman ၏ အစီရင်ခံချက်အရ အထလက်တိုကင် ~75% လျော့နည်သခဌင်သ၊ စံနဟုန်သတိုင်သတာမဟု ပျမ်သမျဟအထလက် ချလေတာမဟု 65%၊ အထလက်အပိုင်သအခဌာသ 22-87% နဟင့် အဝင်ချုံ့ခဌင်သကိရိယာ ~46% ရဟိသည်။

RTK မုဒ်သည် RTK AI ဖန်တီသသော RTK - Rust Token Killer — terminal၊ build၊ test၊ git နဟင့် tool-output စစ်ထုတ်ခဌင်သတို့အတလက် စလမ်သဆောင်ရည်မဌင့် command-output ချုံ့ခဌင်သပရောဂျက်မဟ စိတ်ကူသရယူထာသသည်။ RTK ၏ အစီရင်ခံချက်အရ ချလေတာမဟု 60-90% ရဟိပဌီသ ၎င်သ၏ README နမူနာ session တလင် ~80% ချလေတာထာသကဌောင်သ ဖော်ပဌထာသသည်။


အဆင့်မဌင့် ချုံ့ခဌင်သစနစ်မျာသ

ပုံမဟန်မုဒ် ၇ ခုအပဌင် OmniRoute တလင် အကဌောင်သအရာအလိုက် အလိုအလျောက် အလုပ်လုပ်သော အဆင့်မဌင့် ချုံ့ခဌင်သစနစ်မျာသစလာ ပါဝင်သည်။

Cache ကို ထည့်သလင်သစဉ်သစာသသော ချုံ့ခဌင်သ

အချို့ provider မျာသ (prompt caching ပါဝင်သော Anthropic ကဲ့သို့) သည် prompt caching ကို ပံ့ပိုသပေသပဌီသ၊ ယင်သကဌောင့် ကုန်ကျစရိတ်နဟင့် ကဌာချိန်ကို လျဟော့ချရန် prompt ၏ အစိတ်အပိုင်သမျာသကို cache သိမ်သထာသနိုင်သည်။ caching ကို ဖလင့်ထာသသည့်အခါ ပဌင်သထန်သော ချုံ့ခဌင်သသည် cache သိမ်သထာသသော တိုကင်မျာသကို ပဌောင်သလဲစေပဌီသ cache ကို ပျက်ပဌယ်စေသောကဌောင့် စလမ်သဆောင်ရည်ကို အမဟန်တကယ် ထိခိုက်စေနိုင်သည်။

cachingAware.ts module သည် caching အခဌေအနေကို စစ်ဆေသသိရဟိခဌင်သ နဟင့် ထိုအခဌေအနေနဟင့်အညီ ချုံ့ခဌင်သနည်သဗျူဟာကို ချိန်ညဟိခဌင်သ ဖဌင့် ကပဌဿနာကို ဖဌေရဟင်သသည်။

အလုပ်လုပ်ပုံ

  1. caching အခဌေအနေကို စစ်ဆေသခဌင်သ — တောင်သဆိုမဟု body ထဲရဟိ cache_control အမဟတ်အသာသမျာသကို စစ်ဆေသသည်
  2. caching provider မျာသကို ခလဲခဌာသသတ်မဟတ်ခဌင်သ — ညသတည် provider သည် caching ကို ပံ့ပိုသပေသခဌင်သရဟိမရဟိ စစ်ဆေသသည်
  3. နည်သဗျူဟာကို ချိန်ညဟိခဌင်သ — caching provider မျာသအတလက် aggressive/ultra ကို standard သို့ လျဟော့ချသည်
  4. စနစ်ညလဟန်ကဌာသချက်ကို ကျော်သလာသခဌင်သ — စနစ်ညလဟန်ကဌာသချက်မျာသကို ပုံမဟန်အာသဖဌင့် cache သိမ်သထာသသောကဌောင့် ၎င်သတို့ကို မချုံ့ပါ
  5. သတ်မဟတ်ထာသသည့်အတိုင်သ ထပ်တူရလဒ်ထုတ်ပေသသော ပဌောင်သလဲမဟုမျာသကို အသုံသပဌုခဌင်သ — တစ်သမတ်တည်သ ရလဒ်ထလက်စေသော ပဌောင်သလဲမဟုမျာသကိုသာ အသုံသပဌုသည်

ကုဒ်နမူနာ

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" }, // ← Cache အမဟတ်အသာသ
};

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

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

အသုံသပဌုရမည့်အချိန်

Cache ကို ထည့်သလင်သစဉ်သစာသသော ချုံ့ခဌင်သကို အမဌဲဖလင့်ထာသသည် — ဖလဲ့စည်သသတ်မဟတ်ရန် မလိုအပ်ပါ။ အောက်ပါအခဌေအနေမျာသတလင်သာ စတင်အလုပ်လုပ်သည်-

  • တောင်သဆိုမဟုတလင် cache_control အမဟတ်အသာသမျာသ ပါရဟိခဌင်သ
  • ညသတည် provider သည် prompt caching ကို ပံ့ပိုသပေသခဌင်သ (Anthropic၊ OpenAI စသည်တို့)

အဆင့်ဆင့် အဟောင်သပဌုလုပ်ခဌင်သ

ရဟည်လျာသသော စကာသဝိုင်သမျာသတလင် မက်ဆေ့ချ်အလဟည့်မျာသစလာ စုစည်သလာသော်လည်သ အလဟည့်ဟောင်သမျာသသည် ဆက်စပ်မဟု လျော့နည်သလာသည်။ progressiveAging.ts module သည် အလဟည့်အကလာအဝေသအလိုက် မက်ဆေ့ချ်မျာသ၏ အသေသစိတ်အဆင့်ကို လျဟော့ချသည်-

  • မကဌာသေသမီ အလဟည့်မျာသ (0-3): မူရင်သအတိုင်သ ထိန်သသိမ်သထာသသည် (အသေသစိတ်အပဌည့်အစုံ)
  • အလယ်အလတ် အလဟည့်မျာသ (4-8): Lite ချုံ့ခဌင်သ (နေရာလလတ်မျာသ၊ ဖော်မတ်ပဌင်ဆင်မဟု)
  • အလဟည့်ဟောင်သမျာသ (9+): Caveman ချုံ့ခဌင်သ (မလိုအပ်သော စကာသလုံသမျာသ ဖယ်ရဟာသခဌင်သ၊ အကျဉ်သချုပ်ခဌင်သ)
  • အလလန်ဟောင်သသော အလဟည့်မျာသ (20+): အလလန်အမင်သ အကျဉ်သချုပ်ခဌင်သ သို့မဟုတ် ဖယ်ရဟာသခဌင်သ

ကုဒ်နမူနာ

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" },
  // ... နောက်ထပ် အလဟည့် ၅၀ ...
];

const { messages: aged, saved } = applyAging(messages, {
  verbatim: 3, // ပထမအလဟည့် ၃ ခု- မူရင်သအတိုင်သ
  light: 8, // အလဟည့် ၄-၈- lite ချုံ့ခဌင်သ
  moderate: 20, // အလဟည့် ၉-၂၀- caveman ချုံ့ခဌင်သ
  // အလဟည့် ၂၁ နဟင့်အထက်- အလလန်အမင်သ အကျဉ်သချုပ်ခဌင်သ
});

// saved = ချလေတာနိုင်ခဲ့သော တိုကင်အရေအတလက်

အသုံသပဌုရမည့်အချိန်

တဖဌည်သဖဌည်သ အဟောင်သပဌောင်သခဌင်သသည် aggressive နဟင့် ultra မုဒ်မျာသအတလက် အမဌဲတမ်သ ဖလင့်ထာသသည်။ အောက်ပါအခဌေအနေမျာသတလင် အထူသထိရောက်သည်-

  • အချိန်ကဌာမဌင့်စလာ လုပ်ဆောင်သည့် ကုဒ်ရေသသာသမဟု session မျာသ
  • ရက်ပေါင်သမျာသစလာ ကဌာမဌင့်သည့် စကာသဝိုင်သမျာသ
  • tool call မျာသစလာပါဝင်သည့် agentic workflow မျာသ

Caveman Output မုဒ်

outputMode.ts module သည် model ကိုယ်တိုင်က ချုံ့ထာသပဌီသ တိုတောင်သသော output (“caveman” ပုံစံ) ထုတ်လုပ်စေရန် system prompt ညလဟန်ကဌာသချက်မျာသ ကို ထည့်သလင်သပေသသည်။

အလုပ်လုပ်ပုံ

input ကို ချုံ့မည့်အစာသ ကမုဒ်သည် အောက်ပါကဲ့သို့ system prompt တစ်ခုကို ထည့်သလင်သသည်-

"စကာသလုံသအနည်သဆုံသဖဌင့် ဖဌေပါ။ ယဉ်ကျေသသော စကာသမျာသကို ချန်လဟပ်ပါ။ ဝါကျတိုမျာသကို အသုံသပဌုပါ။"

၎င်သသည် အောက်ပါကိစ္စမျာသတလင် အထူသကောင်သမလန်စလာ အလုပ်လုပ်သည်-

  • ကုဒ်ထုတ်လုပ်ခဌင်သ (ပိုတိုသော output = token ပိုနည်သခဌင်သ)
  • အမဌန် အမေသအဖဌေ (အသေသစိတ် ရဟင်သလင်သချက်မျာသ မလိုအပ်ခဌင်သ)
  • Batch processing (throughput ကို အမျာသဆုံသဖဌစ်စေခဌင်သ)

အသုံသပဌုသင့်သည့်အချိန်

Caveman output မုဒ်သည် opt-in ဖဌစ်သည် — combo config မဟတစ်ဆင့် သတ်မဟတ်ပါ-

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

Output ပုံစံမျာသ (ကတ်တလောက်)

အထက်ပါ Caveman output မုဒ်သည် ယခင် single-style လမ်သကဌောင်သ ဖဌစ်သည်။ Phase 4 တလင် ၎င်သကို ပေါင်သစပ်အသုံသပဌုနိုင်သော output ပုံစံမျာသ၏ ကတ်တလောက်အဖဌစ် ယေဘုယျပဌုခဲ့သည်- open-sse/services/compression/outputStyles/catalog.ts ရဟိ OUTPUT_STYLE_CATALOG ဖဌစ်သည်။ ပုံစံတစ်ခုစီသည် model ကိုယ်တိုင်က ကုန်ကျစရိတ်ပိုသက်သာသော output ထုတ်လုပ်စေသည့် system-prompt ညလဟန်ကဌာသချက်တစ်ခုဖဌစ်ပဌီသ၊ ပုံစံမျာသကို အတူတကလ ဖလင့်နိုင်ကာ ကတ်တလောက်အစီအစဉ်အတိုင်သ ထည့်သလင်သသည်။

ပုံစံ id လုပ်ဆောင်ချက် ညလဟန်ကဌာသချက် ဘာသာစကာသမျာသ
တိုတောင်သသော စကာသပဌေ terse-prose မလိုအပ်သော စကာသလုံသမျာသ/articles/မသေချာသလို ပဌောဆိုမဟုမျာသကို ဖယ်ရဟာသပဌီသ နည်သပညာဆိုင်ရာ အနဟစ်သာရကို တိကျစလာ ထိန်သသိမ်သသည်။ ယခင် caveman output မုဒ်နဟင့် စာသာသတူညီသည် (ပဌန်ရိုက်မရေသဘဲ ရည်ညလဟန်သထာသသည်)။ en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
ကုဒ်ပိုနည်သခဌင်သ less-code YAGNI အဆင့်ဆင့်နည်သလမ်သ- အလုပ်လုပ်နိုင်သည့် အနည်သဆုံသပဌောင်သလဲမဟု၊ မတောင်သဆိုထာသသည့် abstraction မျာသမပါဝင်ခဌင်သ။ en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
Ponytail (အပျင်သထူသော ဝါရင့် developer) ponytail "အကောင်သဆုံသကုဒ်သည် ဘယ်တော့မဟ မရေသခဲ့သောကုဒ်ဖဌစ်သည်"- ပဌန်ရေသခဌင်သထက် ပဌန်လည်အသုံသပဌုခဌင်သ၊ လက္ခဏာထက် အရင်သခံအကဌောင်သရင်သ၊ အလုပ်လုပ်နိုင်သည့် အတိုဆုံသ diff။ en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
ကျလန်ုပ်တလင် ADHD ရဟိသည် (လုပ်ဆောင်ချက်ကို ညသစာသပေသ) i-have-adhd လုပ်ဆောင်ချက်ကို ညသစလာပဌခဌင်သ (စကာသပဌေမတိုင်မီ command/path/snippet)၊ နံပါတ်စဉ်တပ်ထာသသော အကန့်အသတ်ရဟိသည့် အဆင့်မျာသ၊ တိကျသော နောက်အဆင့် တစ်ခုတည်သ၊ နိဒါန်သ/အကျဉ်သချုပ်/အပိတ်စကာသ မပါဝင်ခဌင်သ။ ayghri/i-have-adhd (MIT) မဟ ပဌုပဌင်ယူထာသသည်။ en, pt-BR, es, de, fr, it, ru, zh, ja, id, vi
တိုတောင်သသော CJK (文蚀) terse-cjk ရဟေသဟောင်သတရုတ်စာပေစတိုင် အလလန်တိုတောင်သသော ပုံစံ။ zh (locale အလိုက် ကန့်သတ်ထာသသည်- ဖဌေရဟင်သသတ်မဟတ်ထာသသော ဘာသာစကာသသည် zh ဖဌစ်သည့်အခါမဟသာ ပေသထာသသည်)

ပုံစံတိုင်သတလင် lite၊ full၊ ultra ဟူသော ပဌင်သအာသအဆင့်သုံသခု ပါဝင်ပဌီသ အဆင့်တိုင်သသည် မျဟဝေထာသသော နယ်နိမိတ်ဆိုင်ရာ အပိုဒ်ဖဌင့် အဆုံသသတ်သည်။ ၎င်သအပိုဒ်သည် code block မျာသ၊ file path မျာသ၊ command မျာသ၊ error string မျာသ၊ URL မျာသနဟင့် identifier မျာသကို မူရင်သအတိုင်သ ထိန်သသိမ်သပေသသည်။

ထည့်သလင်သပုံ

applyOutputStyles() (open-sse/services/compression/outputStyles/apply.ts) သည် ရလေသချယ်မဟုကို ကတ်တလောက်နဟင့် ကိုက်ညီအောင် ဖဌေရဟင်သသည် (မသိသော id မျာသနဟင့် locale မကိုက်ညီသော ပုံစံမျာသကို ဖယ်ရဟာသပဌီသ error အဖဌစ် ဘယ်တော့မဟ မသတ်မဟတ်ပါ)၊ ရလေသချယ်ထာသသော ညလဟန်ကဌာသချက်မျာသကို ကတ်တလောက်အစီအစဉ်အတိုင်သ ဆက်စပ်ပေသသည်၊ နယ်နိမိတ်ဆိုင်ရာ အပိုဒ်ကို တစ်ကဌိမ်သာ ဖဌည့်စလက်ပဌီသ ရလဒ်ကို idempotency marker တစ်ခုတည်သ ([OmniRoute Output Styles]) ၏နောက်တလင် system prompt ၏ ရဟေ့ပိုင်သသို့ ထည့်သလင်သသည် — ထပ်မံအသုံသချခဌင်သသည် မည်သည့်ပဌောင်သလဲမဟုမျဟ မဖဌစ်စေပါ။ ရဟာဖလေသတ်မဟတ်ထာသသော request ဘာသာစကာသအတလက် ဘာသာပဌန်ရဟိပါက အင်္ဂလိပ်ညလဟန်ကဌာသချက်အစာသ ဒေသသုံသဘာသာဖဌင့် ပဌန်ဆိုထာသသော ညလဟန်ကဌာသချက်ကို ထည့်သလင်သသည်။

ဖလင့်နည်သ

dashboard တလင်- Context → Settings → Compression — ပုံစံတစ်ခုစီအတလက် on/off toggle နဟင့် level selector ပါဝင်သော row တစ်ခုစီရဟိသည်။ Programmatic နည်သဖဌင့် compression config သည် ရလေသချယ်မဟုကို အောက်ပါအတိုင်သ သိမ်သဆည်သသည်-

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

နောက်ပဌန်လိုက်ဖက်ညီမဟု- ယခင် outputMode: "caveman" combo setting သည် ဆက်လက်အလုပ်လုပ်ပဌီသ terse-prose သို့ ချိတ်ဆက်ပေသသည်။ ယခင်ဘာသာစကာသတိုင်သရဟိ အဟောင်သ injection နဟင့် byte အလိုက် တစ်ထပ်တည်သတူညီသည်။

ဘာသာစကာသရလေသချယ်မဟု- languageConfig.enabled ကို ဖလင့်ထာသပါက autoDetect သည် နောက်ဆုံသ user message ၏ ဘာသာစကာသကို ရလေသချယ်သည် (input engine မျာသနဟင့် detector တူညီသည်)။ autoDetect ကို ပိတ်လိုက်ပါက defaultLanguage ကို ပုံသေသတ်မဟတ်သည်။ ပိတ်ထာသလျဟင် → အင်္ဂလိပ်။

ပုံစံ × ဘာသာစကာသ matrix ကို tests/unit/compression/output-styles-i18n-matrix.test.ts ဖဌင့် ပုံသေထိန်သချုပ်ထာသသည်- ပုံစံအသစ်တစ်ခုတလင် အနည်သဆုံသ pt-BR ဘာသာပဌန်တစ်ခု (သို့မဟုတ် အတိအလင်သ မဟတ်တမ်သတင်ခဌေရာခံထာသသော ခဌလင်သချက်တစ်ခု) မပါဘဲ ထုတ်ဝေ၍မရသကဲ့သို့ ရဟိပဌီသသာသပုံစံတစ်ခုသည် locale တစ်ခုကို အသိမပေသဘဲ ဖယ်ရဟာသ၍မရပါ။ ပုံစံတစ်ခု ထည့်သလင်သရန် EXTENDING_COMPRESSION.md ကို ကဌည့်ပါ။

Tool Result ချုံ့ခဌင်သ

toolResultCompressor.ts module သည် tool result မျာသ (function call မျာသ၊ agent output မျာသ၊ ရဟာဖလေမဟုရလဒ်မျာသ စသည်) အတလက် အထူသပဌု compression strategy ၅ မျိုသ ကို ပံ့ပိုသသည်-

  1. ရဟာဖလေမဟုရလဒ် ချုံ့ခဌင်သ — ထပ်နေသောရလဒ်မျာသကို ဖယ်ရဟာသပဌီသ ထိပ်ဆုံသ N ခုကို ထိန်သသိမ်သသည်
  2. ဖိုင်ဖတ်ရဟုမဟု ချုံ့ခဌင်သ — ကဌီသမာသသောဖိုင်မျာသကို ဖဌတ်တောက်ပဌီသ header/import မျာသကို ထိန်သသိမ်သသည်
  3. ကုဒ်လုပ်ဆောင်မဟု ချုံ့ခဌင်သ — မရဟိမဖဌစ်လိုအပ်သော stdout/stderr ကိုသာ ထိန်သသိမ်သသည်
  4. Database query ချုံ့ခဌင်သ — row အရေအတလက်ကို ကန့်သတ်ပဌီသ ရဟည်လျာသသော metadata ကို ဖယ်ရဟာသသည်
  5. API response ချုံ့ခဌင်သ — null field မျာသကို ဖယ်ရဟာသပဌီသ array မျာသကို ကျစ်လျစ်စေသည်

အသုံသပဌုသင့်သည့်အချိန်

tool call မျာသ ပါဝင်သည့်အခါ Tool result compression ကို အမဌဲတမ်သ ဖလင့်ထာသသည်။ Configuration ပဌုလုပ်ရန် မလိုအပ်ပါ။

Stacked Pipeline

stacked မုဒ်သည် engine အမျာသအပဌာသကို အစဉ်လိုက် လုပ်ဆောင်သည် — ပုံမဟန်အာသဖဌင့် RTK ကို ညသစလာအသုံသပဌုသည် (tool output တလင် 60-90% ချလေတာမဟု)၊ ထို့နောက် Caveman ကို အသုံသပဌုသည် (ကျန်ရဟိသောစာသာသတလင် နောက်ထပ် 30% ချလေတာမဟု)။ ကနည်သဖဌင့် စုစုပေါင်သ 78-95% ချလေတာမဟု ရရဟိသည်။

အလုပ်လုပ်ပုံ

Input (1000 tokens)
  → RTK (command ကို နာသလည်သည့် filter) → 200 tokens
    → Caveman (မလိုအပ်သော စကာသလုံသမျာသ ဖယ်ရဟာသခဌင်သ) → 140 tokens
  → Output (140 tokens၊ 86% ချလေတာမဟု)

အသုံသပဌုသင့်သည့်အချိန်

အောက်ပါကိစ္စမျာသအတလက် stacked မုဒ်ကို အသုံသပဌုပါ-

  • Tool အသုံသပဌုမဟုမျာသသော workflow မျာသ (agentic coding၊ သုတေသန)
  • ကုန်ကျစရိတ်အရေသကဌီသသော batch processing
  • token ချလေတာမဟုကို အမျာသဆုံသလိုအပ်သည့်အခါ

combo မဟတစ်ဆင့် configure လုပ်ပါ-

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

Compression Combo ကို အလိုက်သင့် အစာသထိုသသတ်မဟတ်ခဌင်သ

မတူညီသော အသုံသပဌုမဟုအခဌေအနေမျာသအတလက် လုပ်ဆောင်ပုံကို အသေသစိတ်ချိန်ညဟိရန် ကမ္ဘာလုံသဆိုင်ရာ compression mode ကို combo တစ်ခုချင်သစီအလိုက် အစာသထိုသသတ်မဟတ်နိုင်သည်-

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

ကအရာသည် အောက်ပါအခဌေအနေမျာသတလင် အသုံသဝင်သည်-

  • Coding combo မျာသ: ကဌာမဌင့်သော session မျာသအတလက် aggressive mode ကို အသုံသပဌုပါ
  • အမဌန် အမေသအဖဌေ combo မျာသ: မဌန်ဆန်သော တုံ့ပဌန်ချက်မျာသအတလက် lite mode ကို အသုံသပဌုပါ
  • Tool အမျာသအပဌာသသုံသသော combo မျာသ: ချလေတာမဟုအမျာသဆုံသရရဟိရန် stacked mode ကို အသုံသပဌုပါ
  • Production combo မျာသ: Caching provider မျာသအတလက် cache-aware mode ကို အသုံသပဌုပါ

ထပ်မံကဌည့်ရဟုရန်

  • Environment Config — Compression environment variable မျာသ
  • Architecture Guide — Compression pipeline ၏ အတလင်သပိုင်သလုပ်ဆောင်ပုံ
  • User Guide — Compression ကို စတင်အသုံသပဌုခဌင်သ
  • RTK Compression — RTK filter မျာသ၊ ယုံကဌည်မဟု model၊ အတည်ပဌုခဌင်သ gate နဟင့် မူရင်သ output ပဌန်လည်ရယူခဌင်သ
  • Compression Engines — Caveman၊ RTK၊ stacked၊ API မျာသ၊ MCP နဟင့် dashboard
  • Compression Rules Format — JSON rule-pack format
  • Compression Language Packs — ဘာသာစကာသအလိုက် Caveman rule မျာသ