Skip to content

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

46.4 KB
Raw Blame

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 ማጣሪያዎችን በዚህ ቅደም ተከተል ይጭናል፦

  1. የፕሮጀክት ማጣሪያዎች ከ.rtk/filters.toml እና .rtk/filters.json፣ የታመኑ ሲሆኑ ብቻ።
  2. ዓለም አቀፍ ማጣሪያዎች ከDATA_DIR/rtk/filters.toml እና DATA_DIR/rtk/filters.json።
  3. አብሮገነብ ማጣሪያዎች ከopen-sse/services/compression/engines/rtk/filters/።

በተመሳሳይ ወሰን ውስጥ፣ የRTK TOML schema v1 ማጣሪያዎች ከOmniRoute JSON ማጣሪያዎች ቅድሚያ ያገኛሉ። ከውጭ የመጣ ትዕዛዝ-ተኮር ማጣሪያ በዚያ ወሰን ውስጥ ያለን ይበልጥ ሰፊ ማጣሪያ እንዲተካ፣ የTOML match_command አገላለጾች ከትዕዛዝ-ዓይነት ማዛመድ በፊት ይፈተሻሉ። የፕሮጀክት ወሰን የፋይል ቅርጸቱ ምንም ይሁን ምን ከዓለም አቀፍ ወሰን ቅድሚያ ያገኛል።

የregex ማጣሪያዎች የመሣሪያ ውጤት ለወኪሎች የሚታይበትን መንገድ ሊቀይሩ ስለሚችሉ፣ የፕሮጀክት ማጣሪያዎች ሆን ተብሎ በእምነት ማረጋገጫ ተገድበዋል። ከእነዚህ አንዱ እውነት ሲሆን የፕሮጀክት ማጣሪያ ፋይል ተቀባይነት ያገኛል፦

  • rtkConfig.trustProjectFilters true ነው።
  • 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 የተደጋገሙ መስመሮችን በሁለት እርስ በርሳቸው ነጻ በሆኑ ደረጃዎች ያጣምራል፦

  1. በእያንዳንዱ ማጣሪያ deduplicate (በምርጫ የሚነቃ፣ ነባሪው false)። አንድ ማጣሪያ rules.deduplicate: true በማዘጋጀት፣ ከመቆረጡ በፊት ከዚያ ማጣሪያ ጋር በተዛመደው ውጤት ውስጥ ያሉ ተከታታይ የተባዙ መስመሮችን ማጣመር ይችላል። ይህ በlineFilter.ts ውስጥ ይከናወናል። ለቀድሞ ማጣሪያዎች፣ ማጣሪያው collapsePatterns ን ሲገልጽ በራስ-ሰር ይነቃል። መርሃግብር፦ deduplicate: z.boolean().default(false) በ open-sse/services/compression/engines/rtk/filterSchema.ts ውስጥ።
  2. የመተግበሪያ ሞተሩ አጠቃላይ 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ን ማስፋት

  1. የfilter JSON ፋይል ያክሉ ወይም ያዘምኑ።
  2. አስፈላጊውን ባህሪ የሚያረጋግጥ ቢያንስ አንድ tests[] ናሙና ያካትቱ።
  3. ለአዳዲስ የትዕዛዝ ቤተሰቦች በtests/unit/compression/fixtures/rtk/ ስር fixture ያክሉ።
  4. አዲስ የውጤት ምድብ ሲያስገቡ የትዕዛዝ ማወቂያ ሽፋን ያክሉ።
  5. የማረጋገጫውን እና ሰፊውን የRTK በሮች ያስኪዱ።
  6. 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() ይጥሩ።

ምርጥ ልምዶች

  1. ሁልጊዜ tests[]ን ያካትቱ — ማጣሪያዎ እንደሚሠራ ያረጋግጣሉ፣ የቀድሞ ችግሮች ዳግም እንዳይከሰቱም ይከላከላሉ
  2. ለአጭር ማቋረጫዎች matchOutputን ይጠቀሙ — አንድ መስመር ብቻ ሁኔታውን በቂ ሁኔታ የሚገልጽ ከሆነ፣ ሙሉውን ብሎክ ይተኩ
  3. ከstrip ይልቅ keepን ይምረጡ — ግልጽ የሆኑ “ሁልጊዜ አቆይ” ደንቦች ከ“ሁልጊዜ አስወግድ” ደንቦች የበለጠ ደኅንነታቸው የተጠበቀ ነው
  4. በሁሉም 3 የጥንካሬ ደረጃዎች ይፈትሹ — minimal ምንም ለውጥ ማድረግ የለበትም፤ aggressiveም አሁንም ስህተቶችን መጠበቅ አለበት
  5. የ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}"`
      );
    });
}

የሚያረጋግጣቸው ነገሮች፦

  1. እያንዳንዱ ማጣሪያ ይጫናል እና የschema ማረጋገጫውን ያልፋል
  2. እያንዳንዱ የtests[] ግቤት የሚጠበቀውን ውጤት ያመነጫል
  3. የminimal ጥንካሬ ምንም ለውጥ አያደርግም (ዋናውን ይጠብቃል፣ መዋቅራዊ ማጣሪያዎችን ብቻ ይተገብራል)
  4. የaggressive ጥንካሬ ስህተቶችን፣ ያልተሳኩ ሙከራዎችን እና የstack traceዎችን ይጠብቃል
  5. የተጨመቀው ውጤት ከዋናው ግብዓት ፈጽሞ አይበልጥም
  • ምንጭ፦ 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)