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

AX Wiki rehberi

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-10-03 Sahip: AX Code çalışma zamanı

AX Wiki, AX Code’un yerel depo wiki derleyicisidir. İzlenen kaynağı, yapılandırmayı, sınamaları, iş akışlarını ve mevcut belgeleri .ax-wiki/ altında küçük, kaynak destekli bir Markdown bilgi tabanına çevirir. AX Code ile aynı sağlayıcı yapılandırmasını ve model yönlendirmesini kullanır; ayrı bir yürütülebilir dosya veya kimlik bilgisi deposu yoktur.

ax-code wiki viz derlenmiş sayfaları ve alıntıladıkları dosyaları çizer. Bu haritanın ekran görüntüleri Wiki kanıt görselleştirmesi belgesindedir.

Nereye oturur

Wiki düzyazısı derlenmiş bir gezinme katmanıdır, yapısal kanıt değildir. Wiki kodla uyuşmazsa koda güvenin ve ax-code wiki update çalıştırın.

Hızlı başlangıç

Bir AX Code sağlayıcısı bağlayın, ardından çalıştırın:

ax-code wiki plan
ax-code wiki generate
ax-code wiki doctor

ax-code init --wiki, AGENTS.md üretir, AX Wiki işaretçi bloğunu ekler ve wikiyi tek iş akışında derler. Model çağrısı olmadan işaretçi eklemek için --wiki-only-agents kullanın.

Komutlar

Üretim seçenekleri --model provider/model, --dir <relative>, --quiet, --skip-agents ve --force içerir. --force, korumalı bölümlerin dışında el ile düzenlenen üretilmiş içeriğin yerini almak için kasıtlı olarak gerekir.

Depo dizini

v7.22.2 sürümünden itibaren varsayılan çıktı dizini .ax-wiki/ değeridir. Gizli önek, AX Code’un sürdürdüğü depo bilgisini tanımlar. Dosyaları Git yok sayması yapmaz: bu bilgiyi işleyip işlemeyeceğinizi seçin veya /.ax-wiki/ değerini deponuzun .gitignore dosyasına ekleyin.

Başka bir göreli dizin seçmek için wiki.dir kullanın; yer ax-code.json veya --dir docs/knowledge olur. CLI bayrağı önceliklidir. Tüm üretim, durum, ajan işaretçileri, arka plan bakımı ve görselleştirme bu seçimi kullanır. Derleyici daha eski bir ax-wiki/ dizinini otomatik algılamaz, taşımaz veya birleştirmez. Paket ve üretici adları, ax-wiki.config.json ve ax-wiki.instructions.md değişmez.

Üretilen sözleşme

AX Wiki Markdown sayfaları ve .ax-wiki/.manifest.json yazar. Her sayfanın ön maddesi şunları içerir:

• generated_by: ax-wiki
• kısa bir summary
• kanıt destekli üretimden dönen tam symbols
• sayfayı derlemek için kullanılan depoya göreli sources

Bildirim belirleyici plan özetini, depo kaynak özetlerini, sayfa özetlerini, üretim modelini, git revizyonunu ve üretim zamanını saklar. Sayfalar atomik yazılır; bildirim en son ve yalnızca bellek içi tam aday doğrulamayı geçtikten sonra yazılır.

Kaynak keşfi Git’in izlenen ve yok sayılmayan dosya listesini yeğler, üretilmiş/derleme/satıcı dizinlerini ve wikinin kendisini dışlar, ikili veya aşırı büyük dosyaları atlar ve depo dışındaki yolları veya sembolik bağları reddeder.

Alt sistem gezinmesi

Varsayılan plan hızlı başlangıç, mimari ve geliştirme sayfalarını tutar. Bir sayfanın kaynak sayısı veya kanıt baytı bütçesini aşan bir modül ayrıca modules/core/src/session.md gibi odaklı sayfalar alabilir. Bu sayfalar modülün src, lib veya app dizini altındaki doğrudan alt dizinleri kapsar; alt sistem başına en az üç kod dosyası ve modülde iki uygun alt sistem gerekir.

