Halaman ini diterjemahkan dari dokumentasi bahasa Inggris. Perintah, pengenal, dan contoh tidak diubah. Runtime 7.24.4 · SDK 2.6.7. Sumber bahasa Inggris

Kanal pemasangan dan runtime

Status: Aktif Cakupan: keadaan saat ini Terakhir ditinjau: 2026-10-09 Pemilik: ax-code runtime

README akar mempertahankan jalur pemasangan utama. Halaman ini adalah sumber kebenaran untuk kanal pemasang CLI yang didukung, label runtime ax-code doctor, perilaku peluncur lokal, dan perilaku peningkatan publik.

Ketersediaan publik

Pemasang rilis publik dan arsip runtime bertanda tangan didistribusikan melalui download.ax-code.com. Pemasangan tidak memerlukan kredensial GitHub privat.

AX Code dan SDK hanya mendukung Node.js 26 atau lebih baru. Pemasang mandiri membundel runtime Node yang terverifikasi. Checkout sumber dan aplikasi SDK berbasis Node harus menyediakan Node.js 26+; pemasangan paket menolak versi Node yang lebih lama.

AX Code Standard tetap gratis untuk pemakaian pribadi dan komersial di bawah lisensi yang ada. Akses sumber pengembangan dikelola terpisah dari distribusi publik. Komponen Business proprietari yang direncanakan punya lisensi terpisah; ini tidak mengubah lisensi Standard. Lihat Standard dan Business untuk rincian dan panduan situs untuk pembaruan pemasangan publik. Pemasang publik dan aset bertanda tangannya harus dapat dijangkau dan diverifikasi sebelum situs mengiklankan perintah pemasangan satu baris.

Ketersediaan rilis

Mendorong tag git vMAJOR.MINOR.PATCH memulai alur Rilis. Indeks rilis publik hanya menampilkan versi setelah alur itu menandatangani aset dan memublikasikan. Sampai saat itu, Latest tetap pada tag yang dipublikasikan sebelumnya. Setelah validasi berhasil, pengelola dapat melihat Draf untuk tag baru; itu bukan Latest publik.

Untuk pemasangan yang sudah ada, ikuti Peningkatan dan pemulihan.

Jalur yang disarankan

Gunakan pemasang terpaket yang didukung kecuali Anda mengembangkan dari checkout. Pemasang rilis adalah jalur CLI utama di macOS dan Linux; gunakan pemasang PowerShell native di Windows.

macOS (Apple Silicon)

curl -fsSL https://download.ax-code.com/install | bash

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Ubuntu 24.04+

curl -fsSL https://download.ax-code.com/install | bash

Homebrew tetap alternatif yang didukung untuk CLI macOS:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Homebrew memerlukan kepercayaan eksplisit untuk tap non-resmi. Kepercayaan seluruh tap ini mencakup semua formula saat ini dan mendatang, cask, serta perintah eksternal yang dipublikasikan di defai-digital/tap. Tap bersama berisi formula CLI dan cask Desktop, dan Homebrew dapat memuat kedua definisi saat menyelesaikan pemasangan. Gunakan pemasang rilis jika kepercayaan seluruh tap tidak dapat diterima.

Pindahkan pemasangan yang ada dari tap warisan

defai-digital/ax-code kini tap hanya-migrasi. Rilis AX Code hanya memperbarui defai-digital/tap. Jika Anda memasang dari tap warisan, tambahkan tap bersama sebelum memperbarui agar Homebrew dapat memindahkan kepemilikan tap paket yang terpasang:

brew tap defai-digital/tap
brew trust --formula defai-digital/tap/ax-code
brew update
brew upgrade defai-digital/tap/ax-code
brew info defai-digital/tap/ax-code

Setelah mengonfirmasi pemasangan memakai tap bersama, hapus tap warisan:

brew untap defai-digital/ax-code

Jika Homebrew masih melaporkan tap lama, jalankan brew reinstall defai-digital/tap/ax-code sebelum melepasnya. Repositori warisan tetap dapat diakses agar pemasangan yang ada menemukan migrasi.

Verifikasi pemasang Unix yang disematkan versinya

Untuk pemasangan Unix yang diperiksa dan disematkan versinya, unduh terlebih dahulu pemasang dan tanda tangannya dari rilis yang sama. Dengan minisign tepercaya yang sudah tersedia:

AX_INSTALL_VERSION="<release>"
AX_INSTALL_BASE="https://download.ax-code.com/releases/download/v${AX_INSTALL_VERSION}"
curl -fsSL "$AX_INSTALL_BASE/install" -o ax-code-install
curl -fsSL "$AX_INSTALL_BASE/install.minisig" -o ax-code-install.minisig
minisign -Vm ax-code-install -x ax-code-install.minisig -P 'RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO'
# Inspect ax-code-install before running it.
bash ax-code-install --version "$AX_INSTALL_VERSION" --no-modify-path

Tanda tangan arsip tidak mengautentikasi skrip bootstrap sebelum eksekusi. Digest yang diunduh dari asal yang sama mendeteksi kerusakan tetapi bukan pemeriksaan identitas penerbit yang independen. Jalur satu baris mengandalkan titik akhir distribusi HTTPS.

Eksekusi jarak jauh satu baris adalah jalur kenyamanan. Pemasang Windows memverifikasi ZIP CLI yang diunduh dengan Minisign setelah mulai, tetapi irm | iex tidak memverifikasi install.ps1 sendiri sebelum eksekusi.

Jika minisign belum ada di PATH, pemasang PowerShell mengunduh arsip Minisign 0.12 yang disematkan dari download.ax-code.com, memeriksa SHA-256-nya, dan memeriksa berkas yang diekstrak lagi sebelum menyimpannya di cache. Anda tidak perlu memasang Minisign secara manual untuk jalur pemasangan bawaan. Biner minisign yang sudah ada di PATH dipakai apa adanya.

Untuk lingkungan yang peka keamanan, unduh pemasang, verifikasi dengan Minisign, periksa, dan sematkan versi rilis yang dipakai CI:

$AX_CODE_VERSION = "<release>"
$AxCodeMinisignPublicKey = "RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO"
irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
irm https://download.ax-code.com/install.ps1.minisig -OutFile ax-code-install.ps1.minisig
# Optional: use a preinstalled minisign, or let install.ps1 bootstrap one when verifying the archive.
minisign -Vm ax-code-install.ps1 -x ax-code-install.ps1.minisig -P $AxCodeMinisignPublicKey
Get-Content .\ax-code-install.ps1
.\ax-code-install.ps1 -Version $AX_CODE_VERSION -NoModifyPath

Atur AX_CODE_SKIP_MINISIGN_VERIFY=1 hanya ketika Anda sengaja menerima unduhan rilis yang tidak dapat diverifikasi.

Verifikasi runtime yang terpasang:

ax-code doctor

Pemasangan pengguna yang didukung sebaiknya melaporkan Runtime: Node vX.Y.Z (node-bundled) di macOS, Windows, dan Linux (glibc).

Pemasang ini mendistribusikan runtime CLI/TUI. Kepemilikan rilis Desktop ada di AX Coder, dan rilis Desktop baru saat ini dibekukan. Panduan ini tidak menyediakan kanal pemasangan atau peningkatan Desktop.

Matriks kanal

node-bundled dan source adalah mode runtime, bukan nama pengelola paket. Mereka menggambarkan berkas mana yang memuat kode aplikasi:

• node-bundled: Node.js memuat runtime rilis yang dibundel (semua kanal pemasangan pengguna yang didukung).
• source: Node memuat berkas langsung dari checkout.

compiled dan bun-bundled adalah mode runtime era Bun yang dipensiunkan, dipertahankan hanya untuk diagnostik warisan. Mereka bukan kanal pemasangan pengguna yang didukung.

pnpm dev dan pnpm cli mengompilasi SDK workspace (packages/sdk/js) ke dist dengan TypeScript repositori sebelum meluncurkan, jadi checkout baru berjalan tanpa build SDK manual. Langkah itu memanggil typescript/bin/tsc melalui node secara langsung, jadi tidak bergantung pada node_modules/.bin yang tertaut. Jalur bundel (pnpm run setup:cli dan pnpm --dir packages/ax-code run build) tetap memerlukan pnpm --dir packages/sdk/js run build terlebih dahulu.

Kebijakan platform

