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

Uçbirim görüntüleme

Durum: Güncel Kapsam: TUI uçbirim profili seçimi, geçersiz kılmalar ve görsel yetenek sınırları Son inceleme: 2026-10-03 Sahip: AX Code TUI bakımcıları

AX Code başlangıçta ortamdan bir uçbirim profili seçer. Profil uçbirim kurulumunu denetler; monitör çözünürlüğünü veya yazı tipi keskinliğini değil.

Açık bir TERM_PROGRAM, devralınan dış uçbirim işaretlerinin önüne geçer. dumb, linux ve vt100 gibi sınırlı uçbirim türleri de uyumlu kalır. Yalnızca Ubuntu veya WSL kimliği gelişmiş profili açmaz.

Gelişmiş profil alternatif ekranı, yerel bir görüntüleme iş parçacığını ve uçbirim yetenek algılamasını kullanır. Uyumlu profil yerel görüntüleme iş parçacığı olmadan ana ekranı kullanır. İkisi de fare etkileşimini (bkz. Fare yakalama) ve klavye protokolü pazarlığını açar ve 60 FPS hedefler; gerçek kare hızları iş yüküne ve uçbirime bağlıdır.

Windows Terminal, doğrudan oturumu tanındığında her iki profilde de 24-bit görsel etkileri korur. Renk desteği piksel grafiği veya Nerd Font desteği anlamına gelmez. Gelişmiş mod yazı tipini, yazı tipi boyutunu veya görüntü ölçeklemesini değiştirmez.

Fare yakalama

AX Code, TUI içi denetimlerin tıklanabilir kalması için uçbirim fare girdisini varsayılan olarak yakalar: altbilgi kısayol parçaları (Hızlı model, Otonom, Sandbox), iletişim ve otomatik tamamlama seçenekleri, tıklayarak odak, sürükleyerek seçim ve TUI içi tekerlek kaydırması. Yakalama açıkken uçbirim fareyi çalışan programa verir; bu yüzden uçbirimin kendi sağ tık menüsü ve yerel metin seçimi gösterilmez. Birçok uçbirim bunları yine bir değiştiriciyle sunar — genellikle Shift artı sağ tık, bazen Option veya Alt — uçbirime ve arada tmux, screen veya Zellij olup olmadığına bağlıdır.

Fareyi uçbirime geri vermek için mouse değerini false olarak tui.json içinde ayarlayın:

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1, tui.json ne olursa olsun yakalamayı kapatır. Bunun nedeni proje düzeyindeki tui.json dosyalarının güvenilmeyen girdi olmasıdır: bir depo, kullanıcının isteğine karşı uçbirimin kendi fare davranışını bastırılmış tutamamalıdır. Değişken yalnızca yakalamayı kapatır; asla zorla açamaz.

Vazgeçmek bir takastır, salt kazanç değil:

• Geri gelenler: uçbirimin yerel sağ tık menüsü, yerel metin seçimi ve kopyala/yapıştır. Uyumlu profilde tekerleği uçbirimin kendi geri kaydırması ele alır.
• Yitirilenler: altbilgi kısayol parçaları, tıklayarak odak, tıklanabilir iletişim ve otomatik tamamlama seçenekleri, sürükleyerek seçim ve — uçbirim geri kaydırması olmayan gelişmiş (alternatif ekran) profilde — TUI içi tekerlek kaydırması. Bu eylemler için klavye denetimleri kullanılabilir kalır.

Yakalama açıkken sağ tık, uçbirimin menüsü yerine TUI’nin kendi bağlam menüsünü açar: tıklama konumunda küçük bir Kopyala / Yapıştır menüsü. Kopyala, ekranda bir seçim varken etkinleşir; Yapıştır, bir metin girdisi odaktayken — istem ve iletişim kutularının içindeki girdiler dahil. Menü Escape ile, herhangi bir tuşla, kaydırmayla veya dışında bir tıklamayla kapanır. Yakalama kapanınca tıklamayı uçbirim ele alır.

Profili geçersiz kılma

Gelişmiş mod istemek için AX_CODE_TUI_ADVANCED_TERMINAL=1, uyumlu mod istemek için 0 ayarlayın. Açık bir geçersiz kılma, uzak ve çoğullanmış oturumlar dahil otomatik algılamanın önüne geçer. Otomatik seçimi geri yüklemek için değişkeni kaldırın. true/false, yes/no ve on/off de kabul edilir.

PowerShell, geçerli kabuk ve alt süreçleri için:

$env:AX_CODE_TUI_ADVANCED_TERMINAL = "1"
ax-code

# Use compatible mode if startup or rendering has problems.
$env:AX_CODE_TUI_ADVANCED_TERMINAL = "0"
ax-code

# Restore automatic selection.
Remove-Item Env:AX_CODE_TUI_ADVANCED_TERMINAL -ErrorAction SilentlyContinue

Bash veya Zsh, tek bir başlatma için:

AX_CODE_TUI_ADVANCED_TERMINAL=1 ax-code
AX_CODE_TUI_ADVANCED_TERMINAL=0 ax-code

Kabuk başlangıç dosyalarınız değişkeni dışa aktarıyorsa o dışa aktarmayı kaldırın ve otomatik seçimi geri yüklemek için unset AX_CODE_TUI_ADVANCED_TERMINAL çalıştırın.

Piksel animasyonları

Açılış ve kapanış animasyonları pikselleri yalnızca görüntüleyici Kitty grafiğini, geçerli piksel boyutlarını, yerel bir TTY’yi, alternatif ekranı ve çoğullayıcı olmadığını doğruladığında kullanır. Eksik yetenekler veya bir grafik başarısızlığı metin geri dönüşünü kullanır. Otomatik gelişmiş mod bu denetimleri atlamaz.

Tüm piksel animasyon kareleri — Digital Code, Foliage ve yer işareti sahneleri — 1920x1080 ile sınırlıdır. Bu animasyon kareleri, görüntüleyicinin 60 FPS hedefinden ayrı olarak 20 FPS zamanlamasında güncellenir. Önizlemeler için TUI açılış ve kapanış animasyonları bölümüne bakın.

Onaylı Sixel desteği olan (ve Kitty grafiği olmayan) Windows Terminal oturumları, metin geri dönüşü yerine 640x360 ve 256 KiB ile sınırlı tek bir durağan Sixel açılış karesi gösterir. AX_CODE_SIXEL_SPLASH=0 bunu kapatır; =1 herhangi bir Sixel uçbiriminin bunu göstermesine izin verir (test yolu). Söküm, Sixel görüntü kimliği silmesi olmadığı için açılış bölgesini kaplama arka planıyla yeniden boyar.

Windows Terminal yazı tipi

AX Code uçbirim yazı tipini değiştiremez. Dosya türü simgeleri (Nerd Font özel kullanım glifleri) Windows Terminal içinde yalnızca yamalı bir yazı tipi kuruluysa görüntülenir. Önerilen yazı tipi Cascadia Code NF dir: kurun, sonra Ayarlar > Profiller > Görünüm > Yazı tipi yüzü altında profil yazı tipi olarak ayarlayın. Uygulama içi tek seferlik bir ipucu Windows Terminal kullanıcılarını bu kuruluma yönlendirir; simgeler zaten görüntüleniyorsa veya AX_CODE_NERD_FONT=0 vazgeçtiyse hiç gösterilmez.