Alt sistem sayfaları uygulama alt ağaçlarını ve modülün test veya tests dizini altındaki eşleşen dosyaları içerir. Üretim yönergeleri giriş noktaları, çalışma zamanı akışı, sınırlar, somut değişiklik konumları ve ilgili sınamalar ister. Modül sayfaları en yüksek sıralı kaynaktan hemen sonra en fazla iki sınama dosyası koyar; böylece sınamalar sınırlı kanıt seçimine katılabilir.

Toplam varsayılan bütçe, üç genel bakış sayfası dahil 12 sayfada kalır. Modül genel bakışları ve alt sistem sayfaları kalan yuvalar için kaynak sayısına göre yarışır; bir alt sistem yalnızca üst genel bakışından sonra dahil edilir. Daha büyük alt sistemler bu yüzden daha küçük paket sayfalarının yerini alabilir. Sonucu ax-code wiki plan ile önizleyin. maxPages değerini artırın (otomatik planlar için 40’a kadar) veya belirli bir alt sistemin garantili kapsamı gerekiyorsa açık pages yapılandırın. Açık planlar yetkili kalır ve otomatik alt sistem sayfası almaz.

Bu, gezinmeyi ve kanıt odağını iyileştirir; üretilmiş düzyazıyı doğrulamaz veya bir ajanın wikiyi okuyacağını garanti etmez. Uygulama ayrıntılarına güvenmeden önce alıntıları güncel kaynağa kadar izleyin.

Ajanlar wikiyi nasıl kullanır

Ajanlar wikiye en ucuzdan en özele üç yolla ulaşır:

1. İstem dizini. Sağlıklı bir wiki varken oturum istemi kısa bir <repo_wiki> bloğu taşır: wiki konumu, bir tazelik etiketi ve sayfa başına bir satır (yol ve kırpılmış özet; varsayılan 12 sayfa için yaklaşık 750 token). Özetler yalnızca nerede okunacağını konumlar; kanıt değildir.
2. repo_wiki aracı. Üç işlemi olan salt okunur bir araç: index (sayfa başına tazelikle sayfa kartları), read (bir sayfa artı alıntılanan kaynakları, hangi alıntılanan kaynakların değiştiği ve bu kaynaklarda bulunmayan ön madde simgeleri) ve related (bir simge, gövde anması veya kaynak yolu için sayfalar). Tam ve kodlama araç profillerinde vardır ve read iznini kullanır.
3. Genel dosya araçları. read, glob ve grep, .ax-wiki/ üzerinde yine çalışır.

İstem tazeliği sayfa başına yargılanır: bir sayfa, alıntıladığı her kaynak bildirim özetiyle eşleştiği sürece tazedir. Hiçbir sayfanın alıntılamadığı eklenen veya düzenlenen bir dosya istem etiketini fresh bırakır ve wikinin onu henüz kapsamadığına dair bir not ekler. Değişen alıntılanan bir kaynak etiketi stale işaretler ve istem ajandan wikiyi yalnızca gezinme olarak ele almasını ister. ax-code wiki status ve wiki lint daha katı depo geneli kararı korur; eklenen, kaldırılan veya düzenlenen herhangi bir uygun dosya eskir.

Wiki kaynağın yerini asla almaz: her read sonucu doğrulanacak dosyaları listeler ve bir sayfa kodla uyuşmazsa kod kazanır.

Artımlı güncellemeler ve el ile içerik

wiki update güncel kaynak özetlerini bildirimle karşılaştırır ve değişiklikleri her sayfanın seçicileri üzerinden eşler. Bir plan değişikliği planlanan tüm sayfaları yeniden üretir; aksi halde ilgisiz sayfalar dokunulmadan kalır.

Üretilmiş düzyazı derleyiciye aittir. Dayanıklı bakımcı metnini korumalı bir bloğun içine koyun:

<!-- AX-WIKI:PROTECTED:START deployment-warning -->

Production migrations require an operator-approved maintenance window.

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

Korumalı gövdeler yeniden üretimden sağ çıkar. AX Wiki, --force verilmedikçe diğer el ile düzenlemelerin üzerine yazmayı reddeder. Eski üretilmiş sayfalar yalnızca yönetilen içerikleri değişmemişse ve korumalı bölüm içermiyorsa kaldırılır.

Yapılandırma

Entegrasyonu proje ax-code.json içinde yapılandırın:

{
  "wiki": {
    "enabled": true,
    "auto": true,
    "dir": ".ax-wiki",
    "model": "openai/gpt-5-mini",
    "autoInjectAgents": true,
    "touchClaudeMd": true,
    "maxPages": 12,
    "generationConcurrency": 2,
    "maxSourcesPerPage": 80,
    "exclude": ["fixtures/**"]
  }
}

include, exclude, maxSourceBytes ve maxPageSourceBytes kanıt keşfini ve bütçeleri denetler. instructions projeye özgü derleyici rehberi ekler. Tam küratörlü bir plan için pages girdilerini path, title, purpose ve selectors ile yapılandırın; açık bir plan quickstart.md içermelidir.

generationConcurrency, 1 veya 2 kabul eder. Yerel bulut üretimi varsayılan olarak iki eşzamanlı sayfa çağrısı yapar; yerel motorlar ve CLI sağlayıcıları varsayılan olarak bir yapar. Bir sağlayıcı üst üste binen istekleri kuyruğa alıyor veya kısıtlıyorsa 1 ayarlayın. Zamanlama mevcut sayfa içeriğini geçersiz kılmaz. Yeniden kullanılabilir paket, bu ayar verilmedikçe seri kalır.

Her model sayfası 180 saniyelik bir son tarihi paylaşan en fazla iki sınıflandırılmış deneme alır. Göreli Wiki bağlantıları sayfa kabul edilmeden önce sayfa planına karşı denetlenir; bozuk bağlantılı bir yanıt o sayfayı onarmak için kalan denemeyi kullanabilir. Son doğrulama ve el ile içerik korumaları yayımlamadan önce yine çalışır.

Kesilen derlemeler doğrulanmış sonuçları .ax-wiki/.page-cache/ içinde (veya yapılandırılmış Wiki dizininde) tutar. Sonraki bir derleme eşleşen sonuçları yalnızca güncel kaynak kanıtını, planı, üreticiyi, modeli ve önceki içeriği denetledikten sonra yeniden kullanır. İlk üretim, tam aday doğrulamayı geçene kadar yayımlanmaz. Başarılı yayımlama tüketilen hazırlık girdilerini kaldırır; sonraki açık wiki generate yine tüm sayfaları yeniden üretir. Önbellek girdileri sınırlı ve izinle kapılıdır; bozuk veya erişilemeyen girdiler yok sayılır.

.build-report.json model üretilmiş ve önbelleğe alınmış sayfaları, gerçekten yayımlanmış written sayfalarından ayırır. İsteğe bağlı pages dizisi, sağlayıcı verdiğinde her sayfanın denemelerini, süresini, istem/kaynak bayt boyutlarını ve tam token kullanımını kaydeder. Başarısız veya iptal edilen derlemeler yayımlanmış sayfa raporlamaz.

Derleyici rehberini ax-wiki.instructions.md içine ve çekirdek motor yapılandırmasını ax-wiki.config.json içine de koyabilirsiniz. Açık AX Code çalışma zamanı ayarları, ikisi de verildiğinde çekirdek yapılandırmayı geçersiz kılar.

Varsayılan etkileşimli bakım

AX Code TUI’de bir proje açmak arka plan Wiki bakımını varsayılan olarak açar. 30 saniye proje boşta kaldıktan sonra eksik yapıtlar üretilir ve eski yapıtlar artımlı güncellenir. Meşgul/yeniden deneyen oturumlar, kuyruktaki iş ve boş olmayan bir taslak önceliklidir ve arka plan üretimini iptal eder. Güncel ajanın okuma/yazma izinleri uygulanır; salt okunur ajanlar üretmez. Bu arka plan iş akışı hiçbir ajan yönerge dosyasını yeniden yazmaz.

Arka plan bakımını kapatmak için "wiki": { "auto": false } veya derleme ile istem enjeksiyonunu kapatmak için enabled: false kullanın. auto varsayılan olarak true değerindedir ve yapılandırma yazmaz. Yapılandırılmış Wiki modelini veya AX Code varsayılan modelini kullanır; 10 dakikalık iş son tarihi ve geri çekilmeli en fazla üç otomatik deneme vardır. Açık bir çizge isteği veya bir kaynak/yapılandırma değişikliği başka bir denemeye izin verir. Başsız çalıştırmalar ve CI etkileşimli zamanlayıcıyı açmaz. Git olmayan dizinler açık bir istek ister. Git projelerinde Wiki üretimi ve tüketimi en yakın worktree kökünü kullanır; bir pakette AX Code açmak ayrı bir paket Wiki oluşturmaz.

Oturum kenar çubuğu ve /wiki-viz hemen yerel bir ilerleme sayfası açar ve bakım ister. Bir anlık görüntü hazır olunca bu sayfa kaydedilmiş Wiki sayfa/kaynak ilişkilerini gösterir. Bkz. Wiki görselleştirmesi.

Ajan yönlendirmesi

Sağlıklı bir wiki varken ve wiki.enabled değeri false değilken oturum istemleri sıkı bir <repo_wiki> protokolü alır. Ajanlara hızlı başlangıçtan başlamalarını, yalnızca ilgili sayfaları yüklemelerini, önemli iddiaları alıntılanan dosyalar üzerinden doğrulamalarını ve yapısal sorular için çizge/LSP araçlarını kullanmalarını söyler.

healthy wiki dizininin, dizinin ve bildirimin varlığını anlatır. Ayrı freshness alanı fresh, stale veya unknown olur. Durum ve oturum yönlendirmesi güncel kaynak özetlerini etkili dahil/hariç ve boyut ayarlarıyla karşılaştırır; böylece işlenmemiş düzenlemeler, eklemeler ve silmeler algılanır. Denetimler önbelleğe alınmış taze bir kararı yeniden kullanmaz; uygun kaynakları sınırlı okuma eşzamanlılığıyla tarar. Eksik veya kapalı wikiler kaynak taramasından kaçınır. Tazelik anlık bir kaynak denetimidir; her üretilmiş iddianın veya sayfanın doğrulaması değildir. Yapıt doğrulaması için lint kullanın.

Eski veya doğrulanmamış wikiler gezinme için kullanılabilir kalır; uygulama iddialarına güvenmeden önce güncel özgün kaynağı doğrulama yönergesi açıktır. Doğrulama hataları unknown üretir. Wiki dizini yoksa wiki status 0 ile çıkar (eksik wiki rapordur). Wiki varken wiki sağlıksızsa veya tazelik fresh değilse başarısız çıkar.

Wiki kanıtı sınırlıdır: seçilen her kaynak sayfa bütçesi içinde en fazla ilk 32,000 baytını katar ve kesilme üretici için işaretlenir. GraphContext seçilmiş parçalar ekleyebilir ancak her parça 80 satırla sınırlıdır. Bu gezinme yardımcıları değişen her işlevin veya gerekli korumanın korunmasını garanti etmez; kapsamlı bir inceleme için gerekli özgün kodu ayrı verin.

Yönetilen <!-- AX-WIKI:START --> bloğu AGENTS.md içindedir ve wiki içeriğini depo yönergelerine kopyalamadan aynı yönlendirme ilkesini taşır.

CI

Sağlayıcı kimliği doğrulanmış bir işte ax-code wiki update ardından ax-code wiki lint çalıştırın, sonra bir belge PR’ı açın. Bkz. examples/ax-wiki-update.yml. Üretilmiş wiki değişikliklerini diğer belgeler gibi ele alın: kaynak alıntılarını inceleyin ve model çıktısını otomatik birleştirmekten kaçının.

Sorun giderme