Plugin Agen AI Pengelola File Android: Izin, Pratinjau, dan Persetujuan

Tugas berkas yang dapat disusun oleh agen AI

Plugin agen AI pengelola file Android membantu mengubah permintaan sehari-hari menjadi operasi berkas yang terstruktur. Pengguna dapat meminta daftar isi folder, mencari nama tertentu, membaca teks dengan batas ukuran, membuat berkas atau folder, menulis teks, mengganti nama, menghapus, dan mengunduh berkas HTTPS ke penyimpanan eksternal.

Nilai agen muncul ketika tugas mengandung beberapa ketentuan. Permintaan “cari semua kuitansi PDF di Downloads dari bulan ini dan tampilkan daftarnya” perlu diterjemahkan menjadi folder awal, pola pencarian, jenis berkas, dan hasil yang hanya dibaca. Belum ada perubahan terhadap penyimpanan. Pengguna dapat memeriksa daftar sebelum meminta pemindahan atau penggantian nama.

Membaca teks juga memiliki batas maxBytes. Batas tersebut menjaga agar operasi tidak memuat berkas besar tanpa kendali. Jika teks terpotong, hasil perlu menyatakan jumlah yang dibaca atau meminta pengguna memperbesar batas dengan sadar. Berkas biner tidak boleh diperlakukan sebagai teks hanya karena namanya cocok dengan pencarian.

Pembuatan berkas memiliki kontrak yang berbeda dari penulisan. Operasi membuat berkas tidak menimpa target yang sudah ada. Jika nama yang diminta telah digunakan, agen perlu menampilkan konflik dan meminta nama baru. Penulisan teks, pembuatan folder, serta penggantian nama tunggal juga harus menyebut jalur asal dan tujuan agar hasilnya dapat diperiksa.

Indeks plugin resmi FoneClaw mencantumkan File Manager Plugin 0.0.4 dengan 13 alat dan kebutuhan host minimum FoneClaw yang kompatibel saat ini. Jumlah tersebut merupakan kontrak paket versi ini; kualitas penggunaan tetap ditentukan oleh ketepatan jalur, izin, persetujuan, konflik, dan hasil operasi.

File Manager sebagai plugin Android terpisah

File Manager bukan alat bawaan FoneClaw. Ia merupakan plugin Android dengan APK, nama paket, penanda tangan, izin, dan kumpulan alat sendiri. Nama paket publiknya adalah ai.android.claw.plugin.device.filemanager. Pemisahan ini memungkinkan pengguna memeriksa sumber dan cakupan paket sebelum menambahkan kemampuan pengelolaan berkas.

Model FoneClaw memahami permintaan dan menyusun langkah. Host FoneClaw menemukan serta mendaftarkan alat yang diumumkan oleh APK plugin setelah pemasangan. Plugin kemudian menjalankan operasi berkas sesuai kontrak alat dan izin Android yang tersedia. Dengan susunan ini, kemampuan model, kewenangan host, dan akses plugin tetap dapat dibedakan.

Paket File Manager meminta MANAGE_EXTERNAL_STORAGE dan INTERNET. Akses penyimpanan diperlukan untuk operasi berkas dalam cakupan yang didukung, sedangkan jaringan digunakan untuk unduhan HTTPS. Daftar izin tersebut perlu muncul pada usulan pemasangan sehingga pengguna dapat menilai apakah manfaat plugin sepadan dengan akses yang diminta.

Sumber paket juga harus dapat diverifikasi. Repositori resmi FoneClaw menjadi rujukan publik untuk arsitektur host, plugin, serta dokumentasi yang terkait. Metadata indeks menetapkan versi 0.0.4 sebagai paket terkini dalam kontrak ini. Jika panduan prose plugin masih menyebut 0.0.3, nomor dalam indeks resmi paket menjadi acuan pemasangan saat ini.

