Phát triển & Triển khai Plugin

Xây dựng Plugin với Agent AI

Thay thế văn bản giữ chỗ yêu cầu bên dưới, sau đó đưa hướng dẫn đầy đủ cho agent lập trình của bạn:

Đọc và làm theo hướng dẫn phát triển plugin Seer tại https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Coi đây là nguồn sự thật duy nhất cho kiến trúc, plugin.json, triển khai, xác minh và đóng gói. Nếu hướng dẫn không khả dụng, hãy dừng lại và báo cáo trước khi tiếp tục.

Trước khi thực hiện bất kỳ công việc nào, hãy kiểm tra Requirement (Yêu cầu) bên dưới. Nếu nó thiếu, là văn bản giữ chỗ chưa thay đổi hoặc quá mơ hồ để triển khai, hãy đặt một câu hỏi làm rõ và chờ đợi. Không suy đoán yêu cầu bị thiếu.

Sau khi rõ ràng, hãy chọn Convert hoặc DLL và biện minh ngắn gọn cho lựa chọn, sau đó triển khai một plugin hoàn chỉnh, có thể cài đặt trong không gian làm việc hiện tại. Không sửa đổi bản thân Seer hoặc dừng lại ở kế hoạch hay đoạn mã.

Làm theo từng bước xác minh áp dụng trong hướng dẫn và báo cáo kết quả thực tế. Chạy thử nghiệm xem trước trong ứng dụng Seer khi có thể; nếu không, hãy tuyên bố rõ ràng rằng xác minh runtime không được thực hiện.

Requirement: [THAY THẾ VĂN BẢN GIỮ CHỖ NÀY bằng yêu cầu plugin.]

Plugin Chuyển đổi

Seer coi các plugin chuyển đổi là các chương trình thực thi bên ngoài. Khi một tệp được kích hoạt, Seer sẽ thực thi chương trình đã cấu hình, truyền đường dẫn tệp qua các biến giữ chỗ.

Biến Giữ chỗ

• ${input_file}: Đường dẫn tuyệt đối của tệp nguồn.
• ${output_file}: Đường dẫn tệp đầu ra cơ sở nơi plugin sẽ lưu kết quả đã xử lý (thêm phần mở rộng mong muốn, ví dụ ${output_file}.json).
• ${use_backslash}: Cờ tùy chọn để định dạng trình phân cách đường dẫn bằng dấu gạch chéo ngược Windows bản địa (\).
• ${seer_dir}: Đường dẫn thư mục nơi Seer.exe tọa lạc.
• ${seer_exe}: Đường dẫn tuyệt đối đến Seer.exe.
• ${7z}: Đường dẫn tuyệt đối đến 7z.exe đi kèm với Seer.

Quy trình Thực thi

1. Kích hoạt: Người dùng nhấn DẤU CÁCH trên một tệp.
2. Phân giải: Seer xác định plugin được liên kết với phần mở rộng tệp.
3. Thực thi: Seer chạy tệp thực thi (ví dụ ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json").
4. Hiển thị: Sau khi quá trình kết thúc, Seer đọc tệp đã tạo khớp với ${output_file}.* và hiển thị tệp đó bằng trình xem nội bộ tương ứng với phần mở rộng đầu ra.

Các Loại Tệp Thực thi & Script Được Hỗ trợ

Plugin chuyển đổi có thể là bất kỳ tệp thực thi nào có khả năng xử lý đầu vào/đầu ra qua CLI:

• Script:
  • Script CMD: cmd_rename
  • Script BAT: bat_epub
  • Script PowerShell: .ps1 (được hỗ trợ sẵn qua powershell.exe)
• Công cụ Bên thứ ba:
  • dll_lib_exports: Công cụ hệ thống Windows
  • ImageMagick
  • exiftool
• Tệp Nhị phân Tùy chỉnh:
  • Torrent2Json
  • ApkMetaInfo2Json

Quản lý Tệp Tạm thời

Các plugin thường tạo ra các tệp trung gian.

• Tự động Dọn dẹp: Seer tự động xóa các tệp tạm thời cũ hơn 21 ngày theo mặc định.
• Bắt buộc Xóa: Thêm ${no_cache} vào các tham số lệnh của bạn để yêu cầu Seer bỏ qua bộ nhớ tạm chuyển đổi và lưu đầu ra tạm thời vào thư mục tự động xóa (autodel/), thư mục này sẽ tự động được dọn dẹp khi Seer thoát.

Plugin DLL

Để có hiệu suất cao hoặc tích hợp sâu, Seer hỗ trợ các plugin dựa trên DLL được viết bằng C++/Qt và biên dịch thành thư viện động.

Dự án Tham khảo

Tham khảo các kho lưu trữ chính thức này để biết cách triển khai giao diện plugin: