Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Anlamsal katman

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-05-03 Sahip: ax-code çalışma zamanı

Bu belge AX Code’da bugün var olan anlamsal katmanı anlatır. Bir yol haritası değil, güncel durum sözleşmesidir.

Doğruluk kaynağı

Bu sayfa gönderilmiş anlamsal davranışı belgeler, gelecekteki kod çizgesi hedeflerini değil. Davranış değişince şunlara karşı doğrulayın:

Canlı anlamsal işlemler için packages/ax-code/src/tool/lsp.ts ve ilgili LSP modülleri.
Dizinlenmiş çizge davranışı için packages/ax-code/src/code-intelligence/.
Çizge destekli hata ayıklama/yeniden yapılandırma analizleri için packages/ax-code-reason/ (etki, hata yolları, yarışlar, yaşam döngüsü, yineleme, sabit kodlanmış değerler, güvenlik bulguları ve kapılı yeniden yapılandırma uygulaması).
Dayanıklı köken garantileri iddia etmeden önce yeniden oynatma, dışa aktarma ve denetim sınamaları.

Bir yetenek planlanmış veya deneyselse bu durumu açık tutun.

Amaç

AX Code anlamsal yanıtları iki açık kaynak üzerinden sunar:

lsp: canlı dil sunucusu sorguları
graph: kalıcı kod zekası sorguları

Sistem birini diğerine sessizce yönlendirmez. Çağıranlar yüzeyi tazelik, gecikme ve belirleyicilik gereksinimlerine göre seçer.

Güncel anlamsal yüzeyler

Yüzey	Dayanak kaynak	Güncel rol
`lsp` aracı	canlı LSP istemcileri	en taze anlamsal yanıtlar, açık canlı sorgu yüzeyi
`code_intelligence` aracı	dizinlenmiş SQLite kod çizgesi	dizinlenmiş simgeler, başvurular ve çağrı ilişkileri üzerinde belirleyici çizge sorguları

lsp aracı canlı anlamsal arayüzdür. code_intelligence aracı dizinlenmiş anlamsal arayüzdür. İkisi de diğerinin gizli geri dönüşü değildir.

Güncel kapılama:

code_intelligence varsayılan olarak açıktır ancak özellik bayraklarıyla kapatılabilir
lsp şu anda deneysel LSP araç bayrağını gerektirir

Zarf sözleşmesi

Anlamsal yanıtlar, aşağı akış tüketicilerin güven ve tazelik hakkında akıl yürütebilmesi için köken üst verisi taşır.

Ortak alanlar:

source: lsp, graph veya cache
completeness: full, partial veya empty
timestamp: alttaki yanıtın çözüldüğü an
degraded: yanıtın temkinli ele alınması gerektiğine dair isteğe bağlı işaret

LSP destekli zarflar ayrıca şunları içerebilir:

serverIDs: hangi dil sunucularının katkıda bulunduğu
cacheKey: bir LSP yanıt önbelleği satırına kararlı başvuru

Denetim ve yeniden oynatma

Güncel davranış:

lsp aracı üzerinden canlı anlamsal çağrılar audit_semantic_call satırları yazar
araç yeniden oynatması artık tool.result.metadata korur; bu, çizge destekli anlamsal üst verinin yeniden oynatma/dışa aktarma sırasında kaybolmadığı anlamına gelir
belirleyici yeniden oynatma karar yolu üst verisini karşılaştırır, dönen her simge listesinin anlamsal eşitliğini değil

Bu, LSP destekli ve çizge destekli anlamsal yanıtlara karşılaştırılabilir denetim görünürlüğü verir; yine de farklı depolama/çalışma zamanı yollarından gelirler.

Güncel açık işlemler

`lsp`

Canlı lsp yüzeyi şunlar için zarf destekli işlemler içerir:

tanım
başvurular
üzerine gelme
belge simgeleri
çalışma alanı simgeleri
uygulamalar
çağrı hiyerarşisi
toplanmış tanılar

Yenilik, yinelenebilirlikten daha önemliyse doğru yüzey budur.

`code_intelligence`

Çizge yüzeyi şunları içerir:

simge arama
dosya simgeleri
başvurular
çağıranlar
çağrılanlar

Yinelenebilirlik ve daha düşük gecikme, anlık düzenleyici durumu tazeliğinden daha önemliyse doğru yüzey budur.

Üçüncü, isteğe bağlı bilgi yüzeyi .ax-wiki/ altındaki yerel anlamsal depo wikisidir; ax-code wiki tarafından derlenir. Yukarıdaki yapısal çizge/LSP zarf sözleşmesinin parçası değildir.

Yüzey	Rol
`lsp` / `code_intelligence`	Yapısal kesinlik (bu belge)
`.ax-wiki/`	Ajanlar için kaynak destekli mimari anlatı

CLI, yönlendirme ve hedeflenmeyenler için AX Wiki sayfasına bakın. Wiki sentezi çağıranlar/çağrılanlar/başvuruların yerine konmamalıdır.

Önemli hedeflenmeyenler

Güncel anlamsal katman şunları yapmaz:

otomatik LSP geri dönüşlü gizli çizge öncelikli yönlendirme yok
çizge tazeliğinin canlı LSP tazeliğine eşit olduğu iddiası yok
her iç anlamsal yardımcının HTTP veya SDK üzerinden açık olduğu iddiası yok
güncel uygulamada Rust anlamsal çalışma zamanı ayrımı yok
AX Wiki markdown’ının yapısal doğruluk kaynağı olduğu iddiası yok (bkz. AX Wiki)

Entegrasyon rehberi

Belge, SDK bağlamaları veya daha üst düzey iş akışları yazarken:

lsp ve code_intelligence değerlerini ayrı anlamsal yüzeyler olarak anlatın
herkese açık araç işlemlerini iç yardımcı işlevlerden ayırın
yalnızca güncel şemalarda gerçekten korunan denetim/yeniden oynatma garantilerini anlatın
bir anlamsal yüzey her zaman açık değilse bayrakları anın
AX Wiki anılırken wiki ile çizge sorumluluklarını açık tutun