DADERA
DEENPL
AICB · AIContextBuilder

Aby narzędzia AI naprawdę rozumiały Państwa kod C#.

AICB (AIContextBuilder) analizuje rozwiązanie .NET za pomocą Roslyn – tak, jak widzi je kompilator – i udostępnia wynik agentom programistycznym oraz modelom językowym.

Co robi AICBPobieranie i dokumentacja
Z praktyki

Powstało z mojej własnej pracy.

Stworzyłem AICB na potrzeby własnej codziennej pracy – w tym dodatków do SAP Business One, interfejsów, integracji EDI i oprogramowania na zamówienie. Dla SAP Business One zawiera więc odpowiednie ustawienia wstępne: dla warstw, przestrzeni nazw i typowych pułapek DI API. Pozostaje przy tym ogólnym narzędziem dla .NET.

AICB nie ma połączenia z SAP Business One i go nie nawiązuje. Czyta kod C#, a dodatek to projekt C# jak każdy inny. Warunkiem jest format projektu SDK. Szczegóły ustawień wstępnych opisano przy aplikacji na pulpit.

Semantyczna analiza kodu

Powiązania zamiast fragmentów tekstu.

Wyszukiwanie tekstowe znajduje ciągi znaków. AICB nie zbiera po prostu plików ani trafień, lecz za pomocą Roslyn analizuje, jak Państwa kod C# rzeczywiście jest powiązany – tak, jak widzi go kompilator.

  • Symbole
  • Referencje
  • Implementacje
  • Nadpisania
  • Łańcuchy wywołań
  • Zależności
  • Wstrzykiwanie zależności
  • Testy
  • Efekty uboczne
  • Powiązania XAML

Kto to wywołuje?

Wyszukiwanie tekstowe znajdzie nazwę. Nie znajdzie wywołań, które prowadzą przez interfejs lub klasę bazową.

Co się zepsuje po zmianie?

Bezpośrednie trafienia rzadko są problemem. AICB wskazuje także wywołujących tych wywołujących.

Co jest zbędne?

Martwy kod, cykle zależności i nieużywane rejestracje nie są zapisane nigdzie w kodzie. Wynikają dopiero z całego obrazu.

Gdy AICB czegoś nie wie na pewno, mówi o tym: odpowiedź odróżnia „brak wywołujących” od „wywołujący nieznani” i pokazuje, czy wartość pochodzi z kodu, z AI Tagu czy z oszacowania.

Jeden rdzeń, dwie drogi

Co robi AICB

AICB wczytuje rozwiązanie raz i rozumie je jako całość: typy, wywołania, zależności, testy. Z tej analizy korzystają Państwo na dwa sposoby – zależnie od tego, czy pyta agent, czy wybierają Państwo sami.

Dla agentów AI

Serwer MCP i wiersz poleceń

Agenci AI pytają AICB bezpośrednio o symbole, wywołania i skutki zmian – zamiast przeszukiwać kod źródłowy. Pojedyncze pytania można zadać także bez agenta, w wierszu poleceń.

Przetestowany z Claude Code, Codex i OpenCode

Do serwera MCP →
Do własnego wyboru

Aplikacja na pulpit

Aplikacja dla systemu Windows, w której decydują Państwo, które części rozwiązania trafiają do dokumentu kontekstowego dla modelu językowego i jak szczegółowo – w sposób przejrzysty i powtarzalny.

Do aplikacji na pulpit →

Jak to działa – w obu przypadkach

  • Otwarcie rozwiązania
  • Analiza przez Roslyn
  • Wybór lub pytanie
  • Dokument kontekstowy albo odpowiedź

Obie drogi korzystają z jednej analizy i jednej konfiguracji. To, co ustawią Państwo w aplikacji na pulpit, obowiązuje także serwer MCP – i odwrotnie.

Zastosowania

Do trudnych pytań.

