Trang này được dịch từ tài liệu tiếng Anh. Lệnh, định danh và ví dụ giữ nguyên. Runtime 7.24.4 · SDK 2.6.7. Bản tiếng Anh

Kết xuất terminal

Trạng thái: Hiện hành Phạm vi: chọn hồ sơ terminal của TUI, ghi đè và ranh giới khả năng hình ảnh Xem xét lần cuối: 2026-10-03 Chủ sở hữu: người bảo trì TUI AX Code

AX Code chọn một hồ sơ terminal từ môi trường khi khởi động. Hồ sơ điều khiển thiết lập terminal, không phải độ phân giải màn hình hay độ sắc của phông.

Môi trường terminal	Hồ sơ tự động	Nhận dạng
Windows Terminal, kể cả Ubuntu trong WSL	Nâng cao	`WT_SESSION` không rỗng, và không có `TERM_PROGRAM` xung đột
GNOME Terminal và các máy chủ VTE khác	Nâng cao	Số thập phân dương `VTE_VERSION`, `TERM=xterm` hoặc `xterm-256color`, và không có `TERM_PROGRAM` xung đột
Ghostty	Nâng cao	`TERM_PROGRAM=ghostty` hoặc `TERM=xterm-ghostty`
Terminal.app trên macOS	Tương thích	`TERM_PROGRAM=Apple_Terminal`
Terminal chưa biết, SSH/mosh, tmux, screen và Zellij	Tương thích	Đường lùi thận trọng

Một TERM_PROGRAM tường minh được ưu tiên hơn các dấu hiệu terminal ngoài được kế thừa. Các loại terminal hạn chế như dumb, linux và vt100 cũng ở mức tương thích. Chỉ danh tính Ubuntu hoặc WSL không bật hồ sơ nâng cao.

Hồ sơ nâng cao dùng màn hình thay thế, một luồng kết xuất gốc và phát hiện khả năng terminal. Hồ sơ tương thích dùng màn hình chính không có luồng kết xuất gốc. Cả hai đều bật tương tác chuột (xem Bắt chuột) và thương lượng giao thức bàn phím, và nhắm 60 FPS; tốc độ khung thực tế phụ thuộc tải và terminal.

Windows Terminal giữ hiệu ứng hình 24-bit ở cả hai hồ sơ khi phiên trực tiếp của nó được nhận dạng. Hỗ trợ màu không ngụ ý đồ họa điểm ảnh hay hỗ trợ Nerd Font. Chế độ nâng cao không đổi phông, cỡ phông hay tỷ lệ hiển thị.

Bắt chuột

AX Code bắt đầu vào chuột của terminal theo mặc định để các điều khiển trong TUI vẫn nhấp được: các chip phím tắt ở chân trang (Fast-model, Tự chủ, Sandbox), tùy chọn hộp thoại và tự hoàn thành, nhấp để lấy tiêu điểm, kéo để chọn, và cuộn bánh xe trong TUI. Khi bắt đang bật, terminal giao chuột cho chương trình đang chạy, nên menu chuột phải của chính terminal và chọn văn bản gốc không hiện. Nhiều terminal vẫn lộ chúng bằng một phím bổ trợ — thường là Shift cộng chuột phải, đôi khi Option hoặc Alt — tùy terminal và tùy tmux, screen hoặc Zellij có nằm ở giữa hay không.

Đặt mouse thành false trong tui.json để trả chuột về terminal:

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1 tắt bắt bất kể tui.json. Nó tồn tại vì các tệp tui.json cấp dự án là đầu vào không đáng tin: một kho không được phép giữ hành vi chuột của chính terminal bị chặn ngược ý người dùng. Biến này chỉ tắt bắt; nó không bao giờ có thể ép bật.

Chọn không tham gia là một đánh đổi, không phải thắng tuyệt đối:

Được trả lại: menu chuột phải gốc của terminal, chọn văn bản gốc và sao chép/dán. Cuộn ngược của chính terminal xử lý bánh xe ở hồ sơ tương thích.
Mất: chip phím tắt ở chân trang, nhấp để lấy tiêu điểm, tùy chọn hộp thoại và tự hoàn thành có thể nhấp, kéo để chọn, và — ở hồ sơ nâng cao (màn hình thay thế), vốn không có cuộn ngược terminal — cuộn bánh xe trong TUI. Điều khiển bàn phím vẫn dùng được cho các hành động đó.

Khi bắt đang bật, chuột phải mở menu ngữ cảnh của chính TUI thay vì của terminal: một menu Sao chép / Dán nhỏ tại vị trí nhấp. Sao chép được bật khi có vùng chọn trên màn hình, Dán khi một ô nhập văn bản đang có tiêu điểm — kể cả lời nhắc và các ô nhập trong hộp thoại. Menu đóng khi Escape, khi bất kỳ phím nào, khi cuộn, hoặc khi nhấp bên ngoài nó. Khi bắt đã tắt, terminal xử lý cú nhấp thay thế.

Ghi đè hồ sơ

Đặt AX_CODE_TUI_ADVANCED_TERMINAL=1 để yêu cầu chế độ nâng cao hoặc 0 để yêu cầu chế độ tương thích. Một ghi đè tường minh được ưu tiên hơn phát hiện tự động, kể cả phiên từ xa và phiên ghép kênh. Gỡ biến để khôi phục chọn tự động. true/false, yes/no và on/off cũng được chấp nhận.

PowerShell, cho shell hiện tại và các tiến trình con của nó:

$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 hoặc Zsh, cho một lần khởi chạy:

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

Nếu các tệp khởi động shell của bạn xuất biến đó, hãy gỡ lệnh xuất và chạy unset AX_CODE_TUI_ADVANCED_TERMINAL để khôi phục chọn tự động.

Hoạt ảnh điểm ảnh

Hoạt ảnh mở và kết chỉ dùng điểm ảnh khi trình kết xuất xác nhận đồ họa Kitty, kích thước điểm ảnh hợp lệ, một TTY cục bộ, màn hình thay thế và không có bộ ghép kênh. Thiếu khả năng hoặc lỗi đồ họa sẽ dùng đường lùi văn bản. Chế độ nâng cao tự động không bỏ qua các kiểm tra này.

Mọi khung hoạt ảnh điểm ảnh — Digital Code, Foliage và các cảnh mốc — bị giới hạn 1920x1080. Các khung hoạt ảnh này cập nhật theo lịch 20 FPS, tách khỏi mục tiêu 60 FPS của trình kết xuất. Xem Hoạt ảnh mở và kết của TUI để xem trước.

Các phiên Windows Terminal có hỗ trợ Sixel đã xác nhận (và không có đồ họa Kitty) hiện một khung splash Sixel tĩnh, giới hạn 640x360 và 256 KiB, thay cho đường lùi văn bản. AX_CODE_SIXEL_SPLASH=0 tắt nó; =1 cho phép bất kỳ terminal Sixel nào hiện nó (đường kiểm thử). Việc tháo vẽ lại vùng splash bằng nền lớp phủ vì Sixel không có xóa theo mã ảnh.

Phông của Windows Terminal

AX Code không thể đổi phông của terminal. Biểu tượng loại tệp (glyph vùng dùng riêng của Nerd Font) chỉ kết xuất trong Windows Terminal khi đã cài một phông đã vá. Phông được khuyến nghị là Cascadia Code NF: hãy cài nó, rồi đặt làm phông hồ sơ tại Cài đặt > Hồ sơ > Giao diện > Kiểu chữ. Một gợi ý trong ứng dụng một lần chỉ người dùng Windows Terminal tới thiết lập này; nó không hiện khi biểu tượng đã kết xuất hoặc khi AX_CODE_NERD_FONT=0 chọn không tham gia.