Zentui TUI
Zentui adalah statusline terinspirasi Starship dan TUI bergaya Opencode untuk Selesai. Memberikan lima permukaan kepemilikan dan styling independen — editor, pesan user, thinking (eksperimental), working line, dan footer — dengan statusline opsional bergaya Starship.
Dibundel bersama Selesai
Dimuat otomatis bersama Selesai; tidak diperlukan npm install per ekstensi.
Penyiapan dan prasyarat
- Dibundel bersama Selesai dan dimuat otomatis; tidak diperlukan instalasi terpisah.
- Memerlukan sesi TUI interaktif; tidak berpengaruh dalam mode headless.
- Permukaan editor, pesan user, thinking, working line, dan border selector masing-masing memiliki field
enabledindependen; footer menggunakan satustyle:native,starship, atauhidden.
Yang disiapkan
- Editor — perlakuan input Opencode, Opencode copy-friendly, Accent Rail, dan Minimalist.
- Pesan user — pesan transkrip framed, framed copy-friendly, compact, dan labeled.
- Thinking (Eksperimental) — renderer privat opsional Rail, Tree, atau Streaming untuk thinking Pi, tanpa mengambil alih Working line.
- Working line — pengambilalihan opsional atas baris sedang berjalan lengkap Pi dan ringkasan turn yang selesai.
- Footer — footer native Pi, statusline bergaya Starship, atau footer nol-baris tersembunyi, dengan segmen yang dapat dikonfigurasi dan template format footer compact.
- Mendaftarkan perintah
/zentuiuntuk konfigurasi langsung dan toggle cepat.
Yang dapat dikonfigurasi
Zentui mengonfigurasi permukaan editor, pesan user, thinking, working line, footer, segmen, git, dan ekstensi yang independen dari satu zentui.json, dengan picker /zentui langsung.
Lokasi dan preseden konfigurasi
- Konfigurasi zentui
~/.selesai/agent/zentui.json
Satu file yang ditulis /zentui; tidak ada lapisan proyek.
Pengaturan
| Kunci / path | Tipe, default, dan nilai | Deskripsi |
|---|---|---|
components.editor.style | string Default: opencode | Permukaan editor: opencode, opencode-copy-friendly, accent-rail, atau minimalist. |
components.footer.style | string Default: native | Gaya footer: native, starship, atau hidden. |
components.userMessages.style | string Default: framed | Gaya pesan user: framed, framed-copy-friendly, compact, atau labeled. |
components.workingLine.enabled | boolean Default: true | Ambil alih baris working line lengkap Pi dan ringkasan turn yang selesai. |
components.footer.styles.starship.pathDisplay.mode | string Default: basename | Tampilan path footer starship: basename, full, atau repository. |
components.thinkingSteps.enabled | boolean Default: false | Renderer thinking privat opsional (Rail, Tree, atau Streaming); eksperimental dan dapat rusak setelah pembaruan Pi. |
components.thinkingSteps.mode | string Default: tree | Mode thinking: rail, tree, atau streaming. |
Kontrol command, tool, dan shortcut
| Kunci / path | Deskripsi |
|---|---|
/zentui | Buka picker konfigurasi langsung; perubahan disimpan ke zentui.json. |
/zentui editor toggle | Toggle permukaan editor tanpa membuka picker. |
/zentui messages toggle | Toggle framing pesan user tanpa membuka picker. |
/zentui working-line | Konfigurasikan pengambilalihan working line dan ringkasan turn. |
/zentui format <template> | Atur template format footer compact. |
Bukti source
src/extensions/pi-zentui/extensions/zentui/config.ts
Jalankan /zentui untuk mengonfigurasi Appearance, Editor, User messages, Thinking (Eksperimental), Working line, Footer, Segments, Git, dan Extensions. Gunakan Tab dan Shift+Tab untuk berpindah bagian; perubahan diterapkan langsung dan disimpan ke ~/.selesai/agent/zentui.json.
Yang dapat dilakukan
- Toggle permukaan satu per satu:
/zentui editor toggle,/zentui messages toggle,/zentui statusline toggle,/zentui viewport-indicators toggle. - Konfigurasikan pengambilalihan working line dengan
/zentui working-line. - Atur template format footer compact:
/zentui format "$cwd on branch $git_branch$git_status using $runtime $fill $context". - Ganti gaya footer antara
native,starship, danhiddentanpa mengikatnya ke komponen lain.
Perintah, tool, dan shortcut
/zentui— buka picker konfigurasi langsung./zentui <permukaan> toggle— balik satu permukaan tanpa membuka picker./zentui format <template>— atur format footer compact.
Batasan dan keamanan
-
Hanya sesi TUI interaktif yang merender permukaan Zentui.
-
Thinking (Eksperimental) nonaktif secara default dan dapat rusak setelah pembaruan Pi. Streaming aktif dapat beralih langsung ke Rail atau Tree, dan Rail serta Tree dapat saling beralih langsung; pengaktifan pertama, pengaktifan ulang setelah nonaktif langsung, dan masuk ke Streaming dari mode struktural memerlukan restart Pi. Kegagalan kembali ke thinking native penuh.
-
Hanya sesi TUI interaktif yang merender permukaan Zentui.
-
Tampilan path footer Starship default
basename; pilih moderepositoryuntuk menghilangkan direktori repository itu sendiri. -
Konfigurasi adalah satu file tingkat user; tidak ada lapisan proyek.