Belge anlık görüntüsü · CLI 7.30.1 · SDK 2.6.53. Desktop, kendi sürümüyle gelen çalışma zamanını kullanır. Komutlar ve örnekler İngilizce kaynakta olduğu gibi korunur. İngilizce kaynak

İlk AX Wiki’nizi oluşturun ve kullanın

Başlamadan önce

AX Wiki, seçilen depo kaynaklarından mimari ve iş akışı sayfaları oluşturur. Bu depo bilgisi, AX Code web sitesi belgelerinden ayrıdır. Önce sağlayıcı bağlayın ve kullanılabilir model seçin. Üretim seçilen kanıtları sağlayıcıya gönderir ve kullanım ücreti doğurabilir.

Proje klasöründen çalıştırın. Git projeleri alt klasörden başlasanız bile en yakın worktree kökünü kullanır. Checkout durumunu kontrol edip üretilen dosyaların sürümlenip sürümlenmeyeceğine karar verin.

Önizleyin ve üretin

Plan, model çağrısı yapmadan seçilen dosya ve sayfaları gösterir. Üretmeden önce inceleyin:

ax-code wiki plan

Ardından yapılandırılan modelle üretin, sonucu doğrulayın ve yerel okuyucuyu açın:

ax-code wiki generate
ax-code wiki doctor
ax-code wiki viz --open

Varsayılan çıktı .ax-wiki/, başlangıç sayfası .ax-wiki/quickstart.md dosyasıdır; .ax-wiki/.manifest.json kaynakları ve özetleri kaydeder. Üretim AGENTS.md içindeki Wiki yönlendirme bloğunu güncelleyebilir; bunu atlamak için --skip-agents kullanın. Oluşan farkı inceleyin.

Okuyun ve yararlı sorular sorun

Hızlı başlangıç sayfasından başlayıp alıntılanan dosyaları izleyin ve iş akışının nerede uygulandığını sorun. Görüntüleyici sayfaları, alıntıları ve kayıtlı ilişkileri gösterir. Ön plandaki CLI görüntüleyicisini Ctrl+C ile durdurun.

Wiki ile yönünüzü bulup güncel kodu ve testleri inceleyin. Kesin semboller, çağıranlar ve başvurular için kod zekâsı veya LSP kullanın. Güncel sayfa, tam kapsamı, doğruluğu veya çalışma performansını kanıtlamaz.

Güncel tutun

Kaynak değişikliklerinden sonra etkilenen sayfaları güncelleyip sağlığı kontrol edin:

ax-code wiki update
ax-code wiki status
ax-code wiki doctor

Wiki yokken de durum komutu başarılı olabilir; bildirilen varlık ve sağlığı kontrol edin. Eski veya sağlıksız çıktı araştırılmalıdır. CLI görüntüleyicisi sabit anlık görüntüdür: güncellemeden sonra yeniden açın.

Güncel TUI sürümlerinde /wiki-viz görüntüleyiciyi açıp bakım ister. Etkileşimli boşta bakım varsayılan açıktır; ön plan işi önceliklidir. Arayüzsüz çalıştırma bu zamanlayıcıyı etkinleştirmez.

Üretimi kontrol edin

Bu isteğe bağlı ayarları proje ax-code.json dosyasına ekleyin. Model kimliğini bağlantınızda mevcut olanla değiştirin. Bu örnek açık komutları koruyarak arka plan bakımını kapatır:

{
  "wiki": {
    "enabled": true,
    "auto": false,
    "model": "provider/model"
  }
}

Açık --model provider/model, o çağrının Wiki modelini geçersiz kılar. Akıl yürütme modellerinde Wiki üretimi tanınan düşük/kapalı akıl yürütme kontrolü ister; ilke isteği reddederse başka desteklenen model seçin.

Bakım notlarını güncellemelerde korumak için korumalı bloklara koyun:

<!-- AX-WIKI:PROTECTED:START project-note -->

Deployment requires maintainer review.

<!-- AX-WIKI:PROTECTED:END -->

Sorunlardan kurtulun

Model yok veya kimlik doğrulama hatası: sağlayıcı erişimini ve Wiki model ayarını doğrulayın. Çalışan sohbet modeli, ayrı Wiki modelinin kullanılabileceğini garanti etmez.
Zaman aşımı veya kesilen derleme: ax-code wiki doctor ve .ax-wiki/.build-report.json inceleyin, nedeni çözüp yeniden deneyin. Doğrulanan geçici sayfalar yeniden kullanılabilir; başarısız derleme tüm sayfaların yayımlandığı anlamına gelmez.
Elle düzenleme çakışması: notları korumalı bloklara alın ve yeniden denemeden değişiklikleri inceleyin. --force, bu blokların dışındaki düzenlemeleri değiştirebilir; yalnızca isteyerek kullanın.

Sonraki adımlar

Wiki yapılandırması, CI ve sorun giderme · Görüntüleyici ve çevrimdışı dışa aktarma · Model seçimi · Belge merkezi