Boopy Context Engine

Lokálna inteligencia projektu pre GitHub Copilot v VS Code

Rozšírenie pre VS Code, ktoré projekt indexuje na pozadí, drží kompaktnú mapu projektu a Copilotu v agentnom režime dáva šesť lokálnych nástrojov na zisťovanie kontextu. Menej tokenov na „prečítam si celý repozitár“, viac na samotnú úlohu.

VS CodeCopilot AgentLokálneZverejnený kód

Zdrojový kód na GitHube → Späť na software

Verzia0.1.8

LicenciaMIT + Commons Clause

PlatformaVS Code 1.99+ (Copilot Agent mode)

StavVerejné na GitHube

Čo to je

BCE nepostaví vlastného asistenta a nezasahuje do chatu ani do agentnej slučky Copilotu — je to doplnkový poskytovateľ nástrojov (Language Model Tools). Copilot sa sám rozhodne, kedy ich zavolá; v prompte ich viete aj priamo menovať, napríklad #bceFindContext.

Indexovanie, parsovanie, zoraďovanie aj cache bežia v extension hoste. V kóde nie je žiadne volanie siete a nikde sa neposiela telemetria — zdrojový kód projektu neopúšťa počítač.

Kľúčové vlastnosti

Beží celý lokálne

Indexovanie, parsovanie, zoraďovanie aj cache sú v extension hoste. Žiadne volanie siete, žiadna telemetria, zdrojový kód neopúšťa počítač.

Šetrí kontext, nie kroky

Namiesto „prečítam všetko“ dostane model zoradené nálezy s presnými riadkami. Rozpočet odhadovaných tokenov na jednu odpoveď je nastaviteľný (predvolene 4000).

Povie, kde si nie je istý

Výsledky parsera sú označené ako exact alebo heuristic a každé číslo tokenov je výslovne označené ako odhad. Nástroj nepredstiera presnosť, ktorú nemá.

Nevracia tajomstvá

Bezpečnostné bloky sa nedajú prepnúť konfiguráciou: .env, kľúče, certifikáty, credential súbory, binárky ani veľké súbory sa neindexujú a nástroj ich nevráti.

Vidí aj neuložené zmeny

Ak má súbor neuložené zmeny, číta sa buffer editora — model teda nevidí kód o 50 úprav starší. Neuložený text sa nikdy nezapisuje do indexu.

Ovládateľný a merateľný

Trinásť príkazov od analýzy projektu po lokálny benchmark, diagnostika s počítadlami a možnosť pozastaviť indexovanie na pozadí.

Nástroje, ktoré dáva Copilotu

Každý nástroj má v popise napísané, kedy ho má agent použiť a kedy nie.

Nástroj	Na čo slúži	Použi, keď
`bce_get_project_overview`	Kompaktná mapa projektu: jazyky, frameworky, vstupné body, moduly, databázové objekty, routy, testy a konfigurácia.	Keď je projekt nový alebo sa úloha dotýka viacerých modulov.
`bce_find_context`	Zoradené a deduplikované nálezy s dôvodom, presnou adresou path:line, krátkymi ukážkami a odhadom spotreby tokenov.	Keď hľadáte zodpovedný kód, tabuľku, endpoint alebo symbol.
`bce_get_file_context`	Jeden symbol alebo jeden rozsah riadkov vrátane importov, závislostí a súvisiacich testov.	Keď súbor poznáte a potrebujete z neho jednu konkrétnu časť.
`bce_explain_impact`	Čo závisí od daného symbolu alebo súboru — oddelene overené referencie a heuristické odhady.	Pred refaktoringom, premenovaním alebo mazaním kódu.
`bce_get_related_tests`	Testy previazané konvenciou, importom alebo použitím, plus konfigurácia testovacieho runnera.	Pred písaním testov a po zmene správania.
`bce_get_status`	Čerstvosť indexu, počty súborov, stav cache a posledné chyby.	Keď výsledky pôsobia neúplne alebo zastarano.

Príkazy v palete

