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.
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.
rtkharus melaporkan versi0.23.0atau lebih baru (rtk rewritediperkenalkan di0.23.0).- Selesai juga menjalankan
rtk gainuntuk menolak binary Rust Type Kit yang tidak terkait dan memakai nama command yang sama. - Setel
PI_OFFLINE=1untuk mencegah pengunduhan; extension kemudian tetap nonaktif jika tidak ada binary RTK yang valid.
Yang disiapkan
- Memakai ulang
rtksistem yang valid atau mengunduh rilis resmi yang di-pin ke direktori binary terkelola Selesai dengan verifikasi checksum. - Probe
rtk --versiondanrtk gainsaat extension dimuat dan keluar jika binary tidak ada, tidak terkait, atau terlalu tua. - Mendaftarkan listener
tool_callyang mencegat Bash tool call dan mendelegasikan penulisan ulang command kertk rewrite. - Menerapkan command yang ditulis ulang hanya ketika
rtk rewritekeluar dengan kode0atau3dan 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.
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 / path | Deskripsi |
|---|---|
automatic bash rewrite | Transparan; tidak diperlukan command user. |
RTK_DISABLED=1 | Atur variabel lingkungan ini untuk menonaktifkan penulisan ulang command RTK dan instalasi terkelola untuk sesi ini. |
PI_OFFLINE=1 | Atur variabel lingkungan ini untuk menonaktifkan operasi jaringan saat startup, mencegah pengunduhan biner terkelola. |
Bukti source
src/extensions/rtk.tsRTK source
Yang dapat dilakukan
- Jalankan Selesai seperti biasa; Selesai menyediakan RTK saat diperlukan. Tool call
bashyang kompatibel ditulis ulang secara otomatis. - Setel
RTK_DISABLED=1sebelum menjalankan Selesai untuk melewati rewriter dan instalasi terkelola. - Setel
PI_OFFLINE=1untuk 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.
| Mekanisme | Deskripsi |
|---|---|
rtk rewrite <cmd> | Subproses eksternal yang mengembalikan ekuivalen yang lebih tenang atau menandakan tidak ada rewrite. |
| Hook Bash tool call | Mencegat tool call bash sebelum eksekusi. |
Batasan dan keamanan
- Hanya tool call
bashyang ditulis ulang; tool lain tidak tersentuh. - Command yang sudah diawali
rtkdilewati untuk menghindari rekursi. - Rewrite bersifat advisory: jika
rtk rewritekeluar 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.