Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Semantische Schicht

Status: Aktiv Umfang: aktueller Stand Zuletzt geprüft: 2026-05-03 Verantwortlich: AX-Code-Laufzeit

Dieses Dokument beschreibt die semantische Schicht, die heute in AX Code existiert, als Vertrag des aktuellen Stands und nicht als Roadmap.

Quelle der Wahrheit

Diese Seite dokumentiert ausgeliefertes semantisches Verhalten, nicht künftige Ambitionen eines Codegraphen. Wenn sich Verhalten ändert, prüfen Sie es gegen:

packages/ax-code/src/tool/lsp.ts und verwandte LSP-Module für live semantische Operationen.
packages/ax-code/src/code-intelligence/ für indiziertes Graphverhalten.
packages/ax-code-reason/ für graphgestützte Analysen zu Debugging und Umstrukturierung (Auswirkung, Fehlerpfade, Wettläufe, Lebenszyklus, Duplikation, fest kodierte Werte, Sicherheitsbefunde und gesteuerte Anwendung einer Umstrukturierung).
Wiedergabe-, Export- und Audittests, bevor dauerhafte Herkunftsgarantien behauptet werden.

Wenn eine Fähigkeit geplant oder experimentell ist, halten Sie diesen Status ausdrücklich fest.

Zweck

AX Code stellt semantische Antworten über zwei ausdrückliche Quellen bereit:

lsp: live Abfragen des Language-Servers
graph: dauerhafte Abfragen der Codeintelligenz

Das System leitet eines nicht still in das andere um. Aufrufer wählen die Oberfläche nach Anforderungen an Aktualität, Latenz und Determiniertheit.

Aktuelle semantische Oberflächen

Oberfläche	Stützende Quelle	Aktuelle Rolle
Tool `lsp`	live LSP-Clients	frischeste semantische Antworten, ausdrückliche live Abfrageoberfläche
Tool `code_intelligence`	indizierter SQLite-Codegraph	deterministische Graphabfragen über indizierte Symbole, Verweise und Aufrufbeziehungen

Das Tool lsp ist die live semantische Schnittstelle. Das Tool code_intelligence ist die indizierte semantische Schnittstelle. Keines ist ein verborgener Rückfall für das andere.

Aktuelle Steuerung:

code_intelligence ist standardmäßig aktiv, kann aber mit Funktionsflags deaktiviert werden
lsp verlangt derzeit das experimentelle Flag des LSP-Tools

Umschlagvertrag

Semantische Antworten tragen Herkunftsmetadaten, damit nachgelagerte Verbraucher über Vertrauen und Aktualität urteilen können.

Gemeinsame Felder:

source: lsp, graph oder cache
completeness: full, partial oder empty
timestamp: wann die zugrunde liegende Antwort aufgelöst wurde
degraded: optionales Signal, dass die Antwort vorsichtig behandelt werden soll

LSP-gestützte Umschläge können außerdem enthalten:

serverIDs: welche Language-Server beigetragen haben
cacheKey: stabiler Verweis auf eine Zeile des LSP-Antwortcaches

Audit und Wiedergabe

Aktuelles Verhalten:

live semantische Aufrufe über das Tool lsp schreiben Zeilen audit_semantic_call
die Tool-Wiedergabe bewahrt jetzt tool.result.metadata, das heißt graphgestützte semantische Metadaten gehen bei Wiedergabe oder Export nicht verloren
deterministische Wiedergabe vergleicht Metadaten des Entscheidungspfads, nicht die semantische Gleichheit jeder zurückgegebenen Symbolliste

Das gibt LSP-gestützten und graphgestützten semantischen Antworten vergleichbare Auditsicht, auch wenn sie weiterhin aus verschiedenen Speicher- und Laufzeitpfaden stammen.

Aktuell freigegebene Operationen

`lsp`

Die live Oberfläche lsp umfasst umschlaggestützte Operationen für:

Definition
Verweise
Hover
Dokumentsymbole
Workspace-Symbole
Implementierungen
Aufrufhierarchie
zusammengefasste Diagnosen

Das ist die richtige Oberfläche, wenn Aktualität wichtiger ist als Wiederholbarkeit.

`code_intelligence`

Die Graphoberfläche umfasst:

Symbolsuche
Dateisymbole
Verweise
Aufrufer
Aufgerufene

Das ist die richtige Oberfläche, wenn Wiederholbarkeit und geringere Latenz wichtiger sind als die sofortige Aktualität des Editorzustands.

Eine dritte, optionale Wissensoberfläche ist das native semantische Repository-Wiki unter .ax-wiki/, kompiliert von ax-code wiki. Es ist nicht Teil des strukturellen Graph- und LSP-Umschlagvertrags oben.

Oberfläche	Rolle
`lsp` / `code_intelligence`	Strukturelle Präzision (dieses Dokument)
`.ax-wiki/`	quellgestützte Architekturerzählung für Agenten

Siehe AX Wiki für CLI, Routing und Nichtziele. Die Wiki-Synthese darf nicht als Ersatz für Aufrufer, Aufgerufene und Verweise behandelt werden.

Wichtige Nichtziele

Die aktuelle semantische Schicht tut diese Dinge nicht:

kein verborgenes Graph-zuerst-Routing mit automatischem LSP-Rückfall
keine Behauptung, dass Graphaktualität der live LSP-Aktualität gleicht
keine Behauptung, dass jede interne semantische Hilfe über HTTP oder das SDK freigegeben ist
keine Aufteilung der semantischen Laufzeit in Rust in der aktuellen Umsetzung
keine Behauptung, dass AX-Wiki-Markdown eine strukturelle Quelle der Wahrheit ist (siehe AX Wiki)

Integrationshinweise

Wenn Sie Dokumentation, SDK-Bindungen oder Abläufe höherer Ebene schreiben:

Beschreiben Sie lsp und code_intelligence als getrennte semantische Oberflächen.
Unterscheiden Sie öffentliche Tooloperationen von internen Hilfsfunktionen.
Beschreiben Sie nur Audit- und Wiedergabegarantien, die in den aktuellen Schemata tatsächlich bewahrt werden.
Erwähnen Sie Flags, wenn eine semantische Oberfläche nicht immer aktiv ist.
Halten Sie bei Erwähnung von AX Wiki die Verantwortungen von Wiki und Graph ausdrücklich getrennt.