Desarrollo e Implementación de Plugins

Construir un Plugin con un Agente de IA

Reemplace el marcador de posición de requisito a continuación y proporcione la instrucción completa a su agente de programación:

Lea y siga la guía de desarrollo de plugins de Seer en https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Trátela como la única fuente de verdad para arquitectura, plugin.json, implementación, validación y empaquetado. Si la guía no está disponible, deténgase y repórtelo antes de continuar.

Antes de realizar cualquier trabajo, inspeccione la Requirement (Requisito) a continuación. Si falta, es un texto de relleno no modificado o es demasiado ambigua para implementarla, haga una pregunta de aclaración y espere. No infiera el requisito faltante.

Una vez aclarado, elija Convert o DLL y justifique brevemente la elección, luego implemente un plugin completo e instalable en el espacio de trabajo actual. No modifique Seer en sí ni se detenga en un plan o fragmentos de código.

Siga cada paso de validación aplicable en la guía y reporte los resultados reales. Ejecute una prueba de vista previa dentro de Seer cuando sea posible; de lo contrario, declare explícitamente que no se realizó la verificación en tiempo de ejecución.

Requirement: [REEMPLACE ESTE MARCADOR DE POSICIÓN con la solicitud del plugin.]

Plugins de Conversión

Seer trata los plugins de conversión como ejecutores externos. Cuando se activa un archivo, Seer ejecuta el programa configurado, pasando las rutas de los archivos mediante marcadores de posición.

Variables de Marcador de Posición

• ${input_file}: Ruta absoluta del archivo de origen.
• ${output_file}: Ruta base del archivo de salida donde el plugin debe guardar el resultado procesado (añada la extensión deseada, ej. ${output_file}.json).
• ${use_backslash}: Indicador opcional para formatear los separadores de ruta usando barras invertidas nativas de Windows (\).
• ${seer_dir}: Ruta del directorio donde reside Seer.exe.
• ${seer_exe}: Ruta absoluta a Seer.exe.
• ${7z}: Ruta absoluta a 7z.exe incluido con Seer.

Flujo de Trabajo de Ejecución

1. Activación: El usuario presiona ESPACIO sobre un archivo.
2. Resolución: Seer identifica el plugin asociado con la extensión del archivo.
3. Ejecución: Seer ejecuta el programa (ej. ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Visualización: Una vez que el proceso finaliza, Seer lee el archivo generado que coincide con ${output_file}.* y lo muestra utilizando el visor interno correspondiente a la extensión de salida.

Tipos de Ejecutables y Scripts Admitidos

Un plugin de conversión puede ser cualquier ejecutable capaz de procesar entrada/salida a través de la CLI:

• Scripts:
  • Script CMD: cmd_rename
  • Script BAT: bat_epub
  • Script PowerShell: .ps1 (admitido de forma nativa a través de powershell.exe)
• Herramientas de Terceros:
  • dll_lib_exports: Herramienta del sistema Windows
  • ImageMagick
  • exiftool
• Binarios Personalizados:
  • Torrent2Json
  • ApkMetaInfo2Json

Gestión de Archivos Temporales

Los plugins suelen generar archivos intermedios.

• Limpieza Automática: Seer purga automáticamente los archivos temporales de más de 21 días de forma predeterminada.
• Eliminación Forzada: Añada ${no_cache} a los parámetros de su comando para indicar a Seer que omita el almacenamiento en caché de conversión y guarde la salida temporal en el directorio de eliminación automática (autodel/), que se limpia automáticamente al salir de Seer.

Plugins DLL

Para un alto rendimiento o una integración profunda, Seer admite plugins basados en DLL escritos en C++/Qt e integrados como bibliotecas dinámicas.

Proyectos de Referencia

Consulte estos repositorios oficiales para la implementación de la interfaz del plugin: