Pengembangan & Implementasi Plugin

Membangun Plugin dengan Agen AI

Ganti teks placeholder persyaratan di bawah ini, lalu berikan instruksi lengkap ke agen pengkodean Anda:

Baca dan ikuti panduan pengembangan plugin Seer di https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Perlakukan itu sebagai sumber kebenaran tunggal untuk arsitektur, plugin.json, implementasi, validasi, dan pengemasan. Jika panduan tidak tersedia, hentikan dan laporkan sebelum melanjutkan.

Sebelum melakukan pekerjaan apa pun, periksa Requirement (Persyaratan) di bawah ini. Jika hilang, teks placeholder belum diubah, atau terlalu kabur untuk diimplementasikan, ajukan satu pertanyaan klarifikasi dan tunggu. Jangan mengira-ngira persyaratan yang hilang.

Setelah jelas, pilih Convert atau DLL dan jelaskan alasannya secara singkat, lalu implementasikan plugin yang lengkap dan dapat diinstal di ruang kerja saat ini. Jangan mengubah Seer itu sendiri atau berhenti pada rencana atau cuplikan kode.

Ikuti setiap langkah validasi yang berlaku dalam panduan dan laporkan hasil sebenarnya. Jalankan pengujian pratinjau dalam aplikasi Seer jika memungkinkan; jika tidak, nyatakan secara eksplisit bahwa verifikasi runtime tidak dilakukan.

Requirement: [GANTI PLACEHOLDER INI dengan permintaan plugin.]

Plugin Konversi

Seer memperlakukan plugin konversi sebagai eksekutor eksternal. Saat file dipicu, Seer menjalankan program yang dikonfigurasi, mengoper jalur file melalui placeholder.

Variabel Placeholder

• ${input_file}: Jalur absolut dari file sumber.
• ${output_file}: Jalur file output dasar tempat plugin harus menyimpan hasil pemrosesan (tambahkan ekstensi yang diinginkan, mis. ${output_file}.json).
• ${use_backslash}: Flag opsional untuk memformat pemisah jalur menggunakan garis miring terbalik Windows native (\).
• ${seer_dir}: Jalur direktori tempat Seer.exe berada.
• ${seer_exe}: Jalur absolut ke Seer.exe.
• ${7z}: Jalur absolut ke 7z.exe yang disertakan dengan Seer.

Alur Kerja Eksekusi

1. Pemicu: Pengguna menekan SPASI pada suatu file.
2. Resolusi: Seer mengidentifikasi plugin yang terkait dengan ekstensi file.
3. Eksekusi: Seer menjalankan file yang dapat dieksekusi (mis. ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Tampilan: Setelah proses selesai, Seer membaca file yang dihasilkan yang cocok dengan ${output_file}.* dan merendernya menggunakan pemirsa internal yang sesuai dengan ekstensi output.

Jenis Eksekutabel & Skrip yang Didukung

Plugin konversi dapat berupa file yang dapat dieksekusi apa pun yang mampu menangani input/output melalui CLI:

• Skrip:
  • Skrip CMD: cmd_rename
  • Skrip BAT: bat_epub
  • Skrip PowerShell: .ps1 (didukung secara langsung melalui powershell.exe)
• Alat Pihak Ketiga:
  • dll_lib_exports: Alat sistem Windows
  • ImageMagick
  • exiftool
• Biner Kustom:
  • Torrent2Json
  • ApkMetaInfo2Json

Manajemen File Sementara

Plugin sering kali menghasilkan file perantara.

• Pembersihan Otomatis: Seer secara otomatis menghapus file sementara yang lebih tua dari 21 hari secara default.
• Penghapusan Paksa: Tambahkan ${no_cache} ke parameter perintah Anda untuk menginstruksikan Seer agar melewati cache konversi dan menyimpan output sementara ke direktori hapus otomatis (autodel/), yang dibersihkan secara otomatis saat Seer keluar.

Plugin DLL

Untuk performa tinggi atau integrasi mendalam, Seer mendukung plugin berbasis DLL yang ditulis dalam C++/Qt dan dikompilasi menjadi pustaka dinamis.

Proyek Referensi

Lihat repositori resmi berikut untuk implementasi antarmuka plugin: