مركز الدعم الفني
أسئلة شائعة، دليل التثبيت والنشر، دليل التكامل SDK، استكشاف الأخطاء وإصلاحها
التنقل السريع
اختر الموضوع الذي تريد الاطلاع عليه
الأسئلة الشائعة
أسئلة شائعة وأجوبتها
كيف أختار إصدار المنتج المناسب؟
اختر الإصدار حسب السيناريو:
- نسخة سطح المكتب: للمستخدمين الأفراد، يدعم Windows/macOS/Linux، الضغط محلي والخصوصية مضمونة، يلبي احتياجات المكتب اليومي، انظر سيناريو المكتب الشخصي.
- النسخة الخادمية: للمؤسسات الصغيرة والمتوسطة أو النشر على خادم واحد، يوفر واجهة API REST، يلبي احتياجات الأنظمة الداخلية للضغط.
- النسخة الشبكية: للمؤسسات الكبيرة، نشر خدمات مصغرة Docker/K8s، توسع وتقلص مرن HPA، يلبي احتياجات الأرشفة واسعة النطاق، انظر سيناريو المؤسسات.
- SDK: للمطورين الذين يحتاجون لتضمين قدرة الضغط في أنظمةهم الخاصة، عبر واجهة C ABI للتكامل متعدد اللغات.
ما هي متطلبات النظام لنسخة سطح المكتب؟
- Windows: Windows 10/11 (x64)
- macOS: macOS 10.15+ (يدعم Intel وسلسلة M من Apple Silicon)
- Linux: Ubuntu 20.04+ أو Debian 11+ أو التوزيعات المتوافقة (يدعم x64 وARM64)
- الذاكرة: 2GB على الأقل، يُنصح بـ 4GB
- مساحة القرص: 200MB لمسار التثبيت
ما هي الاعتمادات الخارجية المطلوبة؟
الاعتمادات الخارجية اللازمة حسب نوع الصيغة:
- PDF: يحتاج لتثبيت
Ghostscript(الأمرgs) - الفيديو/الصوت: يحتاج لتثبيت مكتبات
FFmpeg(تتضمنها حزمة تثبيت نسخة سطح المكتب) - الصور/Office/OFD/النصوص: لا حاجة لأدوات خارجية، تعتمد على مكتبات Rust المدمجة
لمزيد من التفاصيل، انظر قائمة صيغ الملفات المدعومة.
كيف يتم التحقق من الترخيص؟ هل يحتاج لاتصال بالإنترنت؟
آلية التحقق من الترخيص تختلف حسب الإصدار:
- نسخة سطح المكتب: التحقق من الاشتراك عبر الإنترنت، ويتحقق محلياً من خلال MD5 ورمز الجهاز، فقط في كل مرة تشغيل للتحقق من حالة الاشتراك.
- النسخة الخادمية/الشبكية: التحقق من الترخيص عبر الإنترنت، التحقق من ترخيص ، يلزم الاتصال بخادم الترخيص. يدعم التحقق غير المتصل قصير المدى (وضع السماح).
تتم جميع عمليات الضغط محلياً، ولا يتضمن الاتصال بالخادم محتوى الملفات.
ما هي قيود النسخة المجانية؟
قيود النسخة المجانية من سطح المكتب:
- صورة واحدة ≤ 5MB
- مستند واحد ≤ 10MB
- 10 عمليات ضغط يومياً
- دعم جميع الصيغ
الاشتراك الشهري ($9.9/شهر) أو السنوي ($98/سنة) يرفع جميع القيود.
هل يدعم النشر الخاص / بيئة الامتثال التنظيمي PDPL؟
نعم، النسخة الخادمية والشبكية تدعمان النشر الخاص بالكامل، جميع المكونات منشورة محلياً. كما أتممنا تكييف التوافق مع أطر الامتثال التنظيمي PDPL، متوافقون مع:
- أنظمة تشغيل Linux المؤسسية المعتمدة
- معالجات ARM المؤسسية (aarch64)
- قواعد البيانات المتوافقة مع المعايير المعتمدة
- البرمجيات الوسيطة للرسائل المعتمدة
لمزيد من التفاصيل، انظر سيناريو إدارة وثائق القطاع الحكومي.
كيف أقوم بضغط دفعي للأدلة؟
دعم الضغط الدفعي للأدلة في جميع الإصدارات:
- نسخة سطح المكتب: اسحب وأفلت المجلد في النافذة، أو اختر "تحديد دليل" لتحديد المجلد، وستتم معالجة جميع الملفات في الدليل عودياً.
- النسخة الخادمية/الشبكية: استدعِ API ومرر المسار كدليل، وستتم المعالجة العودية لجميع الملفات.
- SDK: استدعِ
compress_directoryلتمرير مسار الدليل.
يحافظ الضغط الدفعي على هيكل الدليل، والإخراج يطابق بنية الدليل الأصلية.
دليل التثبيت والنشر
خطوات التثبيت لكل إصدار
تثبيت نسخة سطح المكتب
- حمّل حزمة التثبيت من مركز التحميل
- Windows: انقر مرتين على
.exeللتثبيت - macOS: افتح
.dmgواسحب الأيقونة إلى التطبيقات - Linux: ثبّت
.debأو امنح صلاحية التنفيذ لـ.AppImageوشغّله - عند أول تشغيل سجل حساباً وابدأ التجربة المجانية
نشر النسخة الخادمية
- اسحب الصورة:
docker pull uglypear/smartslim-server - جهّز ملف التكوين
config.json - شغّل الحاوية، واضبط المنفذ والدليل
- ثبّت Ghostscript وFFmpeg في الحاوية
- تحقق من الوصول إلى API
نشر النسخة الشبكية
- حمّل
docker-compose.ymlأوk8s/deployment.yaml - اضبط متغيرات البيئة واتصالات قاعدة البيانات
- Docker Compose:
docker-compose up -d - K8s:
kubectl apply -f k8s/ - تحقق من حالة جميع الخدمات
دليل التكامل SDK
مثال على استدعاء C ABI عبر Python ctypes
import ctypes
import os
# تحميل المكتبة الديناميكية
lib = ctypes.cdll.LoadLibrary('./libcompressor.so')
# تعريف نوع المعاملات
lib.compress_file.argtypes = [
ctypes.c_char_p, # مسار الإدخال
ctypes.c_char_p, # مسار الإخراج
ctypes.c_int, # مستوى الضغط (0-4)
ctypes.c_char_p, # نوع الصيغة
]
lib.compress_file.restype = ctypes.c_int # رمز الإرجاع
# استدعاء الضغط
result = lib.compress_file(
b'input.pdf',
b'output.pdf',
2, # مستوى الضغط: BALANCED
b'pdf'
)
if result == 0:
print("الضغط ناجح")
else:
print(f"فشل الضغط، رمز الخطأ: {result}")
إيضاح: مستوى الضغط من 0 إلى 4 يقابل DISABLED/MINIMAL/BALANCED/STRICT/MAXIMUM. يمكن الاطلاع على وصف الواجهة التفصيلي في وثائق SDK، يرجى التواصل مع المبيعات للحصول على وثائق SDK الكاملة.
استكشاف الأخطاء وإصلاحها
تشخيص وحل المشكلات الشائعة
فشل ضغط PDF، رسالة "Ghostscript not found"
السبب: لم يتم تثبيت Ghostscript في النظام.
الحل:
- Linux:
sudo apt install ghostscriptأوsudo yum install ghostscript - macOS:
brew install ghostscript - Windows: حمّل حزمة التثبيت من الموقع الرسمي وأضفها إلى PATH
- تحقق من أن أمر
gsيمكن استدعاؤه في سطر الأوامر
فشل ضغط الفيديو/الصوت، رسالة "FFmpeg not found"
السبب: لم يتم تثبيت مكتبات FFmpeg في النظام.
الحل:
- Linux:
sudo apt install ffmpeg libavcodec-dev libavformat-dev - macOS:
brew install ffmpeg - Windows: تتضمنها حزمة تثبيت نسخة سطح المكتب
- النسخة الخادمية: ثبّت المكتبات المقابلة في صورة Docker
فشل التحقق من الترخيص، رسالة "License expired"
السبب: انتهت صلاحية الاشتراك أو الترخيص.
الحل:
- نسخة سطح المكتب: سجل الدخول بحسابك وتحقق من حالة الاشتراك، أو جدد الاشتراك
- النسخة الخادمية/الشبكية: تواصل مع المبيعات لتجديد الترخيص
- في وضع السماح، يمكنك المتابعة لفترة من الوقت (النسخة الخادمية)
استهلاك CPU مرتفع جداً أثناء الضغط ويؤثر على برامج أخرى
الحل:
- نسخة سطح المكتب: في الإعدادات، اضبط "حد استهلاك CPU" إلى 50% أو أقل
- النسخة الخادمية: اضبط
thread_pool_sizeفيconfig.json - النسخة الشبكية: اضبط requests وlimits للموارد في K8s
- اختر مستوى الضغط MINIMAL لخفض عبء المعالجة
فشل رفع الملف الكبير، رسالة "File too large"
السبب: تجاوز الملف حد الحجم.
الحل:
- نسخة سطح المكتب: التحقق من قيود النسخة المجانية، أو ترقية إلى الاشتراك المدفوع
- النسخة الخادمية: اضبط
max_file_sizeفيconfig.json - النسخة الشبكية: اضبط
MAX_FILE_SIZEوproxy-body-sizeفي Nginx
سياسة الاستجابة للدعم الفني المدفوع
اتفاقية مستوى الخدمة (SLA) للدعم الفني المدفوع
| مستوى الخطأ | الوصف | زمن الاستجابة | زمن الحل |
|---|---|---|---|
| P1 - خطير | لا يمكن استخدام النظام على الإطلاق | 30 دقيقة | 4 ساعات |
| P2 - خطير | وظائف أساسية معطلة، حلول بديلة موجودة | ساعتان | 8 ساعات |
| P3 - عام | وظائف غير أساسية معطلة | 4 ساعات | 24 ساعة |
| P4 - استفسار | استفسارات تقنية، طلبات ميزات | يوم عمل واحد | حسب الحالة |
إيضاح: تنطبق سياسة الاستجابة أعلاه على عملاء الدعم الفني المدفوع. تتم معالجة الدعم الفني المجاني عبر البريد الإلكتروني ونموذج التواصل، ويُرد عليها خلال أيام العمل. لترقية الدعم المدفوع، يرجى التواصل مع المبيعات.