• macOS: gunakan pemasang rilis bash sebagai jalur CLI terdokumentasi yang utama. Ia memasang di bawah ~/.ax-code, memulai Minisign yang disematkan bila perlu, memverifikasi arsip rilis, dan tidak memerlukan Homebrew. Arsip darwin-arm64 menyertakan sidecar AX Engine yang mandiri untuk inferensi lokal. Build kontributor memakai pnpm run setup:cli.
• Jalur Homebrew yang didukung secara eksplisit mengetuk dan memercayai defai-digital/tap sebelum memakai perintah pemasangan yang sepenuhnya terkualifikasi. Kepercayaan seluruh tap mencakup semua formula, cask, dan perintah eksternal saat ini serta mendatang di tap bersama; gunakan pemasang rilis bash ketika cakupan kepercayaan itu tidak dapat diterima.
• CLI Linux: gunakan pemasang bash untuk Ubuntu Desktop/Server 24.04 LTS dan yang lebih baru pada amd64 dan arm64 (glibc). Build rilis menghasilkan ax-code-linux-x64.tar.gz dan ax-code-linux-arm64.tar.gz pada pelari Ubuntu 24.04 agar garis dasar glibc tetap kompatibel dengan 24.04+. Musl (Alpine) tidak didukung arsip rilis saat ini.
• Arsip CLI macOS: build rilis hanya memublikasikan darwin-arm64 (Apple Silicon). macOS Intel bukan target pemasangan yang didukung untuk paket CLI atau Desktop saat ini.
• CLI Windows: gunakan pemasang PowerShell native. Ia memasang aset rilis GitHub ke direktori lokal-pengguna dan memperbarui PATH pengguna kecuali -NoModifyPath diberikan. Ia memverifikasi ZIP yang diunduh dengan kunci publik yang disematkan sebelum ekstraksi dan gagal tertutup kecuali AX_CODE_SKIP_MINISIGN_VERIFY=1 diatur secara sengaja. Jika minisign tidak ada, pemasang mengunduh arsip Minisign 0.12 yang disematkan dari download.ax-code.com ke %LOCALAPPDATA%\ax-code\tools\minisign dan memeriksa berkas yang diekstrak sebelum menyimpannya di cache. Biner minisign yang sudah ada di PATH dipakai apa adanya. Gunakan -Uninstall untuk menghapus pemasangan lokal-pengguna dan entri PATH.
• Desktop Windows: gunakan pemasang Electron bertanda tangan dari GitHub Releases, bernama AX-Code-<version>-win-x64.exe atau AX-Code-<version>-win-arm64.exe. Penerbit Authenticode yang diharapkan adalah DEFAI Private Limited. Jangan gambarkan install.ps1 sebagai pemasang Desktop. Pemasangan senyap: .\AX-Code-<version>-win-x64.exe /S (NSIS).
• Winget: manifes paket dihasilkan dengan pnpm exec tsx tools/winget/generate-manifests.ts --version <ver> dan dikirim ke microsoft/winget-pkgs (lihat tools/winget/README.md). Sampai dipublikasikan di hulu, GitHub Releases tetap sumber kebenaran pemasangan Windows.
• npm: bukan kanal pemasangan atau peningkatan yang didukung.

Eksekusi jarak jauh satu baris adalah jalur kenyamanan, bukan satu-satunya jalur. Pertahankan alur pemasang yang dapat diperiksa (dan, di Windows, terverifikasi Minisign) di dokumen, gunakan versi tersemat di CI, dan dokumentasikan pemasang platform hanya dengan cakupan matriks pemasangan yang memverifikasi ax-code --version dan memverifikasi ax-code doctor melaporkan mode runtime yang diharapkan untuk platform itu.

Pemasangan perusahaan dan tanpa pengawasan

CLI Windows (lokal-pengguna, tanpa admin)

# Pin version in CI/images
$env:AX_CODE_VERSION = "7.9.4"
irm https://download.ax-code.com/releases/download/v$env:AX_CODE_VERSION/install.ps1 -OutFile install.ps1
# Optional: verify install.ps1.minisig first (see SECURITY.md)
.\install.ps1 -Version $env:AX_CODE_VERSION -NoModifyPath
# Then add %USERPROFILE%\.ax-code\bin to the machine/user PATH via your MDM.

macOS (lokal-pengguna / Homebrew / MDM)

Gunakan pemasang rilis untuk pemasangan CLI lokal-pengguna tanpa Homebrew:

curl -fsSL https://download.ax-code.com/install | bash

Mac terkelola dapat memakai formula Homebrew agar pembaruan CLI mengikuti tap:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Untuk pemasangan DMG yang dikemas MDM, gunakan AX-Code-*-mac-arm64.dmg yang dinotarisasi dari GitHub Releases dan verifikasi .minisig yang terpisah ketika kebijakan mengharuskan pemeriksaan rantai pasok.

Ketersediaan Winget

Gunakan pemasang publik kecuali paket CLI komunitas yang terverifikasi tersedia. Jangan menganggap bundel manifes yang dihosting GitHub dapat diakses secara anonim.

Memperbarui

Pilih kanal yang memiliki pemasangan aktif:

Pengguna tap warisan yang ada sebaiknya mengikuti migrasi tap bersama. Pemasangan kedua dapat membayangi yang pertama di PATH; gunakan which -a ax-code, ax-code --version, dan ax-code doctor sebelum mengganti kanal. Memasang versi mandiri tidak mencopot Homebrew. Pindah antar kanal hanya secara sengaja, dan pertahankan data sesi serta konfigurasi Anda.

Peningkatan mandiri Unix mengambil pemasang dari rilis target dan memerlukan sidecar SHA-256-nya. Pemasang atau digest yang hilang menghentikan peningkatan; tidak ada cadangan main yang dapat berubah. Untuk memasang arsip yang lebih lama dari rilis tanpa aset pemasang, unduh dan verifikasi pemasang rilis saat ini, lalu jalankan dengan --version <older-version>.

Pemasangan Unix mandiri memakai ~/.ax-code/bin/ax-code sebagai symlink stabil ke generasi runtime unik di bawah ~/.ax-code/versions/. Pemasang memverifikasi pohon baru yang lengkap sebelum mengalihkan tautan itu. Memasang ulang suatu versi membuat generasi baru. Ia mempertahankan generasi lama dan berkas runtime warisan agar agen yang sudah berjalan dapat terus memuat modulnya sendiri. Ia tidak memulai ulang agen yang berjalan. Mulai klien atau runtime baru untuk memakai versi baru; hentikan kerja aktif secara eksplisit sebelum mulai ulang runtime. Berkas Homebrew tetap dikelola Homebrew.

Untuk rollback, gunakan pemasang terverifikasi dengan --version <previous-version>. Berkas version di setiap generasi yang dipertahankan mengidentifikasi rilisnya. Generasi lama tidak dipangkas secara otomatis; setelah menghentikan semua proses yang memakainya, Anda boleh menghapus generasi yang tidak terpakai. Saat pencopotan, pertahankan sesi dan konfigurasi dengan --keep-data --keep-config jika perlu; ikuti panduan penghapusan biner dan hapus generasi runtime yang tidak terpakai secara terpisah hanya setelah prosesnya berhenti. Jangan menghapus seluruh folder .ax-code jika Anda menyimpan konfigurasi atau berkas pribadi lain di sana.

Pemasangan Unix bersamaan gagal dengan lokasi direktori .install-lock. Pemasang yang terbunuh mendadak dapat meninggalkan direktori kosong itu. Periksa pemasang yang aktif sebelum menghapus kunci basi dan mencoba ulang; jangan menghapusnya saat pemasangan sedang berjalan.

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Di Windows ini memperbarui CLI. Untuk menghapus pemasangan CLI dan entri PATH penggunanya:

irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
.\ax-code-install.ps1 -Uninstall

Perilaku peluncur kontributor

Bagian ini memerlukan checkout sumber yang diotorisasi. Ia tidak diperlukan untuk pemasangan atau peningkatan publik; lihat Akses sumber.

pnpm run setup:cli sengaja memakai jalur terkompilasi secara bawaan. Ia membangun atau memakai ulang biner bundel lokal di bawah packages/ax-code/dist/... dan memasang peluncur global yang menunjuk ke biner itu. Ini menjaga pemeriksaan runtime terpaket lokal tetap dekat dengan yang dijalankan pengguna Homebrew dan pemasang curl.

Peluncur itu biasanya mendarat di ~/.local/bin atau PNPM_HOME, yang biasanya lebih awal di PATH daripada Homebrew. Jika Homebrew sudah menyediakan ax-code, setup:cli memasang checkout sebagai ax-code-src dan menghapus pembungkus ax-code yang sebelumnya ditulis agar brew upgrade ax-code terus memperbarui perintah ax-code. Gunakan pnpm run setup:cli -- --override-homebrew hanya ketika Anda sengaja ingin checkout mengambil alih ax-code. ax-code doctor tetap memperingatkan penimpaan itu sebagai PATH launchers.

Setelah perubahan sumber yang seharusnya memengaruhi runtime terpaket, segarkan biner bundel sebelum menguji peluncur global:

pnpm --dir packages/ax-code run build -- --single
pnpm run setup:cli -- --rebuild
ax-code-src --version   # or `ax-code` if Homebrew is not installed

Gunakan peluncur sumber hanya ketika Anda sengaja ingin perintah checkout mengeksekusi checkout ini melalui Node dari berkas sumber:

pnpm run setup:cli -- --source
ax-code-src doctor      # or `ax-code doctor` if Homebrew is not installed

Peluncur sumber sebaiknya melaporkan Runtime: Node vX.Y.Z (source).

Persyaratan rantai alat

Repositori menegakkan pnpm@10.33.4 melalui bidang packageManager akar dan only-allow pnpm: kait preinstall memblokir pemasangan non-pnpm, dan kait pre<script> akar memblokir npm run <script> dengan persyaratan yang sama. Node.js harus cocok dengan mesin package.json akar (>=26), yang juga menyediakan --experimental-ffi untuk perintah TUI mode sumber.

Jangan memakai pnpm test akar; skrip akar sengaja keluar dengan do not run tests from root. Untuk packages/ax-code, jalankan tes dari packages/ax-code/.

Pemasangan Homebrew menerima notifikasi pembaruan tanpa peningkatan latar otomatis. Selesaikan eksekusi agen yang aktif sebelum secara eksplisit meningkatkan atau membersihkan keg Homebrew yang lama.