Tworzenie i Implementacja Wtyczek

Tworzenie Wtyczki za Pomocą Agenta AI

Zastąp poniższy symbol zastępczy wymagania, a następnie przekaż pełną instrukcję swojemu agentowi kodującemu:

Przeczytaj i postępuj zgodnie z przewodnikiem tworzenia wtyczek Seer dostępnym pod adresem https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Traktuj go jako jedyne źródło prawdy w zakresie architektury, plugin.json, implementacji, walidacji i pakowania. Jeśli przewodnik jest niedostępny, zatrzymaj się i zgłoś to przed kontynuowaniem.

Przed rozpoczęciem jakichkolwiek prac sprawdź poniższe Requirement (Wymaganie). Jeśli brakuje go, jest niezmienionym tekstem zastępczym lub jest zbyt jednoznaczne do zaimplementowania, zadaj jedno pytanie uściślające i poczekaj. Nie domyślaj się brakującego wymagania.

Po wyjaśnieniu wybierz Convert lub DLL i krótko uzasadnij wybór, a następnie zaimplementuj kompletną, możliwą do zainstalowania wtyczkę w bieżącym obszarze roboczym. Nie modyfikuj samego Seera ani nie zatrzymuj się na planie lub fragmentach kodu.

Postępuj zgodnie z każdym mającym zastosowanie krokiem walidacji w przewodniku i zgłoś rzeczywiste wyniki. Uruchom test podglądu w aplikacji Seer, jeśli to możliwe; w przeciwnym razie wyraźnie zaznacz, że weryfikacja w czasie wykonywania nie została przeprowadzona.

Requirement: [ZASTĄP TEN SYMBOL ZASTĘPCZY żądaniem dotyczącym wtyczki.]

Wtyczki Konwersji

Seer traktuje wtyczki konwersji jako zewnętrzne programy wykonawcze. Gdy plik zostanie wywołany, Seer uruchamia skonfigurowany program, przekazując ścieżki plików za pomocą symboli zastępczych.

Zmienne Symboli Zastępczych

• ${input_file}: Bezwzględna ścieżka pliku źródłowego.
• ${output_file}: Podstawowa ścieżka pliku wyjściowego, w której wtyczka powinna zapisać przetworzony wynik (dodaj żądane rozszerzenie, np. ${output_file}.json).
• ${use_backslash}: Opcjonalna flaga formatująca separatory ścieżek przy użyciu natywnych ukośników odwrotnych Windows (\).
• ${seer_dir}: Ścieżka katalogu, w którym znajduje się Seer.exe.
• ${seer_exe}: Bezwzględna ścieżka do Seer.exe.
• ${7z}: Bezwzględna ścieżka do 7z.exe dołączonego do Seer.

Przepływ Wykonania

1. Wywołanie: Użytkownik naciska SPACJĘ na pliku.
2. Rozpoznanie: Seer identyfikuje wtyczkę skojarzoną z rozszerzeniem pliku.
3. Wykonanie: Seer uruchamia plik wykonywalny (np. ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Wyświetlenie: Po zakończeniu procesu Seer odczytuje wygenerowany plik pasujący do ${output_file}.* i wyświetla go za pomocą wewnętrznej przeglądarki odpowiadającej rozszerzeniu wyjściowemu.

Obsługiwane Typy Plików Wykonywalnych i Skryptów

Wtyczką konwersji może być dowolny plik wykonywalny zdolny do obsługi wejścia/wyjścia przez CLI:

• Skrypty:
  • Skrypt CMD: cmd_rename
  • Skrypt BAT: bat_epub
  • Skrypt PowerShell: .ps1 (obsługiwane natywnie za pośrednictwem powershell.exe)
• Narzędzia Zewnętrzne:
  • dll_lib_exports: Narzędzie systemowe Windows
  • ImageMagick
  • exiftool
• Niestandardowe Pliki Binarne:
  • Torrent2Json
  • ApkMetaInfo2Json

Zarządzanie Plikami Tymczasowymi

Wtyczki często generują pliki pośrednie.

• Automatyczne Czyszczenie: Seer domyślnie automatycznie usuwa pliki tymczasowe starsze niż 21 dni.
• Wymuszone Usunięcie: Dodaj ${no_cache} do parametrów polecenia, aby poinstruować Seera o pominięciu pamięci podręcznej konwersji i zapisaniu tymczasowych danych wyjściowych w katalogu automatycznego usuwania (autodel/), który jest automatycznie czyszczony po zamknięciu programu Seer.

Wtyczki DLL

W celu uzyskania wysokiej wydajności lub głębokiej integracji Seer obsługuje wtyczki oparte na bibliotekach DLL napisane w C++/Qt i skompilowane do bibliotek dynamicznych.

Projekty Referencyjne

Zobacz oficjalne repozytoria dotyczące implementacji interfejsu wtyczki: