Snapshot dokumentasi · CLI 7.30.1 · SDK 2.6.53. Desktop memakai runtime yang disertakan dalam rilisnya sendiri. Perintah dan contoh tetap sama dengan sumber bahasa Inggris. Sumber bahasa Inggris

Membuat dan memakai AX Wiki pertama

Sebelum memulai

AX Wiki mengubah sumber repositori terpilih menjadi halaman arsitektur dan alur kerja. Ini adalah pengetahuan repositori, terpisah dari dokumentasi situs AX Code. Hubungkan penyedia dan pilih model yang dapat digunakan terlebih dahulu. Pembuatan mengirim bukti terpilih ke penyedia tersebut dan dapat dikenakan biaya.

Jalankan dari folder proyek. Proyek Git menggunakan akar worktree terdekat meskipun dimulai dari subdirektori. Periksa checkout dan putuskan apakah berkas yang dihasilkan perlu masuk kontrol versi.

Pratinjau dan buat

Rencana menampilkan berkas dan halaman terpilih tanpa panggilan model. Tinjau sebelum pembuatan:

ax-code wiki plan

Lalu buat dengan model yang dikonfigurasi, validasi hasilnya, dan buka pembaca lokal:

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

Keluaran bawaan adalah .ax-wiki/, dimulai dari .ax-wiki/quickstart.md; .ax-wiki/.manifest.json mencatat sumber dan hash. Pembuatan dapat memperbarui blok penunjuk Wiki dalam AGENTS.md; gunakan --skip-agents untuk melewati langkah itu. Tinjau diff hasilnya.

Baca dan ajukan pertanyaan berguna

Mulai dari halaman pengantar, ikuti berkas yang dikutip, dan tanyakan lokasi implementasi alur kerja. Penampil menunjukkan halaman, kutipan, serta hubungan yang tercatat. Hentikan penampil CLI di latar depan dengan Ctrl+C.

Gunakan Wiki untuk orientasi, lalu periksa kode dan pengujian terkini. Untuk simbol, pemanggil, dan referensi yang tepat, gunakan kecerdasan kode atau LSP. Halaman yang mutakhir tidak membuktikan cakupan lengkap, kebenaran, atau kinerja runtime.

Jaga tetap mutakhir

Setelah perubahan sumber, perbarui halaman terdampak dan periksa kesehatannya:

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

Perintah status bisa berhasil meski Wiki belum ada; periksa keberadaan dan kesehatan yang dilaporkan. Hasil usang atau tidak sehat perlu diselidiki. Penampil CLI memakai snapshot tetap: buka ulang setelah pembaruan.

Pada versi TUI saat ini, /wiki-viz membuka penampil dan meminta pemeliharaan. Pemeliharaan interaktif saat menganggur aktif secara bawaan; pekerjaan latar depan diprioritaskan. Eksekusi headless tidak mengaktifkan penjadwal ini.

Kontrol pembuatan

Gabungkan pengaturan opsional berikut ke ax-code.json proyek. Ganti ID model dengan yang tersedia melalui koneksi Anda. Contoh ini menonaktifkan pemeliharaan latar belakang tetapi mempertahankan perintah eksplisit:

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

--model provider/model eksplisit mengganti model Wiki untuk pemanggilan tersebut. Model penalaran memerlukan kontrol penalaran rendah/nonaktif yang dikenali; pilih model lain yang didukung jika kebijakan menolak permintaan.

Letakkan catatan pengelola dalam blok terlindungi agar tetap ada setelah pembaruan:

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

Deployment requires maintainer review.

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

Pulihkan dari masalah

Tidak ada model atau kesalahan autentikasi: verifikasi akses penyedia dan model Wiki yang dikonfigurasi. Model chat yang berfungsi tidak menjamin model Wiki terpisah dapat digunakan.
Batas waktu atau build terputus: periksa ax-code wiki doctor dan .ax-wiki/.build-report.json, lalu coba lagi setelah penyebabnya diatasi. Halaman sementara tervalidasi dapat dipakai ulang; build gagal bukan berarti semua halaman telah diterbitkan.
Konflik edit manual: simpan catatan dalam blok terlindungi dan tinjau perubahan sebelum mencoba lagi. --force mengizinkan penggantian edit di luar blok tersebut; gunakan hanya dengan sengaja.

Langkah berikutnya

Konfigurasi Wiki, CI, dan pemecahan masalah · Penampil dan ekspor luring · Pemilihan model · Pusat dokumentasi