AICB nie powstało do szybkich pojedynczych pytań, lecz do zadań, w których decydują powiązania rozciągające się na wiele plików.

  • Analiza wpływu

    Zanim cokolwiek się zmieni: kto używa symbolu, bezpośrednio i na kilku poziomach, które testy go zabezpieczają i czego kompilator nie zgłosi.

  • Refaktoryzacja

    Warstwy, cykle zależności, sprzężenie i złożoność – a potem przegląd z oceną, łącznie ze zmianami publicznego API.

  • Debugowanie

    Głębokie łańcuchy wywołań, droga od jednej metody do drugiej, efekty uboczne, takie jak dostęp do plików lub sieci, oraz typowe pułapki async.

  • Zrozumienie dużych baz kodu

    Przegląd architektury, punkty wejścia i rola każdego typu – przy wdrażaniu się w obce lub rozrastające się latami rozwiązanie.

  • Testy i pokrycie

    Które testy pokrywają symbol, gdzie brakuje pokrycia i gdzie złożony kod nie jest przetestowany.

  • Jakość kodu

    Martwy kod, słabości projektowe, wywołania zewnętrznych bibliotek i diagnostyka kompilatora bez pełnej kompilacji.

Kontekst pod kontrolą

Tyle kontekstu, ile potrzeba – nie tyle, ile się da.

Kontekst nie jest z góry ustalony. To Państwo decydują, jaki kod i jakie powiązania do niego trafiają – aby model dostał to, co istotne, a nie po prostu wszystko.

  • Konfigurowalne powiązania

    Wywołujący, wywoływane metody, użycia, dziedziczenie, implementacje interfejsów, wstrzykiwane zależności, tworzone i używane typy, testy – każde włączane osobno, z regulowaną głębokością rozszerzania. Typy frameworka, kod generowany czy klasy testowe można pominąć.

  • Kontrolowany rozmiar

    Budżet tokenów, poziom szczegółowości każdego węzła od samej sygnatury po pełny kod źródłowy, adaptacyjna redukcja i oszacowanie rozmiaru dokumentu, zanim cokolwiek trafi do modelu.

  • Profile dopasowane do zadania

    Dołączone szablony łączą strategię kontekstu: General na co dzień, Refactoring z architekturą, warstwami i metrykami jakości, Debugging z głębokimi łańcuchami wywołań, pełną szczegółowością i numerami wierszy. Do tego szablony do pracy nad funkcjami, wdrażania się, testów, dokumentacji, wydajności i bezpieczeństwa – oraz odpowiednie profile narzędzi dla agentów.

  • Także XAML

    Interfejsy WPF są wczytywane razem z kodem: które powiązanie wskazuje na którą właściwość, który widok używa danego typu, które powiązanie prowadzi donikąd. XAML należący do kodu trafia do kontekstu – interfejs i kod C# rozpatrywane są razem.

Wszystkie ustawienia szczegółowo opisano przy aplikacji na pulpit.

AI Tagi

Czego nie ma w kodzie, mówią Państwo modelowi bezpośrednio przy kodzie.

Niektórych rzeczy nie da się wiarygodnie odczytać z samego kodu: jaką rolę biznesową pełni klasa, do której warstwy należy, jakiej reguły pilnuje. Za pomocą AI Tagów zapisują to Państwo jako krótki blok w komentarzu dokumentacyjnym – AICB włącza go do kontekstu.

  • Bezpośrednio przy kodzie – w znanym komentarzu ///, wersjonowanym razem z kodem
  • Znaczenie zamiast domysłów – rola, warstwa, domena, odpowiedzialność, efekty uboczne, stabilność i więcej
  • Pierwszeństwo przed oszacowaniem – AI Tag wygrywa z automatycznym wnioskowaniem; none wyłącza błędne wnioskowanie
  • To, co ważne, zostaje – metody oznaczone priority="high" pozostają przy redukcji kontekstu
  • Także dla agentów – serwer MCP wyszukuje według oznaczonych ról i warstw i pokazuje, która wartość pochodzi od programisty
/// <summary>Oblicza ceny dla umów ramowych.</summary>
/// <ai>
/// role="DomainService"
/// layer="Application"
/// domain="Pricing"
/// responsibility="Cena z umowy przed katalogową"
/// sideEffects="none"
/// </ai>
public class ContractPricingService
Stan i perspektywa

Dziś sterowane ręcznie – wkrótce wieloetapowo.

Dziś stosują Państwo szablony ręcznie: zestawiają kontekst, sprawdzają go i wysyłają. Dwa kolejne rodzaje przebiegów są już przygotowane w AICB, ale jeszcze nieudostępnione.

Iterations planowane

Wieloetapowe, zautomatyzowane przebiegi w wielu miejscach – osobny krok dla każdej klasy lub metody. Na przykład do tworzenia, sprawdzania i rozwijania AI Tagów.

Preselection planowane

Model najpierw otrzymuje zwięzły przegląd rozwiązania i wstępnie wybiera istotny kontekst; dopiero potem następuje właściwe zadanie. AICB staje się w ten sposób sterowalnym pośrednikiem między programistą, bazą kodu a modelem językowym – kontrola pozostaje w rękach człowieka.

Obsługiwane projekty

Od .NET Framework do .NET 10

AICB wczytuje projekty C# w formacie projektu SDK. Sprawdzono to na publicznych rozwiązaniach open source z następującymi platformami docelowymi:

  • .NET Framework4.6.2 · 4.7.2 · 4.8.1w formacie projektu SDK
  • .NET Standard2.0 · 2.1biblioteki dla wielu platform
  • .NET6 · 8 · 9 · 10także cele Windows, np. WPF
  • Rozwiązania – jako .sln, .slnx lub filtr rozwiązania .slnf
  • Także duże rozwiązania – sprawdzone m.in. na dotnet/roslyn z 406 projektami
  • Kilka platform docelowych w projekcie – są rozpoznawane; opcjonalnie analizowana jest tylko najnowsza
  • Wersja języka – do C# 14 włącznie
  • .NET SDK lub Visual Studio – zgodne z celami rozwiązania, pakiety przywrócone
  • Aplikacja na pulpit – w systemie Windows
  • Serwer MCP i wiersz poleceń – niezwiązane z Windows

Projekty w starszym, klasycznym formacie – wciąż spotykanym w wielu aplikacjach .NET Framework – nie są wskazane jako obsługiwane. Jeśli rozwiązanie zawiera takie projekty, pozostałą część można przeanalizować za pomocą filtra rozwiązania.

Lokalnie i oszczędnie z danymi

Co zostaje na Państwa komputerze.

AICB pracuje lokalnie i samo z siebie niczego nie wysyła. Jedyne połączenie, jakie nawiązuje aplikacja na pulpit, to połączenie z modelem językowym – i tylko wtedy, gdy Państwo je wywołają.

  • Brak telemetrii – bez raportowania użycia, sprawdzania aktualizacji i raportów awarii
  • Brak serwera licencji – bez aktywacji i bez weryfikacji online
  • Brak ruchu sieciowego – serwer MCP i wiersz poleceń nic nie wysyłają
  • Model językowy tylko na żądanie – możliwy jest także model działający lokalnie
Dostępność

Pobieranie i dokumentacja

Tutaj znajdą Państwo miejsca publikacji AICB oraz szczegółową dokumentację do pobrania.

Gdzie pobrać

AICB jest opublikowany na następujących platformach:

Wydanie zawiera instalator dla systemu Windows, przenośną wersję ZIP oraz serwer MCP jako pakiet .NET. Publikacja serwera MCP w serwisie nuget.org nastąpi wkrótce; do tego czasu instaluje się go z pobranego pliku pakietu.

Dokumentacja (PDF)

Pełny opis AICB: wszystkie ekrany ze zrzutami, wszystkie funkcje i szczegółowe objaśnienia.

Szczegółowa dokumentacja jest w przygotowaniu i będzie tutaj dostępna do pobrania, gdy tylko zostanie ukończona.

Licencja

Bezpłatnie do określonej wielkości.

Licencja zależy od wielkości Państwa organizacji, a nie od zakresu funkcji. Korzystanie jest bezpłatne, dopóki organizacja nie osiągnie żadnego z trzech progów:

  • 100 pracowników – liczonych w ramach grupy kapitałowej
  • 10 mln EUR rocznego obrotu
  • 21 programistów

Dla osób fizycznych – prywatnie, hobbystycznie, w trakcie nauki – oraz dla instytucji edukacyjnych w dydaktyce i badaniach niekomercyjnych korzystanie jest bezpłatne niezależnie od progów. Liczy się wyłącznie Państwa własna organizacja: wielkość klientów nie ma znaczenia, również przy pracy w ich siedzibie. Po osiągnięciu progu wymagana jest licencja komercyjna; warunki ustalam indywidualnie.

Zakres funkcji jest w każdym przypadku taki sam: nie ma okrojonej wersji bezpłatnej ani technicznej kontroli. Wiążący jest tekst licencji dostarczany wraz z oprogramowaniem.

Pytania dotyczące AICB?

O wykorzystanie w zespole, licencję komercyjną lub Państwa projekt – proszę krótko napisać, z czym Państwo pracują.

Wyślij zapytanieSerwer MCPAplikacja na pulpit