Розробка та реалізація плагінів

Створення плагіна за допомогою AI-агента

Замініть заповнювач вимог нижче, а потім дайте повну інструкцію вашому агенту кодування:

Прочитайте та дотримуйтесь посібника з розробки плагінів Seer на сторінці https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Ставтеся до нього як до єдиного джерела правди щодо архітектури, plugin.json, реалізації, перевірки та пакування. Якщо посібник недоступний, зупиніться та повідомте про це перед продовженням.

Перед виконанням будь-якої роботи перевірте Requirement (Вимогу) нижче. Якщо вона відсутня, є незміненим текстом заповнювача або занадто нечіткою для реалізації, поставте одне уточнююче запитання та зачекайте. Не додумуйте відсутню вимогу.

Після прояснення виберіть Convert або DLL та коротко обґрунтуйте вибір, потім реалізуйте повний плагін, придатний для встановлення, у поточному робочому просторі. Не змінюйте сам Seer і не зупиняйтеся на плані чи фрагментах коду.

Дотримуйтесь кожного застосовного кроку перевірки в посібнику та повідомте про фактичні результати. За можливості запустіть тест попереднього перегляду в програмі Seer; в іншому випадку чітко вкажіть, що перевірка під час виконання не проводилася.

Requirement: [ЗАМІНІТЬ ЦЕЙ ЗАПОВНЮВАЧ запитом до плагіна.]

Плагіни конвертації

Seer ставиться до плагінів конвертації як до зовнішніх виконавчих програм. Під час виклику файлу Seer виконує налаштовану програму, передаючи шляхи до файлів через заповнювачі.

Змінні заповнювачів

• ${input_file}: Абсолютний шлях до вихідного файлу.
• ${output_file}: Базовий шлях до вихідного файлу, куди плагін має зберегти оброблений результат (додайте бажане розширення, наприклад ${output_file}.json).
• ${use_backslash}: Необов'язковий прапорець для форматування розділювачів шляхів за допомогою зворотних слешів Windows (\).
• ${seer_dir}: Шлях до каталогу, де розташований Seer.exe.
• ${seer_exe}: Абсолютний шлях до Seer.exe.
• ${7z}: Абсолютний шлях до 7z.exe, що постачається разом із Seer.

Робочий процесс виконання

1. Виклик: Користувач натискає ПРОБІЛ на файлі.
2. Розпізнавання: Seer визначає плагін, пов'язаний із розширенням файлу.
3. Виконання: Seer запускає виконуваний файл (наприклад, ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Відображення: Після завершення процесу Seer зчитує згенерований файл, що відповідає ${output_file}.*, і відображає його за допомогою внутрішнього переглядача, що відповідає вихідному розширенню.

Підтримувані типи виконуваних файлів і скриптів

Плагіном конвертації може бути будь-який виконуваний файл, здатний обробляти вхід/вихід через CLI:

• Скрипти:
  • CMD-скрипт: cmd_rename
  • BAT-скрипт: bat_epub
  • Скрипт PowerShell: .ps1 (підтримуються "з коробки" через powershell.exe)
• Сторонні утиліти:
  • dll_lib_exports: Системна утиліта Windows
  • ImageMagick
  • exiftool
• Спеціальні бінарні файли:
  • Torrent2Json
  • ApkMetaInfo2Json

Управління тимчасовими файлами

Плагіни часто створюють проміжні файли.

• Автоматичне очищення: За замовчуванням Seer автоматично видаляє тимчасові файли, старіші за 21 день.
• Примусове видалення: Додайте ${no_cache} до параметрів вашої команди, щоб наказати Seer обходити кеш конвертації та зберігати тимчасовий вихід у каталог автоматичного видалення (autodel/), який автоматично очищається під час виходу з Seer.

DLL плагіни

Для високої продуктивності або глибокої інтеграції Seer підтримує плагіни на базі DLL, написані на C++/Qt і скомпільовані в динамічні бібліотеки.

Проєкти посилань

Зверніться до цих офіційних репозиторіїв для реалізації інтерфейсу плагіна: