Tool display
Ekstensi pi-tool-display menjaga panggilan tool tetap ringkas secara bawaan, menambahkan rendering diff yang lebih kaya untuk edit file, memotong output tool yang bertele-tele, dan memperbaiki detail UI chat inti seperti label thinking dan kotak prompt user native.
Dibundel bersama Selesai
Dimuat otomatis bersama Selesai; tidak diperlukan npm install per ekstensi.
Penyiapan dan prasyarat
- Dibundel bersama Selesai dan dimuat otomatis; tidak perlu diinstal terpisah.
- Membutuhkan sesi TUI interaktif; tidak berpengaruh dalam mode headless.
- Template config awal dikirim di
config/config.example.json; config runtime dibuat saat pertama kali digunakan.
Yang disiapkan
- Rendering tool — output bergaya OpenCode yang ringkas untuk
read,grep,find,ls,bash,edit, danwrite, dengan panggilan tool ber-box ASCII secara bawaan. - Visualisasi diff — rendering lebih kaya untuk edit file dengan mode tampilan dan indikator yang dapat dikonfigurasi.
- Pemotongan output — mode hidden/summary/preview per keluarga tool dengan batas baris.
- Kotak pesan user native dan label thinking yang lebih baik.
- Mendaftarkan perintah
/tool-displayuntuk konfigurasi langsung dan preset.
Yang dapat dikonfigurasi
Tool display mengonfigurasi rendering tool ringkas, tampilan diff, pemotongan output, dan kotak pesan user native dari satu config.json, dengan preset /tool-display.
Lokasi dan preseden konfigurasi
- Konfigurasi tool display
~/.selesai/agent/extensions/pi-tool-display/config.json
Satu file tingkat user yang ditulis /tool-display; tidak ada lapisan proyek.
Pengaturan
| Kunci / path | Tipe, default, dan nilai | Deskripsi |
|---|---|---|
readOutputMode | string Default: hidden | Mode output tool read: hidden, summary, atau preview. |
searchOutputMode | string Default: hidden | Mode output tool search: hidden, count, atau preview. |
bashOutputMode | string Default: opencode | Mode output bash: opencode, summary, atau preview. |
previewLines | number Default: 8 | Baris yang ditampilkan dalam mode preview. |
boxedToolCalls | boolean Default: true | Gambar border ASCII di sekitar setiap panggilan tool dan outputnya. |
enableNativeUserMessageBox | boolean Default: true | Gunakan kotak pesan user native. |
Kontrol command, tool, dan shortcut
| Kunci / path | Deskripsi |
|---|---|
/tool-display show | Tampilkan ringkasan konfigurasi efektif. |
/tool-display preset <opencode|balanced|verbose|boxed> | Terapkan preset rendering. |
/tool-display reset | Reset ke preset boxed bawaan. |
Bukti source
src/extensions/pi-tool-display/src/types.tssrc/extensions/pi-tool-display/config/config.example.json
Jalankan /tool-display untuk menampilkan config efektif, menerapkan preset (opencode, balanced, verbose, boxed), atau reset ke bawaan. Opsi lanjutan ada di config.json di bawah direktori ekstensi agent.
Yang dapat dilakukan
- Menjaga output tool tetap ringkas dengan
/tool-display preset opencodeatau gayaboxedbawaan. - Beralih ke
balanceduntuk ringkasan dengan jumlah baris, atauverboseuntuk preview yang lebih besar. - Menyesuaikan mode output per tool, jumlah baris preview, dan rendering diff di
config.json.
Perintah, tool, dan shortcut
/tool-display show— tampilkan ringkasan config efektif./tool-display preset <opencode|balanced|verbose|boxed>— terapkan preset rendering./tool-display reset— reset ke preset boxed bawaan.
Batasan dan keamanan
- Hanya sesi TUI interaktif yang merender permukaan tool display.
- Ekstensi mendaftarkan renderer tool-nya hanya jika tool belum dimiliki ekstensi lain, sehingga renderer yang ada tidak pernah dibuang.
- Konfigurasi adalah satu file tingkat user; tidak ada lapisan proyek.