Všetko, čo sa inak deje na pozadí, sa dá ovládať aj ručne z palety príkazov.

BCE: Analyze Project — plný sken projektu s priebehom a možnosťou zrušiť ho
BCE: Rebuild Index — zahodí obe vrstvy cache a parsuje všetko odznova
BCE: Show Project Map — otvorí čitateľnú mapu projektu (len na čítanie)
BCE: Search Context — rýchly výber z nálezov, otvorí súbor na najlepšom riadku
BCE: Show Diagnostics — počítadlá, časovania, používanie nástrojov, posledné udalosti
BCE: Clear Cache — vyprázdni parse cache a context cache (index zostáva)
BCE: Show Usage Report — súhrn z lokálneho logu: koľko odhadovaných tokenov nástroje vrátili a koľko by stála naivná alternatíva
BCE: Reset Usage Log — po potvrdení vymaže lokálny log používania
BCE: Pause Background Indexing / Resume — udalosti o súboroch sa zaraďujú do fronty
BCE: Cancel Indexing — zruší bežiaci priechod, posledný platný index zostáva
BCE: Ensure BCE Output Is Git-Ignored — znovu aplikuje spravovaný blok v .gitignore
BCE: Run Local Benchmark — zmeria kvalitu zoraďovania a veľkosť kontextu

Inštalácia

Zdrojový kód a kontrola

Repozitár je verejný. Kontrola pozostáva z typovej kontroly, testov a bundlu.

git clone https://github.com/BoopyCode/BoopyContextEngine.git
cd BoopyContextEngine
npm install
npm run check

Vývojový host (najrýchlejšie)

Otvoríte priečinok vo VS Code a stlačíte F5. Otvorí sa druhé okno s načítaným BCE — v ňom otvorte ľubovoľný projekt.

Inštalácia do VS Code

Zbuildujte balík a skopírujte priečinok medzi rozšírenia. Po reštarte VS Code sa v stavovom riadku objaví „bce: Indexing“ a potom „bce: Ready (n files)“.

npm run vscode:prepublish
# priečinok skopírujte sem (alebo nainštalujte .vsix z npx @vscode/vsce package):
# %USERPROFILE%\.vscode\extensions\boopycode.boopy-context-engine-0.1.4

Požiadavky

VS Code 1.99 alebo novší (Language Model Tool API)
Node 18+ na build zo zdrojov
Jediná runtime závislosť: ignore (bundlovaná v balíku)
Licencia MIT s Commons Clause — komerčné použitie len s písomnou licenciou

Čo nástroj nevie

Kvalitu odpovedí, počet krokov agenta ani fakturovanú spotrebu API rozšírenie nezmeria — nemá na ne prístup. Lokálny benchmark preto meria len to, čo sa zmerať dá: či sa našli správne súbory a koľko odhadovaných tokenov to stálo.

Referenčný beh na 27-súborovom fixture: úspešnosť zásahu 100 %, priemerná pozícia prvého správneho nálezu 1,4 a približne o 60 % menší kontext než naivné prečítanie kandidátskych súborov. Dokumentácia výslovne hovorí, že tento pomer sa nedá zovšeobecniť — čísla si overíte vlastným benchmarkom (BCE: Run Local Benchmark).

Licencia

Zdrojový kód je zverejnený pod licenciou MIT s dodatkom Commons Clause. Osobné, vzdelávacie, výskumné, hobby aj nekomerčné open source použitie je bezplatné.

Komerčné použitie — nasadenie vo firme, hosting ako služba, zabudovanie do plateného produktu alebo platená integrácia a podpora — vyžaduje samostatnú písomnú komerčnú licenciu od BoopyCode. Bez nej licencia komerčné použitie neudeľuje.

Pri porušení podmienok sa všetky práva automaticky ukončujú a každá kópia musí obsahovať celé znenie licencie vrátane Commons Clause.

Úplné znenie licencie (LICENSE v repozitári) ↗

Odkazy

Chcete podobný nástroj alebo integráciu Copilota do vašich procesov? →

Odpovieme do 24 hodín. Nezáväzne, bez poplatku.