Lewati ke konten

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.

Entri manifest
./pi-tool-display
Permukaan runtime
Campuran (command, tool, shortcut)

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, dan write, 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-display untuk 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

  1. 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 / pathTipe, default, dan nilaiDeskripsi
readOutputModestring
Default: hidden
Mode output tool read: hidden, summary, atau preview.
searchOutputModestring
Default: hidden
Mode output tool search: hidden, count, atau preview.
bashOutputModestring
Default: opencode
Mode output bash: opencode, summary, atau preview.
previewLinesnumber
Default: 8
Baris yang ditampilkan dalam mode preview.
boxedToolCallsboolean
Default: true
Gambar border ASCII di sekitar setiap panggilan tool dan outputnya.
enableNativeUserMessageBoxboolean
Default: true
Gunakan kotak pesan user native.

Kontrol command, tool, dan shortcut

Kunci / pathDeskripsi
/tool-display showTampilkan ringkasan konfigurasi efektif.
/tool-display preset <opencode|balanced|verbose|boxed>Terapkan preset rendering.
/tool-display resetReset ke preset boxed bawaan.

Bukti source

  • src/extensions/pi-tool-display/src/types.ts
  • src/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 opencode atau gaya boxed bawaan.
  • Beralih ke balanced untuk ringkasan dengan jumlah baris, atau verbose untuk 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.

Source evidence

Selesai version: 0.10.0