Boopy Context Engine
Lokální inteligence projektu pro GitHub Copilot ve VS Code
Rozšíření pro VS Code, které projekt indexuje na pozadí, drží kompaktní mapu projektu a Copilotu v agentním režimu dává šest lokálních nástrojů pro zjišťování kontextu. Méně tokenů na „přečtu si celý repozitář“, více na samotný úkol.
Co to je
BCE nestaví vlastního asistenta a nezasahuje do chatu ani do agentní smyčky Copilotu — je to doplňkový poskytovatel nástrojů (Language Model Tools). Copilot se sám rozhodne, kdy je zavolá; v promptu je můžete i přímo pojmenovat, například #bceFindContext.
Indexování, parsování, řazení i cache běží v extension hostu. V kódu není žádné volání sítě a nikde se neposílá telemetrie — zdrojový kód projektu neopouští počítač.
Klíčové vlastnosti
Běží celý lokálně
Indexování, parsování, řazení i cache jsou v extension hostu. Žádné volání sítě, žádná telemetrie, zdrojový kód neopouští počítač.
Šetří kontext, ne kroky
Místo „přečtu všechno“ dostane model seřazené nálezy s přesnými řádky. Rozpočet odhadovaných tokenů na jednu odpověď je nastavitelný (ve výchozím stavu 4000).
Řekne, kde si není jistý
Výsledky parseru jsou označené jako exact nebo heuristic a každé číslo tokenů je výslovně označeno jako odhad. Nástroj nepředstírá přesnost, kterou nemá.
Nevrací tajemství
Bezpečnostní bloky se nedají přepnout konfigurací: .env, klíče, certifikáty, credential soubory, binárky ani velké soubory se neindexují a nástroj je nevrátí.
Vidí i neuložené změny
Pokud má soubor neuložené změny, čte se buffer editoru — model tedy nevidí kód o 50 úprav starší. Neuložený text se nikdy nezapisuje do indexu.
Ovladatelný a měřitelný
Třináct příkazů od analýzy projektu po lokální benchmark, diagnostika s počítadly a možnost pozastavit indexování na pozadí.
Nástroje, které dává Copilotu
Každý nástroj má v popisu uvedeno, kdy ho má agent použít a kdy ne.
| Nástroj | K čemu slouží | Použij, když |
|---|---|---|
bce_get_project_overview |
Kompaktní mapa projektu: jazyky, frameworky, vstupní body, moduly, databázové objekty, routy, testy a konfigurace. | Když je projekt nový nebo se úkol dotýká více modulů. |
bce_find_context |
Seřazené a deduplikované nálezy s důvodem, přesnou adresou path:line, krátkými ukázkami a odhadem spotřeby tokenů. | Když hledáte odpovědný kód, tabulku, endpoint nebo symbol. |
bce_get_file_context |
Jeden symbol nebo jeden rozsah řádků včetně importů, závislostí a souvisejících testů. | Když soubor znáte a potřebujete z něj jednu konkrétní část. |
bce_explain_impact |
Co závisí na daném symbolu nebo souboru — odděleně ověřené reference a heuristické odhady. | Před refaktoringem, přejmenováním nebo mazáním kódu. |
bce_get_related_tests |
Testy provázané konvencí, importem nebo použitím, plus konfigurace testovacího runneru. | Před psaním testů a po změně chování. |
bce_get_status |
Čerstvost indexu, počty souborů, stav cache a poslední chyby. | Když výsledky působí neúplně nebo zastarale. |
Příkazy v paletě
Vše, co jinak běží na pozadí, lze ovládat i ručně z palety příkazů.
- BCE: Analyze Project — plný sken projektu s průběhem a možností zrušení
- BCE: Rebuild Index — zahodí obě vrstvy cache a parsuje vše od začátku
- BCE: Show Project Map — otevře čitelnou mapu projektu (jen pro čtení)
- BCE: Search Context — rychlý výběr z nálezů, otevře soubor na nejlepším řádku
- BCE: Show Diagnostics — počítadla, časování, používání nástrojů, poslední události
- BCE: Clear Cache — vyprázdní parse cache a context cache (index zůstává)
- BCE: Show Usage Report — souhrn z lokálního logu: kolik odhadovaných tokenů nástroje vrátily a kolik by stála naivní alternativa
- BCE: Reset Usage Log — po potvrzení smaže lokální log použití
- BCE: Pause Background Indexing / Resume — události o souborech se zařazují do fronty
- BCE: Cancel Indexing — zruší běžící průchod, poslední platný index zůstává
- BCE: Ensure BCE Output Is Git-Ignored — znovu aplikuje spravovaný blok v .gitignore
- BCE: Run Local Benchmark — změří kvalitu řazení a velikost kontextu
Instalace
Zdrojový kód a kontrola
Repozitář je veřejný. Kontrola obsahuje typovou kontrolu, testy a bundle.
git clone https://github.com/BoopyCode/BoopyContextEngine.git
cd BoopyContextEngine
npm install
npm run checkVývojový host (nejrychlejší)
Otevřete složku ve VS Code a stiskněte F5. Otevře se druhé okno s načteným BCE — v něm otevřete libovolný projekt.
Instalace do VS Code
Sestavte balík a zkopírujte složku mezi rozšíření. Po restartu VS Code se ve stavovém řádku objeví „bce: Indexing“ a poté „bce: Ready (n files)“.
npm run vscode:prepublish
# složku zkopírujte sem (nebo nainstalujte .vsix z npx @vscode/vsce package):
# %USERPROFILE%\.vscode\extensions\boopycode.boopy-context-engine-0.1.4Požadavky
- VS Code 1.99 nebo novější (Language Model Tool API)
- Node 18+ pro build ze zdrojů
- Jediná runtime závislost: ignore (bundlovaná v balíku)
- Licence MIT s Commons Clause — komerční použití jen s písemnou licencí
Co nástroj neumí
Kvalitu odpovědí, počet kroků agenta ani fakturovanou spotřebu API rozšíření nezměří — nemá k nim přístup. Lokální benchmark proto měří jen to, co změřit lze: zda se našly správné soubory a kolik odhadovaných tokenů to stálo.
Referenční běh na 27-souborovém fixture: úspěšnost zásahu 100 %, průměrná pozice prvního správného nálezu 1,4 a přibližně o 60 % menší kontext než naivní přečtení kandidátských souborů. Dokumentace výslovně uvádí, že tento poměr nelze zobecnit — čísla si ověřte vlastním benchmarkem (BCE: Run Local Benchmark).
Licence
Zdrojový kód je zveřejněn pod licencí MIT s dodatkem Commons Clause. Osobní, vzdělávací, výzkumné, hobby i nekomerční open source použití je zdarma.
Komerční použití — nasazení ve firmě, hosting jako služba, zabudování do placeného produktu nebo placená integrace a podpora — vyžaduje samostatnou písemnou komerční licenci od BoopyCode. Bez ní licence komerční užití neuděluje.
Při porušení podmínek se všechna práva automaticky ukončují a každá kopie musí obsahovat celé znění licence včetně Commons Clause.
Odkazy
Odpovídáme do 24 hodin. Nezávazně, bez poplatku.