Lewati ke konten

Integrasi RTK

Extension rtk menulis ulang tool call Bash yang kompatibel untuk menggunakan binary Rust Token Killer. Selesai memakai ulang instalasi sistem yang valid atau menyediakan binary terkelola terverifikasi, mengurangi output command yang berisik tanpa mengubah perilaku rewrite Selesai sendiri.

Dibundel bersama Selesai

Dimuat otomatis bersama Selesai; tidak diperlukan npm install per ekstensi.

Entri manifest
./rtk.ts
Permukaan runtime
Otomatis

Penyiapan dan prasyarat

  • Extension dibundel bersama Selesai dan menyediakan rilis RTK yang di-pin ke direktori binary terkelola Selesai saat tidak ada binary sistem yang layak.
  • rtk harus melaporkan versi 0.23.0 atau lebih baru (rtk rewrite diperkenalkan di 0.23.0).
  • Selesai juga menjalankan rtk gain untuk menolak binary Rust Type Kit yang tidak terkait dan memakai nama command yang sama.
  • Setel PI_OFFLINE=1 untuk mencegah pengunduhan; extension kemudian tetap nonaktif jika tidak ada binary RTK yang valid.

Yang disiapkan

  • Memakai ulang rtk sistem yang valid atau mengunduh rilis resmi yang di-pin ke direktori binary terkelola Selesai dengan verifikasi checksum.
  • Probe rtk --version dan rtk gain saat extension dimuat dan keluar jika binary tidak ada, tidak terkait, atau terlalu tua.
  • Mendaftarkan listener tool_call yang mencegat Bash tool call dan mendelegasikan penulisan ulang command ke rtk rewrite.
  • Menerapkan command yang ditulis ulang hanya ketika rtk rewrite keluar dengan kode 0 atau 3 dan mengembalikan stdout non-kosong yang berbeda dari command asli.

Yang dapat dikonfigurasi

RTK dikelola oleh Selesai saat diperlukan. Ekstensi menulis ulang command saat biner rtk terverifikasi tersedia dan tidak dinonaktifkan.

Tidak ada konfigurasi user

Kemampuan ini tidak mengekspos pengaturan yang dapat diedit user. Perilakunya dikontrol oleh command dan aturan runtime yang didokumentasikan di bawah.

Kontrol command, tool, dan shortcut

Kunci / pathDeskripsi
automatic bash rewriteTransparan; tidak diperlukan command user.
RTK_DISABLED=1Atur variabel lingkungan ini untuk menonaktifkan penulisan ulang command RTK dan instalasi terkelola untuk sesi ini.
PI_OFFLINE=1Atur variabel lingkungan ini untuk menonaktifkan operasi jaringan saat startup, mencegah pengunduhan biner terkelola.

Bukti source

Yang dapat dilakukan

  • Jalankan Selesai seperti biasa; Selesai menyediakan RTK saat diperlukan. Tool call bash yang kompatibel ditulis ulang secara otomatis.
  • Setel RTK_DISABLED=1 sebelum menjalankan Selesai untuk melewati rewriter dan instalasi terkelola.
  • Setel PI_OFFLINE=1 untuk berjalan tanpa provisioning jaringan.
  • Periksa command yang ditulis ulang di output tool jika model meminta perilaku shell yang tepat.

Perintah, tool, dan shortcut

Tidak ada slash command, tool, atau shortcut. Extension hanya menulis ulang Bash tool call.

MekanismeDeskripsi
rtk rewrite <cmd>Subproses eksternal yang mengembalikan ekuivalen yang lebih tenang atau menandakan tidak ada rewrite.
Hook Bash tool callMencegat tool call bash sebelum eksekusi.

Batasan dan keamanan

  • Hanya tool call bash yang ditulis ulang; tool lain tidak tersentuh.
  • Command yang sudah diawali rtk dilewati untuk menghindari rekursi.
  • Rewrite bersifat advisory: jika rtk rewrite keluar dengan kode tak terduga, timeout setelah 2 detik, atau melempar error, command asli tetap berjalan (fail-open).
  • Extension tidak menambahkan tool baru atau mengubah perilaku model; hanya mengubah string command yang diteruskan ke Bash.
  • Selesai tidak menjalankan rtk init; hook Pi-nya sendiri menangani penulisan ulang command dan menghindari konfigurasi RTK ganda.

Source evidence

Selesai version: 0.10.0