Développement et Implémentation de Plugins

Créer un Plugin avec un Agent IA

Remplacez le texte d'emplacement de la demande ci-dessous, puis donnez l'instruction complète à votre agent de codage :

Lisez et suivez le guide de développement de plugins Seer sur https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Considérez-le comme la source unique de vérité pour l'architecture, plugin.json, l'implémentation, la validation et l'empaquetage. Si le guide n'est pas disponible, arrêtez-vous et signalez-le avant de continuer.

Avant tout travail, inspectez la Requirement (Exigence) ci-dessous. Si elle est manquante, inchangée ou trop ambiguë pour être implémentée, posez une question de clarification et attendez. N'induisez pas l'exigence manquante.

Une fois cela clarifié, choisissez Convert ou DLL et justifiez brièvement ce choix, puis implémentez un plugin complet et installable dans l'espace de travail actuel. Ne modifiez pas Seer lui-même et ne vous arrêtez pas à un plan ou à des extraits de code.

Suivez chaque étape de validation applicable dans le guide et signalez les résultats réels. Exécutez un test de prévisualisation dans l'application Seer si possible ; sinon, indiquez explicitement que la vérification à l'exécution n'a pas été effectuée.

Requirement: [REMPLACEZ CE TEXTE D'EMPLACEMENT par la demande de plugin.]

Plugins de Conversion

Seer traite les plugins de conversion comme des exécuteurs externes. Lorsqu'un fichier est déclenché, Seer exécute le programme configuré en passant les chemins de fichiers via des variables d'emplacement.

Variables d'Emplacement

• ${input_file} : Chemin absolu du fichier source.
• ${output_file} : Chemin de base du fichier de sortie où le plugin doit enregistrer le résultat traité (ajoutez l'extension souhaitée, ex. ${output_file}.json).
• ${use_backslash} : Indicateur optionnel pour formater les séparateurs de chemin en antislashs Windows natifs (\).
• ${seer_dir} : Chemin du répertoire où se trouve Seer.exe.
• ${seer_exe} : Chemin absolu de Seer.exe.
• ${7z} : Chemin absolu de 7z.exe fourni avec Seer.

Flux d'Exécution

1. Déclenchement : L'utilisateur appuie sur ESPACE sur un fichier.
2. Résolution : Seer identifie le plugin associé à l'extension du fichier.
3. Exécution : Seer lance l'exécutable (ex. ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Affichage : Une fois le processus terminé, Seer lit le fichier généré correspondant à ${output_file}.* et le rend à l'aide de la visionneuse interne appropriée.

Types d'Exécutables et de Scripts Pris en Charge

Un plugin de conversion peut être n'importe quel exécutable capable de gérer les entrées/sorties via la CLI :

• Scripts :
  • Script CMD : cmd_rename
  • Script BAT : bat_epub
  • Script PowerShell : .ps1 (pris en charge nativement via powershell.exe)
• Outils Tiers :
  • dll_lib_exports : Outil système Windows
  • ImageMagick
  • exiftool
• Binaires Personnalisés :
  • Torrent2Json
  • ApkMetaInfo2Json

Gestion des Fichiers Temporaires

Les plugins génèrent souvent des fichiers intermédiaires.

• Nettoyage Automatique : Seer purge automatiquement les fichiers temporaires de plus de 21 jours par défaut.
• Suppression Forcée : Ajoutez ${no_cache} aux paramètres de votre commande pour demander à Seer de contourner le cache de conversion et d'enregistrer la sortie temporaire dans le répertoire de suppression automatique (autodel/), qui est vidé à la fermeture de Seer.

Plugins DLL

Pour des performances élevées ou une intégration poussée, Seer prend en charge les plugins DLL écrits en C++/Qt et compilés sous forme de bibliothèques dynamiques.

Projets de Référence

Reportez-vous à ces dépôts officiels pour l'implémentation de l'interface du plugin :