Sviluppo e Implementazione dei Plugin

Creare un Plugin con un Agente IA

Sostituisci il segnaposto dei requisiti sottostante, quindi fornisci l'istruzione completa al tuo agente di codifica:

Leggi e segui la guida allo sviluppo dei plugin di Seer su https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Considerala come l'unica fonte di verità per l'architettura, plugin.json, l'implementazione, la validazione e il packaging. Se la guida non è disponibile, fermati e segnalalo prima di procedere.

Prima di svolgere qualsiasi lavoro, ispeziona il Requirement (Requisito) sottostante. Se manca, è un testo segnaposto non modificato o è troppo ambiguo per essere implementato, fai una domanda di chiarimento e attendi. Non dedurre il requisito mancante.

Una volta chiarito, scegli Convert o DLL e giustifica brevemente la scelta, quindi implementa un plugin completo e installabile nello spazio di lavoro corrente. Non modificare Seer stesso e non fermarti a un piano o a frammenti di codice.

Segui ogni passaggio di validazione applicabile nella guida e segnala i risultati effettivi. Esegui un test di anteprima all'interno di Seer quando possibile; altrimenti indica esplicitamente che non è stata eseguita alcuna verifica a runtime.

Requirement: [SOSTITUISCI QUESTO SEGNAPOSTO con la richiesta del plugin.]

Plugin di Conversione

Seer tratta i plugin di conversione come esecutori esterni. Quando viene attivato un file, Seer esegue il programma configurato, passando i percorsi dei file tramite segnaposto.

Variabili Segnaposto

• ${input_file}: Percorso assoluto del file sorgente.
• ${output_file}: Percorso di base del file di output in cui il plugin deve salvare il risultato elaborato (aggiungere l'estensione desiderata, es. ${output_file}.json).
• ${use_backslash}: Flag opzionale per formattare i separatori di percorso utilizzando i backslash nativi di Windows (\).
• ${seer_dir}: Percorso della directory in cui risiede Seer.exe.
• ${seer_exe}: Percorso assoluto di Seer.exe.
• ${7z}: Percorso assoluto di 7z.exe fornito con Seer.

Flusso di Lavoro di Esecuzione

1. Attivazione: L'utente preme SPAZIO su un file.
2. Risoluzione: Seer identifica il plugin associato all'estensione del file.
3. Esecuzione: Seer esegue l'eseguibile (es. ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Visualizzazione: Una volta terminato il processo, Seer legge il file generato corrispondente a ${output_file}.* e lo visualizza utilizzando il visualizzatore interno corrispondente all'estensione di output.

Tipi di Eseguibili e Script Supportati

Un plugin di conversione può essere qualsiasi eseguibile in grado di gestire input/output tramite CLI:

• Script:
  • Script CMD: cmd_rename
  • Script BAT: bat_epub
  • Script PowerShell: .ps1 (supportati nativamente tramite powershell.exe)
• Strumenti di Terze Parti:
  • dll_lib_exports: Strumento di sistema Windows
  • ImageMagick
  • exiftool
• Binari Personalizzati:
  • Torrent2Json
  • ApkMetaInfo2Json

Gestione dei File Temporanei

I plugin generano spesso file intermedi.

• Pulizia Automatica: Seer elimina automaticamente i file temporanei più vecchi di 21 giorni per impostazione predefinita.
• Rimozione Forzata: Aggiungi ${no_cache} ai parametri del comando per istruire Seer a ignorare la cache di conversione e salvare l'output temporaneo nella directory di eliminazione automatica (autodel/), che viene pulita automaticamente alla chiusura di Seer.

Plugin DLL

Per prestazioni elevate o integrazione profonda, Seer supporta plugin basati su DLL scritti in C++/Qt e compilati come librerie dinamiche.

Progetti di Riferimento

Fare riferimento a questi repository ufficiali per l'implementazione dell'interfaccia del plugin: