تطوير وإضافة الملحقات

إنشاء ملحق باستخدام وكيل الذكاء الاصطناعي

استبدل نصوص الملحق أدناه، ثم أعطِ التعليمات الكاملة لوكيل البرمجة الخاص بك:

اقرأ واتبع دليل تطوير ملحقات 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 والمجمعة في مكتبات ديناميكية.

المشاريع المرجعية

يرجى الرجوع إلى المستودعات الرسمية التالية لتنفيذ واجهة الملحق: