Mentor / zrozumienie systemu

W czym pomaga Mentor

Mentor odczytuje zapis analizy projektu i tworzy opis systemu, podsumowania oraz ustalenia do przeglądu. Podstawowa analiza jest deterministyczna: wynika z dostępnych danych i zaimplementowanych reguł.

Wyjaśnia drogę danych

Pokazuje, gdzie mają działać zadania i jak są połączone. Gdy projekt zawiera jeden jednoznaczny łańcuch, układa wyjaśnienie od źródła do odbiorcy. Przy rozgałęzieniach, cyklach i niepełnych danych opisuje poszczególne połączenia.

Przeczytaj wyjaśnienie pierwszego systemu. To rzeczywisty wynik lokalnego CLI, z wartością 21.0, deklaracją co 2 s i przekazywaniem elementu do części raportowej.

Objaśnia dostępne fragmenty zachowania

Nowszy zapis analizy może przekazać pola wiadomości, wpisane wartości, deklarowane interwały i powiązanie pobranego elementu z jego wysłaniem. Mentor używa tych danych do prostego opisu kodu.

Zmiana 21.0 na 24.0 została sprawdzona na osobnej kopii przykładu: zmienia wartość w wyjaśnieniu. Nieobsługiwane wyrażenia i instrukcje pozostają jawnymi brakami danych. Mentor nie uruchamia nieznanej funkcji, żeby zgadnąć jej wynik.

Podsumowuje strukturę

Raport zawiera liczbę zadań, grup połączeń i zadeklarowanych środowisk oraz rozpoznane wzorce. Dla pierwszego systemu rozpoznał trzy zadania, jeden pipeline i trzy platformy, liniowy łańcuch oraz połączenie części urządzenia z serwerem.

Pipeline to nazwany w projekcie układ połączeń między zadaniami. Rozpoznany wzorzec pomaga nazwać strukturę; nie potwierdza jej działania na rzeczywistych urządzeniach.

Wskazuje miejsca do przeglądu

Ustalenia mają kod, wagę, wyjaśnienie, propozycję działania i — gdy jest dostępne — wskazanie źródła. Reguły mogą zwracać uwagę na odłączone zadania, brak platformy, cykle lub zagadnienia nadzoru i odporności.

To propozycje do oceny w kontekście projektu. Nie każda heurystyka jest dowodem problemu. W pierwszym systemie poprawiono błędne liczenie powtarzanych relacji do tego samego pipeline; inne miary grafu i zalecenia nadal wymagają ostrożnej interpretacji.

Łączy opinię z konkretną analizą

Mentor zachowuje identyfikator analizowanej wersji kodu. Dodatkowy raport zgodności semantycznej może zostać dołączony do analizy przez CLI; dla obsługiwanej wersji weryfikowane jest jego powiązanie z budowaniem.

Opinia o zgodności pozostaje niewiążąca: nie zmienia wyniku kompilacji i nie zatwierdza wdrożenia. W pokazanym przykładzie nie dołączono takiego raportu.

Jak skorzystać z obecnej implementacji

Droga sprawdzona dla tego przykładu to lokalne CLI:

1. Przygotuj zgodny lokalny kompilator i Mentora.
2. Wygeneruj zapis analizy projektu.
3. Przekaż ten zapis Mentorowi i odczytaj systemExplanation.

junexis-compiler analyze . --json
junexis-mentor analyze --snapshot .\out\analysis\junexis.analysis.preflight.json --json

Polecenia zakładają przygotowane narzędzia dostępne w PATH i projekt w bieżącym katalogu. Nie są instalatorem ani publicznym adresem pobierania. Pierwsze polecenie analizuje projekt bez uruchamiania aplikacji.

Nowe wyjaśnienie zachowania wymaga snapshotu 1.2. Starsze wejścia 1.0/1.1 zachowują opis struktury i informację o brakujących danych. Odpowiedź CLI ma wersję 1.3.

Studio i VS Code mają własne integracje wyników Mentora. Prezentację nowego wyjaśnienia w ich interfejsach trzeba sprawdzić osobno; ta próba dotyczy CLI.

Możliwości Studio · Lang: praca z projektem · Dostępność i ograniczenia Mentora