Never stop coding. Free MIT AI gateway: one endpoint, 375 providers (150+ free), 1,400+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 900+ contributors
RTK Compression (አማርኛ)
🌐 Languages: 🇺🇸 English · 🇸🇦 ar · 🇦🇿 az · 🇧🇬 bg · 🇧🇩 bn · 🇧🇦 bs · 🇨🇿 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 · 🇲🇲 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
RTK compression ለተርሚናል እና ለመሣሪያ ውጤት የተዘጋጀ የOmniRoute ትዕዛዝ-ተኮር የማመቅ ሞተር ነው። አብዛኛው የአውድ እድገት ከሙከራ ምዝግቦች፣ ከግንባታ ውጤት፣ ከፓኬጅ አስተዳዳሪ የተትረፈረፈ ውጤት፣ ከሼል ግልባጮች፣ ከDocker ውጤት፣ ከgit ውጤት እና ከቁልል ዱካዎች ለሚመጣባቸው የኮዲንግ-ወኪል ክፍለ ጊዜዎች የተነደፈ ነው።
RTK በቀጥታ በdefaultMode: "rtk" ወይም በተደራራቢ ቧንቧ መስመር ውስጥ እንደ መጀመሪያው ደረጃ ሊሠራ ይችላል፤ በተለምዶ፦
rtk -> caveman
ይህ ቅደም ተከተል በመጀመሪያ የተትረፈረፈውን የማሽን ውጤት ያመቃል፣ ከዚያም Caveman የቀረውን ጽሑፍ እንዲያጠቃልል ያስችለዋል።
የላይኛው ምንጭ RTK በትዕዛዝ ውጤት ላይ 60-90% ቁጠባ እንዳለ ዘግቧል። በREADME ውስጥ ያለው የናሙና ክፍለ ጊዜ ከ~118,000 መደበኛ ቶከኖች ወደ ~23,900 RTK ቶከኖች ይቀንሳል፤ ይህም 79.7% ቁጠባ (~80%) ነው። OmniRoute ያንን የላይኛው ምንጭ አማካይ ከCaveman የግቤት ማመቅ ጋር ለተደራራቢው የቁጠባ ስሌት ይጠቀማል፦
የRTK አማካይ፦ 80% ተቆጥቧል
የCaveman ግቤት፦ 46% ተቆጥቧል
የተደራረበ፦ 1 - (1 - 0.80) * (1 - 0.46) = 89.2% ተቆጥቧል
ክልል፦ 1 - (1 - 0.60..0.90) * (1 - 0.46) = 78.4-94.6%
የሚያመቃቸው ነገሮች
አብሮገነቡ ካታሎግ በአሁኑ ጊዜ በእነዚህ ምድቦች ውስጥ 49 ማጣሪያዎችን ይዟል፦
| ምድብ | ምሳሌዎች |
|---|---|
git |
git status፣ git branch፣ git diff፣ git log |
test |
Vitest፣ Jest፣ Pytest፣ Playwright፣ የGo ሙከራዎች፣ የCargo ሙከራዎች |
build |
TypeScript፣ ESLint፣ Biome፣ Prettier፣ Vite፣ Webpack፣ Turbo፣ Nx |
package |
npm install፣ npm audit፣ pip፣ uv sync፣ Poetry፣ Bundler |
shell |
ls፣ find፣ grep፣ አጠቃላይ የሼል ምዝግቦች |
docker |
docker ps፣ የDocker ምዝግቦች |
infra |
Terraform፣ OpenTofu፣ systemctl status |
generic |
የJSON ውጤት፣ የቁልል ዱካዎች፣ የአጠቃላይ ውጤት ምትክ |
በopen-sse/services/compression/engines/rtk/commandDetector.ts ውስጥ ያለው ፈላጊ ማጣሪያ ከመመረጡ በፊት ውጤቱን ይመድባል። የትዕዛዝ ክፍል ብቻውን በቂ በማይሆንበት ጊዜ ማጣሪያዎች በትዕዛዝ ንድፍ ወይም በውጤት regex መሠረትም ማዛመድ ይችላሉ።
የማጣሪያ መፍትሔ ሂደት
RTK ማጣሪያዎችን በዚህ ቅደም ተከተል ይጭናል፦
- የፕሮጀክት ማጣሪያዎች ከ
.rtk/filters.tomlእና.rtk/filters.json፣ የታመኑ ሲሆኑ ብቻ። - ዓለም አቀፍ ማጣሪያዎች ከ
DATA_DIR/rtk/filters.tomlእናDATA_DIR/rtk/filters.json። - አብሮገነብ ማጣሪያዎች ከ
open-sse/services/compression/engines/rtk/filters/።
በተመሳሳይ ወሰን ውስጥ፣ የRTK TOML schema v1 ማጣሪያዎች ከOmniRoute JSON ማጣሪያዎች ቅድሚያ ያገኛሉ። ከውጭ የመጣ ትዕዛዝ-ተኮር ማጣሪያ በዚያ ወሰን ውስጥ ያለን ይበልጥ ሰፊ ማጣሪያ እንዲተካ፣ የTOML match_command አገላለጾች ከትዕዛዝ-ዓይነት ማዛመድ በፊት ይፈተሻሉ። የፕሮጀክት ወሰን የፋይል ቅርጸቱ ምንም ይሁን ምን ከዓለም አቀፍ ወሰን ቅድሚያ ያገኛል።
የregex ማጣሪያዎች የመሣሪያ ውጤት ለወኪሎች የሚታይበትን መንገድ ሊቀይሩ ስለሚችሉ፣ የፕሮጀክት ማጣሪያዎች ሆን ተብሎ በእምነት ማረጋገጫ ተገድበዋል። ከእነዚህ አንዱ እውነት ሲሆን የፕሮጀክት ማጣሪያ ፋይል ተቀባይነት ያገኛል፦
rtkConfig.trustProjectFilterstrueነው።OMNIROUTE_RTK_TRUST_PROJECT_FILTERS=1ተቀናብሯል።.rtk/trust.jsonለፕሮጀክቱ ማጣሪያ ፋይል ተዛማጅ የSHA-256 hash ይዟል።
የእምነት ፋይል ምሳሌ፦
{
"filtersSha256": "0123456789abcdef...",
"filtersTomlSha256": "fedcba9876543210..."
}
hash-ዎቹ የተለያዩ ናቸው፦ filtersSha256 .rtk/filters.jsonን ያምናል፣ filtersTomlSha256 ደግሞ .rtk/filters.tomlን ያምናል። ከሁለቱ ፋይሎች አንዱን ማርትዕ የራሱን የእምነት ግቤት ብቻ ዋጋ ያሳጣል። ዓለም አቀፍ ፋይሎች በአስተዳዳሪ የተጫኑ ሲሆኑ ነባሩን የዓለም አቀፍ ማጣሪያ የእምነት ባህሪ ይጠቀማሉ።
ብጁ ማጣሪያዎች አንድ የማጣሪያ ነገር ወይም የማጣሪያ ነገሮች ድርድር ሊሆኑ ይችላሉ። ልክ ያልሆኑ ብጁ ማጣሪያዎች ይዘለላሉ እና በ/api/context/rtk/filters ምርመራዎች ሪፖርት ይደረጋሉ። ልክ ያልሆኑ አብሮገነብ ማጣሪያዎች ወዲያውኑ እንዲቋረጥ ያደርጋሉ።
RTK TOML schema v1 ተኳኋኝነት
OmniRoute RTK TOML schema v1ን የሚጠቀሙ መግለጫዊ የማጣሪያ ፋይሎችን መተንተን፣ ማረጋገጥ፣ መፈተሽ እና መጫን ይችላል።
የሚደገፉት መስኮች description፣ match_command፣ strip_ansi፣ filter_stderr፣
strip_lines_matching፣ keep_lines_matching፣ replace፣ match_output፣ truncate_lines_at፣
head_lines፣ tail_lines፣ max_lines፣ on_empty እና [[tests.<filter>]] የውስጥ መስመር ፈተናዎች ናቸው።
ያልታወቁ መስኮች፣ ልክ ያልሆኑ ወይም ደህንነታቸው ያልተጠበቀ መደበኛ አገላለጾች፣ በአንድ ጊዜ የሚገለጹ የማስወገጃ/ማቆያ ደንቦች፣
ከ1 MiB በላይ የሆኑ ፋይሎች እና ያልታወቁ ማጣሪያዎችን የሚጠቅሱ ማጣቀሻዎች ውድቅ ይደረጋሉ። የውስጥ መስመር ፈተናዎቹ ያልተሳኩበት ፋይል ለምርመራ
ሊረጋገጥ ይችላል፣ ነገር ግን ሊጫን ወይም ወደ ስርዓቱ ሊገባ አይችልም። ብጁ ፋይልን ወደ ስርዓቱ ማስገባት ሲሳነው
ሁኔታው fail-open ሆኖ ይቀጥላል፦ ልክ ያልሆነው ፋይል ይዘለላል፣ ቀሪዎቹ ማጣሪያዎችም መስራታቸውን ይቀጥላሉ።
OmniRoute የመሣሪያውን ውፅዓት የሚቀበለው ደንበኛው አስቀድሞ ከያዘው በኋላ ስለሆነ፣ filter_stderr = true
የሂደቱን መያዝ ሊለውጥ አይችልም። መስኩ ምንም እርምጃ እንደማይወስድ ሆኖ ተቀባይነት ያገኛል፣ ማረጋገጡም ማስጠንቀቂያ ይመልሳል።
ይህ ሆን ተብሎ RTK TOML schema v1 ተኳኋኝነት ተብሎ ይገለጻል፤ ከRTK አስፈጻሚ ፋይል፣ shell hooks፣ Rust የትዕዛዝ ትግበራዎች ወይም የtrust-store አቀማመጡ ጋር ሙሉ ተኳኋኝነት እንዳለው አይገልጽም።
የዳሽቦርዱ የላቀ RTK እይታ የተለጠፈ ወይም የተሰቀለ TOML ይቀበላል። ማረጋገጡ ለንባብ ብቻ ነው።
መጫኑ DATA_DIR/rtk/filters.tomlን በጥብቅ ፈቃዶች በአቶሚክ መንገድ ይጽፋል፣ እንደገና ማስጀመር ሳያስፈልግም
ቀጥታ የሚሰራውን የማጣሪያ ካታሎግ ያድሳል። ነባር ፋይልን ለመተካት ግልጽ የoverwrite
ማረጋገጫ ያስፈልጋል፣ እንዲሁም በመጀመሪያ DATA_DIR/rtk/filters.toml.bakን ይፈጥራል።
የማጣሪያ DSL
ማጣሪያዎች በCompression Rules Format የተገለጸውን JSON schema ይጠቀማሉ። runtime እነዚህን ደረጃዎች በቅደም ተከተል ይተገብራል፦
stripAnsi -> filterStderr -> replace -> matchOutput -> drop/include lines
-> truncateLineAt -> head/tail/maxLines -> onEmpty
አስፈላጊ መስኮች፦
| መስክ | ዓላማ |
|---|---|
rules.stripAnsi |
ከማዛመድ በፊት የተርሚናል ቀለም/መቆጣጠሪያ ተከታታዮችን ማስወገድ |
rules.filterStderr |
ከማዛመድ/ማጣራት በፊት የተለመዱ stderr ቅድመ ቅጥያዎችን ወጥ ማድረግ |
rules.replace |
በቅደም ተከተል የተቀመጡ የregex ምትክ ለውጦችን መተግበር |
rules.matchOutput |
ውፅዓቱ ከታወቀ ሁኔታ ጋር ሲዛመድ የታመቀ ማጠቃለያ መመለስ |
rules.matchOutput[].unless |
የስህተት/ውድቀት ጥለት ሲኖር አቋራጩን መዝለል |
rules.dropPatterns |
ጫጫታ የበዛባቸውን መስመሮች ማስወገድ |
rules.includePatterns |
ተግባራዊ እርምጃ ሊወሰድባቸው ለሚችሉ መስመሮች ቅድሚያ መስጠት |
rules.collapsePatterns |
ተደጋጋሚ የሚዛመዱ መስመሮችን ማጠቃለል |
rules.deduplicate |
ለእያንዳንዱ ማጣሪያ በተናጠል የሚነቃ፦ ተከታታይ የተባዙ መስመሮችን ማጠቃለል |
rules.truncateLineAt |
Unicodeን በማይጎዳ መንገድ እያንዳንዱን መስመር መቁረጥ |
rules.onEmpty |
ሁሉም መስመሮች ከተጣሩ የሚታይ አማራጭ መልዕክት |
tests[] |
በማረጋገጫ ደረጃው የሚጠቀሙ የውስጥ መስመር ናሙናዎች |
አብረው የተካተቱ ማጣሪያዎች የውስጥ መስመር tests[] ናሙናዎችን እንዲያካትቱ ይጠበቃል። ብጁ ማጣሪያዎችም
እነዚህን ማካተት አለባቸው፣ በተለይም በተለያዩ ፕሮጀክቶች መካከል ሲጋሩ።
የመስመር ብዜት ማስወገድ (ሁለት ደረጃዎች)
RTK የተደጋገሙ መስመሮችን በሁለት እርስ በርሳቸው ነጻ በሆኑ ደረጃዎች ያጣምራል፦
- በእያንዳንዱ ማጣሪያ
deduplicate(በምርጫ የሚነቃ፣ ነባሪውfalse)። አንድ ማጣሪያrules.deduplicate: trueበማዘጋጀት፣ ከመቆረጡ በፊት ከዚያ ማጣሪያ ጋር በተዛመደው ውጤት ውስጥ ያሉ ተከታታይ የተባዙ መስመሮችን ማጣመር ይችላል። ይህ በlineFilter.tsውስጥ ይከናወናል። ለቀድሞ ማጣሪያዎች፣ ማጣሪያውcollapsePatternsን ሲገልጽ በራስ-ሰር ይነቃል። መርሃግብር፦deduplicate: z.boolean().default(false)በopen-sse/services/compression/engines/rtk/filterSchema.tsውስጥ። - የመተግበሪያ ሞተሩ አጠቃላይ
deduplicateThreshold(ነባሪው3)። ሁሉም ማጣሪያዎች ከተከናወኑ በኋላ፣ ሞተሩ በጠቅላላው ውጤት ውስጥ>= deduplicateThresholdተመሳሳይ ተከታታይ መስመሮች ያሉበትን ማንኛውንም ተከታታይ ስብስብ ያጣምራል (deduplicateRepeatedLines፣ በengines/rtk/index.tsውስጥ የሚተገበር)። በመደበኛነት ሲዋቀር እሴቱ ከ2–100 ባለው ክልል ይገደባል።
የእያንዳንዱ ማጣሪያ ሂደት መጀመሪያ ይከናወናል (በማጣሪያው ውስጥ)፣ የመተግበሪያ ሞተሩ አጠቃላይ ሂደት ደግሞ መጨረሻ ይከናወናል (በተቀላቀለው ውጤት ላይ)፤ ስለዚህ ሁለቱ ድርብ ቆጠራ ሳይፈጥሩ ተደራርበው ይሰራሉ።
የመስመር ማቧደን (enableGrouping)
rtkConfig.enableGrouping true ሲሆን (ነባሪው false)፣ RTK ከብዜት ማስወገድ በኋላ ባለው ውጤት ላይ ተጨማሪ
groupSimilarLines ሂደትን ያከናውናል፤ ይህም እጅግ ተቀራራቢ (በባይት ደረጃ ፍጹም ተመሳሳይ ያልሆኑ)
ተከታታይ መስመሮችን ያጣምራል። rtkConfig.groupingThreshold (ነባሪው 3) ማቧደንን ለማስጀመር
የሚያስፈልገው ዝቅተኛው ተከታታይ መስመሮች ብዛት ነው። ይህ የdeduplicateThreshold መዋቅራዊ አቻ ነው፦ ብዜት ማስወገድ ፍጹም ተመሳሳይ ድግግሞሾችን ያስተናግዳል፣
ማቧደን ደግሞ "ተመሳሳይ ቅርጽ ያላቸው ጥቃቅን ልዩነቶች" ያሉባቸውን ያስተናግዳል። ሁለቱም ማመልከቻዎች በkey_value ሰንጠረዥ ውስጥ የሚቀመጠው
የrtkConfig JSON አካል ናቸው (ከላይ ያለውን ውቅር ይመልከቱ)፤ ስለዚህ ቅንብሩ ዳግም ከተጀመረ በኋላም ይቆያል።
የኮድ አስተያየቶችን ማስወገድ (stripCodeComments / preserveDocstrings)
rtkConfig.applyToCodeBlocks ሲነቃ፣ RTK በአጥር ከተከበቡ የኮድ ብሎኮች ውስጥ ያሉ አስተያየቶችንም ማስወገድ ይችላል፦
stripCodeComments(ነባሪውfalse) — በምርጫ የሚነቃ።trueሲሆን፣ RTK በJavaScript እና TypeScript የኮድ ብሎኮች ውስጥ ያሉ አስተያየቶችን ያስወግዳል። ከታሪክ አንጻር ማመልከቻው ይነበብ ነበር እንጂ ተግባራዊ አልነበረም፤ ስለዚህ በምርት አካባቢ ያለማሳወቅ ለውጥ እንዳይኖር ነባሪው "ማቆየት" ሆኖ ይቀጥላል።preserveDocstrings(ነባሪውtrue) — አስተያየቶችን በሚያስወግድበት ጊዜ፣ የJSDoc//** … */ብሎክ አስተያየቶች ይቀመጣሉ (ከሚወስዱት ባይቶች የበለጠ ዋጋ ያለው የAPI ሰነድ ይይዛሉ)። እነዚያንም ለማስወገድfalseያድርጉት።
አስተያየት ማስወገድ በopen-sse/services/compression/engines/rtk/codeStripper.ts ውስጥ ተግባራዊ ተደርጓል። የጽሑፍ፣ የአብነት እና የመደበኛ አገላለጽ ሊተራሎች በስህተት እንደ
አስተያየት እንዳይወሰዱ የTypeScript ተንታኝን (መደበኛ አገላለጽን ሳይሆን) ይጠቀማል፤ እንዲሁም JSX ሲገኝ ሂደቱን ሙሉ በሙሉ ያቋርጣል (በዚህም በJSX የአገላለጽ ማስቀመጫዎች ውስጥ ያሉ አስተያየቶች
ፈጽሞ አይበላሹም)። በአሁኑ ጊዜ አስተያየት ማስወገድ የሚተገበረው በJavaScript እና TypeScript ላይ ብቻ ነው — በማስወገጃው CodeLanguage ስብስብ ውስጥ ያሉ ሌሎች
ቋንቋዎች (Python፣ Rust፣ Go፣ Ruby፣ Java) ባዶ መስመሮችን እና
ነጭ ቦታዎችን ማጣመር ይደረግባቸዋል፣ ነገር ግን አስተያየቶች አይወገዱም። የተወገደው ብሎክ ሂደት በrulesApplied ውስጥ rtk:code-strip የሚል መለያ ይሰጠዋል።
ማስታወሻ — GCF / ሰንጠረዣዊ ኢንኮዲንግ የተለየ ሞተር ነው። RTK የ"GCF" (Graph Compact Format) ሰንጠረዣዊ/አምዳዊ JSON ኢንኮደርን አያካትትም። ያ ኢንኮደር — የቀድሞውን
omni-tabularኢንኮደር የተካው — በheadroom ሞተር ውስጥ ይገኛል (open-sse/services/compression/engines/headroom/፣ አብሮ የተካተተው ኮዴክ ደግሞ በheadroom/gcf/ስር ይገኛል)። እዚህ ከተመዘገበው የRTK ማጣሪያ ሂደት ጋር ግንኙነት የለውም።
ውቅር
አጠቃላይ ቅንብሮች በ /api/settings/compression በኩል ይገኛሉ። ለ-RTK የተለዩ ቅንብሮችም
በ /api/context/rtk/config በኩል ይገኛሉ።
{
"defaultMode": "stacked",
"autoTriggerMode": "stacked",
"autoTriggerTokens": 32000,
"stackedPipeline": [
{ "engine": "rtk", "intensity": "standard" },
{ "engine": "caveman", "intensity": "full" }
],
"rtkConfig": {
"enabled": true,
"intensity": "standard",
"applyToToolResults": true,
"applyToCodeBlocks": false,
"applyToAssistantMessages": false,
"enabledFilters": [],
"disabledFilters": [],
"maxLinesPerResult": 120,
"maxCharsPerResult": 12000,
"deduplicateThreshold": 3,
"customFiltersEnabled": true,
"trustProjectFilters": false,
"rawOutputRetention": "never",
"rawOutputMaxBytes": 1048576,
"enableGrouping": false,
"groupingThreshold": 3,
"stripCodeComments": false,
"preserveDocstrings": true
}
}
enabledFilters እና disabledFilters እንደ test-vitest ወይም git-diff ያሉ የማጣሪያ መለያዎችን ይጠቀማሉ።
ሙሉው የ rtkConfig አወቃቀር በ
open-sse/services/compression/types.ts ውስጥ ባሉት RtkConfig / DEFAULT_RTK_CONFIG ይገለጻል። ሙሉው ኦብጀክት በ
SQLite key_value ሰንጠረዥ ውስጥ በ namespace = "compression"፣ key = "rtkConfig"
(src/lib/db/compression.ts) ስር እንደ አንድ JSON እሴት በቋሚነት ይቀመጣል፣ እና ሲነበብ በ normalizeRtkConfig ደረጃውን የጠበቀ ይደረጋል። ስለዚህ ከታች ያለው እያንዳንዱ መስክ
— enableGrouping፣ groupingThreshold፣ stripCodeComments እና preserveDocstringsን ጨምሮ —
በተመሳሳዩ ማከማቻ በኩል ተጽፎ እንደገና ይነበባል፣ እንዲሁም ዳግም ከተጀመረ በኋላም ይቆያል።
| ቁልፍ | ነባሪ | ዓላማ |
|---|---|---|
deduplicateThreshold |
3 |
በመላው ሞተሩ፦ ለማጠቃለል የሚያስፈልጉ በተከታታይ ያሉ ተመሳሳይ መስመሮች ዝቅተኛ ብዛት (በ2–100 የተገደበ) |
enableGrouping |
false |
በምርጫ የሚነቃ፦ በተከታታይ ያሉ በጣም ተመሳሳይ መስመሮችን ማጠቃለል |
groupingThreshold |
3 |
ማቧደንን የሚያስጀምር የተከታታይ ተመሳሳይ መስመሮች ዝቅተኛ ብዛት |
stripCodeComments |
false |
በምርጫ የሚነቃ፦ ከታጠሩ የኮድ ብሎኮች አስተያየቶችን ማስወገድ (applyToCodeBlocks ያስፈልገዋል) |
preserveDocstrings |
true |
አስተያየቶችን ሲያስወግድ፣ የJSDoc//** … */ ብሎኮችን ማቆየት |
API
| መስመር | ዘዴ | ዓላማ |
|---|---|---|
/api/context/rtk/config |
GET | የRTK ውቅርን ማንበብ |
/api/context/rtk/config |
PUT | የRTK ውቅርን ማዘመን |
/api/context/rtk/filters |
GET | የማጣሪያ ካታሎግን እና የመጫን ምርመራ መረጃን መዘርዘር |
/api/context/rtk/import |
POST | የRTK TOML schema v1 ፋይሎችን ማረጋገጥ ወይም መጫን |
/api/context/rtk/test |
POST | ለአንድ የጽሑፍ ውሂብ የRTK መጭመቅን ቅድመ ዕይታ ማሳየት |
/api/context/rtk/raw-output/[id] |
GET | ተይዞ የቆየ ስሱ መረጃው የተሸፈነ ጥሬ ውጤትን ማንበብ |
/api/compression/preview |
POST | ማንኛውንም የመጭመቅ ሁነታ ቅድመ ዕይታ ማሳየት |
የRTK ሙከራ ውሂብ፦
{
"command": "npm test",
"text": "FAIL tests/example.test.ts\nAssertionError: expected true\nTest Files 1 failed",
"config": {
"intensity": "standard"
}
}
የመጭመቅ ቅድመ ዕይታ ውሂብ፦
{
"mode": "stacked",
"messages": [
{
"role": "tool",
"content": "FAIL tests/example.test.ts\nAssertionError: expected true\nTest Files 1 failed"
}
],
"config": {
"rtkConfig": {
"rawOutputRetention": "failures"
}
}
}
የአስተዳደር መስመሮች የዳሽቦርድ አስተዳደር ማረጋገጫ ወይም ተዛማጅ የAPI ቁልፍ ፖሊሲ ያስፈልጋቸዋል።
የRTK TOML ማረጋገጫ ውሂብ፦
{
"action": "validate",
"content": "schema_version = 1\n\n[filters.my-tool]\nmatch_command = \"^my-tool\\\\b\"\nmax_lines = 20\n"
}
የተረጋገጠውን ፋይል በሁሉም ቦታ ለመጫን "action": "install"ን ይጠቀሙ። ነባር አጠቃላይ ፋይል መተካቱን
ከገመገሙና ካረጋገጡ በኋላ ብቻ "overwrite": trueን ያክሉ።
ጥሬ ውጤትን መልሶ ማግኘት
RTK በመደበኛነት የታመቀ ጽሑፍን ብቻ ይመልሳል። ለማረም፣ rawOutputRetention የተሸሸገ
ጥሬ ውጤትን ሊያቆይ ይችላል፦
| እሴት | ባህሪ |
|---|---|
never |
ጥሬ ውጤትን አታቆይ |
failures |
የመክሸፍ ዕድሉ ያለውን ውጤት ብቻ አቆይ |
always |
ከመሸሸግ በኋላ እያንዳንዱን የታመቀ የRTK ጥሬ ውጤት አቆይ |
የተቀመጡ ፋይሎች በሚከተለው ስር ይጻፋሉ፦
DATA_DIR/rtk/raw-output/
ሚስጥሮች በቋሚነት ከመቀመጣቸው በፊት ይሸሸጋሉ፤ ይህም የተለመዱ bearer tokens፣ API keys፣ Slack tokens፣
AWS access keys፣ እና በምደባ ቅርጽ የተጻፉ token=...፣ secret=...፣ password=... እሴቶችን ያካትታል። ትንታኔዎች
የማመሳከሪያ id፣ መጠን እና hash metadata ብቻ ያከማቻሉ።
የማረጋገጫ በር
የተመረጠው የማረጋገጫ በር ወደ ውጫዊ ትዕዛዞች ሳይወጣ አብረው የተካተቱ የinline filter ሙከራዎችን ያስኬዳል፦
node --import tsx/esm --test tests/unit/compression/rtk-verify.test.ts
ሰፋ ያለው የRTK በር፦
node --import tsx/esm --test \
tests/unit/compression/rtk-*.test.ts \
tests/unit/compression/pipeline-integration.test.ts \
tests/unit/compression/context-compression-api.test.ts
ከመልቀቅዎ በፊት ሰፊውን የማመቂያ በር ያስኪዱ፦
node --import tsx/esm --test \
tests/unit/compression/*.test.ts \
tests/golden-set/*.test.ts \
tests/integration/compression-pipeline.test.ts \
tests/unit/api/compression/compression-api.test.ts
RTKን ማስፋት
- የfilter JSON ፋይል ያክሉ ወይም ያዘምኑ።
- አስፈላጊውን ባህሪ የሚያረጋግጥ ቢያንስ አንድ
tests[]ናሙና ያካትቱ። - ለአዳዲስ የትዕዛዝ ቤተሰቦች በ
tests/unit/compression/fixtures/rtk/ስር fixture ያክሉ። - አዲስ የውጤት ምድብ ሲያስገቡ የትዕዛዝ ማወቂያ ሽፋን ያክሉ።
- የማረጋገጫውን እና ሰፊውን የRTK በሮች ያስኪዱ።
- filterው ለፕሮጀክቱ ብቻ የሚውል ከሆነ፣
.rtk/filters.jsonን commit ያድርጉ እና.rtk/trust.jsonን ከግምገማ በኋላ ብቻ ያድሱ።
የጥንካሬ ደረጃዎች (v3.8.16+)
RTK በማመቅ ጥብቅነት እና ደህንነት መካከል ሚዛን የሚጠብቁ 3 የጥንካሬ ደረጃዎችን ይደግፋል። ደረጃው በengine config ውስጥ ባለው config.intensity በኩል ይዘጋጃል።
3ቱ ደረጃዎች
| ደረጃ | የመቁረጫ ገደብ | የtoken ቁጠባ | አደጋ | በጣም የሚመችበት |
|---|---|---|---|---|
minimal |
በክፍል 24 መስመሮች | ~20-40% | በጣም ዝቅተኛ | ወሳኝ context ያለው production |
standard (ነባሪ) |
በክፍል 24 መስመሮች | ~50-70% | ዝቅተኛ | ዕለታዊ የኮድ አጻጻፍ sessions |
aggressive |
በክፍል 16 መስመሮች | ~70-90% | መካከለኛ | ረጅም sessions፣ ከፍተኛ ቁጠባ |
መቁረጡ የሚከሰትበት ቦታ
የመቁረጫ ገደቡ lineFilter.tsን ይነካል፦
// ከ open-sse/services/compression/engines/rtk/index.ts:329-330
config.intensity === "aggressive" ? 16 : 24,
config.intensity === "aggressive" ? 16 : 24,
የእያንዳንዱ ክፍል መጀመሪያ እና መጨረሻ ሁለቱም ይጠበቃሉ፤ መቁረጡ ሲጀምር መካከለኛው ይዘት ይወገዳል።
የሚቀረው እና የሚቆረጠው
| ይዘት | minimal | standard | aggressive |
|---|---|---|---|
| ስህተቶች / stack traces | ✅ ይጠበቃል | ✅ ይጠበቃል | ✅ ይጠበቃል |
| የሙከራ ውድቀቶች | ✅ ይጠበቃል | ✅ ይጠበቃል | ✅ ይጠበቃል |
| የbuild ስህተቶች | ✅ ይጠበቃል | ✅ ይጠበቃል | ✅ ይጠበቃል |
| የተሳኩ ሙከራዎች (ዝርዝር) | ✅ ይጠበቃል | 🟡 ይታመቃል | 🟡 ይታመቃል |
| መደበኛ ውጤት (info logs) | 🟡 ይታመቃል | 🟡 ይታመቃል | ❌ ይወገዳል |
| የሂደት አሞሌዎች | 🟡 ይታመቃል | ❌ ይወገዳል | ❌ ይወገዳል |
| Banner / ASCII art | 🟡 ይታመቃል | ❌ ይወገዳል | ❌ ይወገዳል |
ትክክለኛውን ጥንካሬ መምረጥ
contextን ማጣት አስከፊ ነው?
│
┌───────────┼───────────┐
│ │ │
አዎ አይ እርግጠኛ አይደለሁም
│ │ │
▼ │ │
minimal │ │
│ │ │
│ ▼ ▼
│ throughput መጀመሪያ `standard`ን
│ ምን ያህል ወሳኝ ነው? ይሞክሩ (ለ80%
│ │ ሁኔታዎች ይሰራል)
│ ┌────┴────┐
│ │ │
│ ዝቅተኛ ከፍተኛ
│ │ │
│ ▼ ▼
│ standard aggressive
│ │ │
└──────┴─────────┘
ጥንካሬን ማዋቀር
ለእያንዳንዱ combo (በcombo config ውስጥ)፦
{
"combo": "my-coding-combo",
"routing": {/* ... */},
"compression": {
"engine": "rtk",
"intensity": "aggressive"
}
}
በፕሮግራም፦
rtkEngine (@omniroute/open-sse/services/compression/engines/rtk)
CompressionEngine ነው እና updateConfig method የለውም። የengineውን config
በምትኩ በregistry helper በኩል ያዘምኑ፦
import { updateEngineConfig } from "@omniroute/open-sse/services/compression/engines/registry";
updateEngineConfig("rtk", { intensity: "aggressive" });
ውጤቱን ማረጋገጥ
filterዎ በመረጡት ጥንካሬ ደህንነቱ የተጠበቀ መሆኑን ለማረጋገጥ የማረጋገጫ በርን (ከታች ይመልከቱ) ይጠቀሙ፦
import { runRtkFilterTests } from "omniroute/compression/engines/rtk/verify";
const result = runRtkFilterTests({ intensity: "aggressive" });
if (!result.passed) {
console.error("Filters failed at aggressive intensity");
}
ብጁ ማጣሪያ ማበልጸግ (v3.8.16+)
የengines/rtk/filters/ ማውጫ 49+ አብሮገነብ የማጣሪያ JSON ፋይሎችን ይዟል። በነባሪዎቹ ያልተሸፈኑ ብጁ መሣሪያዎች ውጤትን ለመጭመቅ የራስዎን ማከል ይችላሉ።
የማጣሪያ መዋቅር (Zod)
{
"id": "string", // ያስፈልጋል። የማጣሪያ መለያ (kebab-case፣ ለምሳሌ፦ "python-traceback")
"label": "string", // ያስፈልጋል። ለሰው በቀላሉ የሚነበብ የማጣሪያ ስም
"description": "string", // አማራጭ (ነባሪ፦ "")። ማጣሪያው ምን እንደሚያደርግ አጭር መግለጫ
"category": "git|test|build|shell|docker|package|infra|cloud|generic",
"priority": number, // አማራጭ (0-100፣ ነባሪ፦ 50)። የአፈጻጸም ቅደም ተከተል (ከፍተኛው = መጀመሪያ)
"match": {
"commands": ["string"], // የሚዛመዱ የትዕዛዝ ስሞች (ለምሳሌ፦ "python"፣ "pytest")
"patterns": ["string"], // ከውጤት ጋር የሚዛመዱ የRegex ስርዓተ ጥለቶች
"outputTypes": ["string"] // የተገኙ የውጤት ክፍሎች (ለምሳሌ፦ "test-failure")
},
"rules": {
"stripAnsi": boolean, // አማራጭ (ነባሪ፦ false)። የANSI ቀለም ኮዶችን ያስወግዳል
"replace": [ // የፈልግና-ተካ ደንቦች (ነባሪ፦ [])
{ "pattern": "regex", "replacement": "..." }
],
"matchOutput": [ // ስርዓተ ጥለቱ ሲዛመድ ወዲያውኑ ያቋርጣል (ነባሪ፦ [])
{
"pattern": "regex",
"message": "short summary",
"unless": "regex" // ይህ ስርዓተ ጥለት ከተዛመደ ይዝለለዋል
}
],
"includePatterns": ["string"], // የሚቀመጡ መስመሮች (የRegex ስርዓተ ጥለቶች፣ ነባሪ፦ [])
"dropPatterns": ["string"], // የሚወገዱ መስመሮች (የRegex ስርዓተ ጥለቶች፣ ነባሪ፦ [])
"collapsePatterns": ["string"], // ወደ አንድ ጊዜ መከሰት የሚጠቃለሉ መስመሮች (ነባሪ፦ [])
"deduplicate": boolean, // አማራጭ (ነባሪ፦ false)። የተደጋገሙ መስመሮችን ያስወግዳል
"truncateLineAt": number, // አማራጭ (ነባሪ፦ 0)። መስመሮችን እስከ ከፍተኛው የቁምፊ ብዛት ይቆርጣል
"maxLines": number, // አማራጭ (ነባሪ፦ 0)። በጠቅላላ የመስመሮች ብዛት ላይ ጥብቅ ገደብ
"headLines": number, // አማራጭ (ነባሪ፦ 20)። ከተዛመደው ውጤት የመጀመሪያዎቹን N መስመሮች ያቆያል
"tailLines": number, // አማራጭ (ነባሪ፦ 20)። ከተዛመደው ውጤት የመጨረሻዎቹን N መስመሮች ያቆያል
"onEmpty": "string", // አማራጭ (ነባሪ፦ "")። ሁሉም መስመሮች ከተጣሩ የሚታይ ተተኪ መልዕክት
"filterStderr": boolean // አማራጭ (ነባሪ፦ false)። የstderr ውጤትንም ያጣራል
},
"preserve": {
"errorPatterns": ["string"], // ሁልጊዜ መቀመጥ ያለባቸው ስርዓተ ጥለቶች (ነባሪ፦ [])
"summaryPatterns": ["string"] // ለመጨረሻው የማጠቃለያ መስመር የሚያገለግሉ ስርዓተ ጥለቶች (ነባሪ፦ [])
},
"tests": [ // ለማረጋገጫ በውስጡ የተካተቱ ሙከራዎች (ነባሪ፦ [])
{
"name": "string", // ያስፈልጋል። የሙከራ ስም
"input": "sample output", // ያስፈልጋል። የናሙና ግቤት ጽሑፍ
"expected": "expected output", // ያስፈልጋል። የሚጠበቀው የተጨመቀ ውጤት
"command": "optional command" // አማራጭ። የትዕዛዝ አውድ
}
]
}
ምሳሌ፦ የPython Traceback ማጣሪያ
{
"id": "python-traceback",
"label": "Python Traceback Filter",
"description": "Compresses Python tracebacks to essential file/line locations and error type",
"category": "test",
"priority": 60,
"match": {
"commands": ["python", "python3", "pytest", "uv", "poetry"],
"patterns": ["Traceback \\(most recent call last\\)", "Error", "Exception"],
"outputTypes": ["error-traceback"]
},
"rules": {
"stripAnsi": true,
"includePatterns": [
"Traceback \\(most recent call last\\)",
"^\\s*File \".+\", line \\d+",
"^\\s*[A-Z][a-zA-Z]+Error:",
"^\\s*[A-Z][a-zA-Z]+Exception"
],
"dropPatterns": ["site-packages/", "^\\s+[a-z_]+\\([^)]*\\)$"],
"headLines": 5,
"tailLines": 3,
"maxLines": 25,
"filterStderr": true
},
"preserve": {
"errorPatterns": ["Error:", "Exception:", "Traceback"],
"summaryPatterns": ["^[A-Z][a-zA-Z]+(?:Error|Exception):"]
},
"tests": [
{
"name": "preserves-error-type-and-location",
"input": "Traceback (most recent call last):\n File \"app.py\", line 42, in main\n do_thing()\n File \"lib/utils.py\", line 17, in helper\n return 1 / 0\nZeroDivisionError: division by zero",
"expected": "Traceback (most recent call last):\n File \"app.py\", line 42, in main\n File \"lib/utils.py\", line 17, in helper\nZeroDivisionError: division by zero",
"command": "python app.py"
}
]
}
ብጁ ማጣሪያዎችን መጫን
ፋይሉን በታወቀ አካባቢ ያስቀምጡ፦
~/.omniroute/rtk/filters/my-filter.json # የተጠቃሚ ደረጃ
<project>/.rtk/filters/my-filter.json # የፕሮጀክት ደረጃ
ማጣሪያዎች ሲጀመር በopen-sse/services/compression/engines/rtk/filterLoader.ts ውስጥ ባለው loadRtkFilters() በኩል በራስ-ሰር ይጫናሉ። ጫኚው ማጣሪያዎችን ከሚከተሉት ቦታዎች ያገኛል፦
- አብሮገነብ ካታሎግ፦
open-sse/services/compression/engines/rtk/filters/ - የተጠቃሚ ማውጫ፦
~/.omniroute/rtk/filters/ - የፕሮጀክት ማውጫ፦
<project>/.rtk/filters/
ማጣሪያዎችን በፕሮግራም ለመጫን፦
import { loadRtkFilters } from "@omniroute/open-sse/services/compression/engines/rtk/filterLoader";
// አማራጮች፦ customFiltersEnabled (የተጠቃሚ/ፕሮጀክት ማጣሪያዎችን ይጫናል፣ በነባሪ ክፍት ነው)፣
// trustProjectFilters፣ refresh።
const filters = loadRtkFilters({ customFiltersEnabled: true });
ማረጋገጫ
ማጣሪያዎች በሚጫኑበት ጊዜ ከZod መዋቅር ጋር እንዲጣጣሙ ይረጋገጣሉ። መዋቅሩ የተሳሳተ ማጣሪያ መጫን ይሳነዋል እና ስህተት ይመዘገባል፦
RTK_FILTER_LOADER: የ"my-filter" ማጣሪያ ማረጋገጫውን አላለፈም፦
- rules.replace.0.pattern: ልክ ያልሆነ regex
- match.commands: ባዶ መሆን የለበትም
ሁሉንም የተጫኑ ማጣሪያዎች ለማረጋገጥ፣ ከopen-sse/services/compression/engines/rtk/verify.ts የሚላከውን runRtkFilterTests() ይጥሩ።
ምርጥ ልምዶች
- ሁልጊዜ
tests[]ን ያካትቱ — ማጣሪያዎ እንደሚሠራ ያረጋግጣሉ፣ የቀድሞ ችግሮች ዳግም እንዳይከሰቱም ይከላከላሉ - ለአጭር ማቋረጫዎች
matchOutputን ይጠቀሙ — አንድ መስመር ብቻ ሁኔታውን በቂ ሁኔታ የሚገልጽ ከሆነ፣ ሙሉውን ብሎክ ይተኩ - ከ
stripይልቅkeepን ይምረጡ — ግልጽ የሆኑ “ሁልጊዜ አቆይ” ደንቦች ከ“ሁልጊዜ አስወግድ” ደንቦች የበለጠ ደኅንነታቸው የተጠበቀ ነው - በሁሉም 3 የጥንካሬ ደረጃዎች ይፈትሹ —
minimalምንም ለውጥ ማድረግ የለበትም፤aggressiveም አሁንም ስህተቶችን መጠበቅ አለበት - የ
unlessመስኩን ይጠቀሙ — አጭር ማቋረጫዎችን “X ካለ እንዳይነሳሱ” በሚል ቅድመ ሁኔታ ይጠብቁ
ጥሬ ውጤትን መልሶ ማግኘት እና የማረጋገጫ በር
RTK ውጤትን በከፍተኛ ደረጃ ሲጨምቅ፣ ለማረም፣ ለኦዲት ወይም እንደገና ለማጫወት ዋናውን ጽሑፍ መልሰው ማግኘት ይችላሉ።
ጥሬ ውጤትን መልሶ ማግኘት እንዴት እንደሚሠራ
ዋናው ውጤት (10K ቶከኖች)
│
▼
RTK መጭመቅ (rawOutput.enabled=true በማድረግ)
│
├─▶ የተጨመቀ ውጤት (2K ቶከኖች) ──▶ ወደ LLM
│
└─▶ ዋናው ውጤት (10K ቶከኖች) ──▶ በDB ውስጥ ይከማቻል
(በrequest_id የተገናኘ)
ጥሬ ውጤት ማከማቻን ማንቃት
በእያንዳንዱ ጥያቄ (በcombo ውቅር ውስጥ)፦
{
"compression": {
"engine": "rtk",
"intensity": "aggressive",
"rawOutput": {
"enabled": true,
"maxBytes": 1048576 // የ1MB ገደብ
}
}
}
ነባሪ፦ rawOutput.enabled: false (የማከማቻ ቦታን ይቆጥባል)።
የማከማቻ ወጪ
| በእያንዳንዱ ጥያቄ | የ1MB ገደብ | የ10MB ገደብ |
|---|---|---|
| አማካይ የተጨመቀ ውጤት | ~5KB | ~5KB |
| የተከማቸ ጥሬ ውጤት | ~50-500KB | ~500KB-5MB |
| በቀን 1000 ጥያቄዎች ሲኖሩ | 50-500MB/ቀን | 500MB-5GB/ቀን |
ምክር፦ ጥሬ ውጤትን ሁልጊዜ ከማንቃት ይልቅ ለማረሚያ ክፍለ ጊዜዎች ወይም በናሙና ለሚደረግ ኦዲት ብቻ ያንቁት።
ዋናውን ውጤት መልሶ ማግኘት
import { readRtkRawOutput } from "omniroute/compression/engines/rtk/rawOutput";
const raw = readRtkRawOutput(pointerId); // ከመጭመቂያ ስታቲስቲክስ የተገኘ pointerId
if (raw) {
console.log("Original output:", raw);
}
pointerId ከመጭመቅ በኋላ በCompressionStats.rtkRawOutputPointers[] ውስጥ ይመለሳል።
ለፈንክሽኑ ፊርማ open-sse/services/compression/engines/rtk/rawOutput.ts:102ን ይመልከቱ።
የማረጋገጫ በር
የRTK ማጣሪያ ማረጋገጫ (open-sse/services/compression/engines/rtk/verify.ts) ሁሉንም ማጣሪያዎች በtests[] ላይ በመመርኮዝ ያረጋግጣል፣ እንዲሁም ባህሪያቸው በሁሉም 3 የጥንካሬ ደረጃዎች ትክክለኛ መሆኑን ያረጋግጣል።
ማረጋገጫውን ለማስኬድ runRtkFilterTests()ን ይጥሩ፦
import { runRtkFilterTests } from "open-sse/services/compression/engines/rtk/verify";
const result = runRtkFilterTests();
console.log(`Passed: ${result.outcomes.filter((o) => o.passed).length}`);
console.log(`Failed: ${result.outcomes.filter((o) => !o.passed).length}`);
if (!result.passed) {
console.error("Filters failed verification");
result.outcomes
.filter((o) => !o.passed)
.forEach((o) => {
console.error(
` - ${o.filterId} / ${o.testName}: expected "${o.expected}", got "${o.actual}"`
);
});
}
የሚያረጋግጣቸው ነገሮች፦
- እያንዳንዱ ማጣሪያ ይጫናል እና የschema ማረጋገጫውን ያልፋል
- እያንዳንዱ የ
tests[]ግቤት የሚጠበቀውን ውጤት ያመነጫል - የ
minimalጥንካሬ ምንም ለውጥ አያደርግም (ዋናውን ይጠብቃል፣ መዋቅራዊ ማጣሪያዎችን ብቻ ይተገብራል) - የ
aggressiveጥንካሬ ስህተቶችን፣ ያልተሳኩ ሙከራዎችን እና የstack traceዎችን ይጠብቃል - የተጨመቀው ውጤት ከዋናው ግብዓት ፈጽሞ አይበልጥም
ምንጭ፦
open-sse/services/compression/engines/rtk/(63 ፋይሎች፣ ~70KB)የማጣሪያ ለውጥን ከማዋሃድዎ በፊት — ሙከራዎቹ ሁልጊዜ ማለፋቸውን ያረጋግጡ
የRTK engineን ካሻሻሉ በኋላ — schemaው ተለውጦ ሊሆን ይችላል
በክትትል ወቅት በየጊዜው — በሙከራ መሣሪያዎች ላይ ከሚከሰት መዛባት ይከላከላል
አዲስ የመሣሪያ/ትዕዛዝ ቤተሰብ ሲጨምሩ — አዲሱ ማጣሪያ እንደሚሠራ ያረጋግጣል
በተጨማሪ ይመልከቱ
- COMPRESSION_GUIDE.md — የሙሉ የማመቅ ሂደት አጠቃላይ እይታ
- COMPRESSION_ENGINES.md — የኤንጂን መዝገብ እና አብረው የተካተቱ ኤንጂኖች
- EXTENDING_COMPRESSION.md — ብጁ ኤንጂኖች፣ የቋንቋ ጥቅሎች፣ በተደራረቡ የሂደት መስመሮች
- ምንጭ፦
open-sse/services/compression/engines/rtk/(63 ፋይሎች፣ ~70KB)