Plugin lain dapat memakai pola pemasangan serupa tetapi membawa izin dan alat berbeda. Contoh terpisah tersedia di FoneClaw Gratis: Plugin Pengunduh YouTube Lokal di Android, Format, jobId, dan Persetujuan. Memahami batas paket membantu pengguna tidak menyamakan fungsi sebuah plugin dengan seluruh kemampuan bawaan FoneClaw.

All files access, akar penyimpanan, dan cakupan jalur

MANAGE_EXTERNAL_STORAGE, yang biasanya dikenal sebagai All files access, memberi aplikasi jalur luas terhadap penyimpanan eksternal yang dapat dijangkau Android. Izin ini diperlukan oleh File Manager untuk menjalankan operasi lintas folder dalam cakupan paket. Namun izin sistem hanya menentukan apakah operasi teknis memungkinkan; izin tersebut bukan persetujuan untuk setiap perintah agen.

Setiap tugas tetap perlu menetapkan akar dan jalur relatif. Permintaan “cari laporan” terlalu luas bila perangkat menyimpan banyak folder pribadi dan kerja. Instruksi yang lebih baik adalah “cari berkas PDF dengan kata laporan di Documents/Proyek, tanpa membuka folder lain”. Agen dapat menampilkan jalur pencarian dan jumlah hasil sebelum membaca isi.

Jalur relatif juga digunakan untuk tujuan unduhan. Alih-alih menerima lokasi bebas yang tidak jelas, plugin menempatkan tujuan terhadap akar penyimpanan eksternal. Pengguna perlu melihat jalur akhir seperti Download/Laporan/agustus.pdf, bukan sekadar nama berkas. Normalisasi jalur harus mencegah tujuan keluar dari akar yang diizinkan.

Membaca isi dapat menyentuh catatan pribadi, konfigurasi, atau data kerja. Karena itu, daftar dan pencarian dapat dipakai lebih dahulu untuk mempersempit target. Setelah berkas dipilih, operasi baca menampilkan jalur serta batas maxBytes. Langkah ini mengurangi konteks yang dikirim ke model dan memudahkan pengguna memastikan berkas yang benar.

Persetujuan mengikuti operasi, bukan hanya izin aplikasi. Pemeriksaan status plugin dapat berlangsung sebagai tindakan berisiko rendah, sedangkan operasi lain membutuhkan persetujuan sesuai kontraknya. Penghapusan dan penerapan penggantian nama massal diperlakukan sebagai tindakan destruktif. Hubungan antara Skills, alat, dan izin saat tugas berjalan dibahas dalam Keamanan Skill AI Agent: Mengapa Phone Agent Perlu Cek Izin Saat Berjalan.

Pratinjau sebelum penggantian nama massal

Penggantian nama massal dapat mengubah banyak jalur sekaligus, sehingga File Manager memisahkan perencanaan dari penerapan. Langkah pertama membuat pratinjau yang berisi pasangan nama asal dan tujuan. Plugin kemudian mengembalikan previewToken yang diperlukan untuk menjalankan perubahan tersebut.

Misalnya, sebuah folder berisi IMG_1001.jpg, IMG_1002.jpg, dan IMG_1003.jpg. Pengguna meminta pola nama Acara-001.jpg dan seterusnya. Pratinjau perlu menunjukkan setiap pasangan, folder target, jumlah berkas, serta konflik bila salah satu nama tujuan sudah ada. Tidak ada nama yang berubah pada tahap ini.

previewToken mengikat penerapan ke pratinjau tertentu. Token mencegah agen menjalankan daftar perubahan yang berbeda dari yang baru saja dilihat pengguna. Jika folder berubah, berkas baru muncul, target hilang, atau token tidak lagi berlaku, plugin perlu menghentikan penerapan dan membuat pratinjau baru.

Pemisahan ini juga mengatasi instruksi ambigu. Permintaan “rapikan semua nama foto” belum menjelaskan urutan, pola, ekstensi, atau perlakuan terhadap konflik. Agen dapat menyusun usulan, tetapi pengguna memperoleh keputusan konkret setelah melihat daftar hasil. Persetujuan penerapan kemudian merujuk pada token, target, dan versi pratinjau yang sama.

Setelah perubahan dilakukan, hasil yang diamati perlu dibandingkan dengan rencana. Laporan sebaiknya menyebut berkas yang berhasil diubah, berkas yang gagal, konflik yang muncul, dan jalur akhirnya. Persetujuan serta catatan tindakan yang terikat pada alat dibahas lebih lanjut di Identitas Agen AI: Izin, Persetujuan per Alat, dan Jejak Audit Phone Agent.

Penghapusan permanen, unduhan HTTPS, dan verifikasi hasil

Penghapusan pada versi awal File Manager bersifat permanen. Operasi ini tidak memakai tempat sampah dan tidak menyediakan undo. Karena itu, layar persetujuan perlu menyebut jalur lengkap, jenis target, jumlah item, dan sifat permanennya sebelum tindakan dijalankan.

Untuk folder, pengguna juga perlu mengetahui apakah target berisi berkas lain. Daftar isi dapat diperiksa lebih dahulu sehingga penghapusan tidak hanya berdasarkan nama folder. Jika target berubah setelah peninjauan, operasi sebaiknya dihentikan dan daftar terbaru ditampilkan. Salinan cadangan perlu dibuat sebelum menghapus data yang tidak dapat diganti.

Unduhan menerima URL HTTPS dan menyimpan hasil ke jalur relatif dalam penyimpanan eksternal. Skema HTTPS membatasi sumber jaringan yang dapat diterima oleh alat, tetapi pengguna tetap perlu memeriksa domain, nama berkas, tipe konten, serta folder tujuan. Izin INTERNET memungkinkan koneksi; keputusan untuk mengunduh tetap mengikuti tugas yang disetujui.

Konflik tujuan harus terlihat sebelum atau melalui hasil operasi. Jika berkas bernama sama sudah ada, agen tidak boleh menyatakan keberhasilan tanpa menjelaskan apakah operasi ditolak, menggunakan nama lain, atau mengikuti perilaku kontrak yang ditampilkan plugin. Untuk pembuatan berkas, kontraknya jelas: target yang sudah ada tidak ditimpa.

Sesudah menulis atau mengunduh, verifikasi hasil melalui daftar folder dan metadata berkas. Periksa jalur akhir, nama, ukuran, dan keberadaan target. Untuk teks, baca bagian kecil bila diperlukan. Keberhasilan permintaan jaringan belum membuktikan bahwa berkas tersimpan lengkap di lokasi yang dimaksud.

All files access juga perlu ditinjau dari kesehatan perangkat secara keseluruhan. Panduan Pemeriksaan Kesehatan Ponsel Android dengan AI: Izin Sensitif, Akses Khusus, dan Aplikasi Tersembunyi membantu pengguna memeriksa kembali aplikasi yang memiliki akses khusus setelah kebutuhan plugin selesai.

Dari pencarian metadata hingga tugas pertama

Alur pemasangan dimulai dari metadata resmi. plugin_search mencari paket dalam katalog resmi dan mengembalikan informasi yang tersedia; tindakan ini tidak memasang plugin. Pengguna dapat memeriksa nama paket, versi 0.0.4, versi host minimum, izin, alat, sumber, dan informasi verifikasi sebelum melanjutkan.

Berikutnya, plugin_request_install membuat usulan pemasangan yang terlihat. Perintah tersebut belum mengunduh atau memasang APK. Home menampilkan proposal agar pengguna dapat meninjau sumber, paket, penanda tangan yang diharapkan, hash paket, serta izin MANAGE_EXTERNAL_STORAGE dan INTERNET.

Setelah pengguna menerima proposal, host menjalankan pemasangan melalui jalur yang didukung dan memeriksa metadata paket serta penanda tangan. Alat File Manager baru didaftarkan setelah APK terpasang dan dikenali. Pemisahan ini mencegah hasil pencarian metadata dianggap sebagai plugin yang sudah aktif.

Pemberian All files access dilakukan melalui pengaturan Android yang terlihat. Setelah kembali ke FoneClaw, periksa status plugin dan daftar alat yang terdaftar. Jika izin ditolak, tugas pengelolaan berkas perlu berhenti dengan penjelasan, sementara pengguna tetap dapat membatalkan pemasangan atau memberikan akses kemudian.

Tugas pertama sebaiknya hanya membaca. Gunakan instruksi seperti “tampilkan lima berkas terbaru di Download/Uji tanpa membuka isinya”. Periksa apakah jalur, jumlah hasil, nama, dan status izin benar. Lanjutkan dengan membuat folder kosong, lalu pastikan folder tersebut benar-benar muncul.

Setelah operasi dasar berhasil, uji penulisan berkas contoh dan penggantian nama tunggal. Penggantian nama massal dapat dicoba pada salinan berkas dengan pratinjau serta previewToken. Simpan penghapusan permanen untuk tahap terakhir dan gunakan hanya pada data uji yang sudah memiliki salinan.

Menguji kepercayaan paket, konflik, catatan, dan penghapusan plugin

Evaluasi plugin pengelola berkas perlu mencakup seluruh perjalanan, bukan hanya keberhasilan satu perintah. Mulailah dengan folder uji yang berisi beberapa berkas teks dan gambar salinan. Dengan data tersebut, pengguna dapat memeriksa pencarian, batas baca, konflik, pratinjau, persetujuan, serta hasil tanpa membahayakan dokumen utama.

• Sumber paket: pastikan metadata berasal dari indeks resmi dan nama paketnya ai.android.claw.plugin.device.filemanager.
• Versi dan host: cocokkan File Manager 0.0.4 dengan host FoneClaw yang kompatibel saat ini.
• Identitas APK: periksa paket, penanda tangan yang diharapkan, dan hash sebelum pemasangan.
• Izin: pahami alasan All files access dan jaringan diminta, lalu tinjau kembali izin setelah pengujian.
• Cakupan jalur: gunakan akar dan jalur relatif yang jelas; hindari pencarian seluruh penyimpanan ketika satu folder sudah cukup.
• Batas pembacaan: tetapkan maxBytes yang sesuai dan pastikan hasil menandai teks yang terpotong.
• Konflik: uji pembuatan berkas dengan nama yang sudah ada dan pastikan tidak terjadi penimpaan.
• Pratinjau: cocokkan seluruh pasangan nama sebelum menyetujui penerapan dengan previewToken.
• Penghapusan: gunakan berkas uji, periksa jalur lengkap, dan perlakukan hasil sebagai permanen.
• Unduhan: gunakan HTTPS, periksa domain dan tujuan relatif, lalu verifikasi nama serta ukuran hasil.
• Catatan tindakan: pastikan operasi, target, keputusan, hasil, dan kegagalan dapat ditinjau.
• Pemulihan: siapkan salinan cadangan untuk data penting dan jangan mengandalkan undo dari plugin.
• Penghapusan plugin: setelah tidak diperlukan, hapus plugin dan cabut All files access melalui pengaturan Android.

Uji terakhir adalah kegagalan yang disengaja. Gunakan jalur yang tidak ada, tolak izin, buat konflik nama, atau ubah isi folder setelah pratinjau. Plugin agen AI pengelola file Android yang dapat dipercaya perlu mengembalikan kegagalan yang jelas, mempertahankan target lain, dan memberi pengguna langkah perbaikan yang konkret.

Di FoneClaw, kami menjaga pemasangan sebagai proposal yang terlihat, memverifikasi identitas paket, mendaftarkan alat dari APK yang benar-benar terpasang, dan mempertahankan persetujuan untuk tindakan yang mengubah data. Dengan kontrak ini, agen dapat membantu pekerjaan berkas yang nyata tanpa menyamarkan sumber paket, cakupan akses, atau hasil operasinya.