ثبّت Cardloader ووصّل ماسح البطاقات الضوئي

Cardloader برنامج مكتبي مجاني لأنظمة Windows وmacOS وLinux. يستغرق تثبيته دقيقة، ولا يحتاج توصيل ماسح Fujitsu/Ricoh fi-8170 للمسح بالجملة إلا إلى برنامج تشغيل إضافي واحد.

نزّل أحدث إصدار كل الإصدارات

بداية سريعة

التنزيل. نزّل ملف التثبيت المناسب لنظامك من أحدث إصدار على GitHub.
التثبيت. ثبّت Cardloader وافتحه أول مرة باتباع الخطوات الخاصة بنظام macOS أو Windows أو Linux.
اختيار المحرّك. افتح الإعدادات (Settings) ونزّل النموذج المحلي المجاني، أو الصق رمز Ximilar API للتعرّف الدقيق والأسعار والتقييم.
توصيل الماسح. خطوة اختيارية: ثبّت برنامج التشغيل ووصّل ماسح fi-8170 أو أي ماسح آخر يدعم TWAIN أو SANE، أو استخدم مجلدًا مراقَبًا.
التحقق من إعدادات المسح. استخدم المسح المزدوج عبر ADF بدقة 600 dpi، وعطّل كشف التغذية المزدوجة، وامسح البطاقات في رزم صغيرة.
إنشاء جلسة. انقر New session، واختر مجلدًا أو الماسح الضوئي، وحدّد طريقة التعرّف على البطاقات وتقييمها، ثم انقر Create & run.
المراجعة والتصدير. تابع النتائج وهي تظهر، وصحّح أي تعرّف بنقرة واحدة، ثم صدّر الجلسة إلى CSV.

الخطوة 1

نزّل برنامج مسح البطاقات لنظام Windows وMac وLinux

Cardloader 0.1.0 مجاني. نزّل ملف التثبيت المناسب لنظامك، ثم اتبع خطوات تثبيته أدناه:

النظام	التنزيل	المتطلبات
macOS	.dmg	macOS 11 Big Sur أو أحدث، بمعالج Apple silicon أو Intel
Windows	.exe أو .msi	Windows 10 أو 11، 64 بت
Linux	.AppImage أو .deb أو .rpm	x86-64؛ ويتطلب ملف .deb نظام Ubuntu 22.04 أو Debian 12 أو أحدث

الإصدارات الأقدم وملاحظات الإصدار موجودة في إصدارات GitHub. وتُبنى ملفات التثبيت من الشيفرة المفتوحة المصدر بواسطة GitHub Actions.

macOS Windows Linux

الخطوة 2 · macOS

ثبّت Cardloader على Mac

افتح Cardloader_0.1.0_universal.dmg من مجلد التنزيلات.
في النافذة التي تظهر، اسحب Cardloader إلى مجلد التطبيقات.
افتح Cardloader من مجلد التطبيقات. في المرة الأولى يخبرك macOS بأنه تعذّر التحقق من خلوّ «Cardloader» من البرامج الضارة: انقر على تم.
افتح إعدادات النظام ← الخصوصية والأمن، ومرّر لأسفل إلى الأمن، ثم انقر على فتح على أية حال بجانب الرسالة الخاصة بـ Cardloader.
أكّد بكلمة السر أو ببصمة الإصبع (Touch ID)، ثم انقر على فتح. من الآن فصاعدًا يفتح Cardloader مثل أي تطبيق آخر، ويمكنك إخراج صورة القرص.

يطلب macOS هذا التأكيد لأن هذا الإصدار المبكر لم يُوقَّع بعد بشهادة مطوّر من Apple. وعلى macOS 14 والإصدارات الأقدم، يمكنك أيضًا النقر على التطبيق بزر الفأرة الأيمن واختيار فتح. وفي تطبيق الطرفية، يؤدي الأمر xattr -dr com.apple.quarantine /Applications/Cardloader.app الغرض نفسه.

الخطوة 2 · Windows

ثبّت Cardloader على Windows

شغّل Cardloader_0.1.0_x64-setup.exe من مجلد التنزيلات.
إذا ظهرت نافذة SmartScreen الزرقاء التي تقول إن Windows قام بحماية جهاز الكمبيوتر، فانقر على مزيد من المعلومات، ثم على التشغيل على أي حال.
تابع خطوات التثبيت حتى النهاية. يُثبَّت Cardloader لحساب المستخدم الخاص بك، دون الحاجة إلى صلاحيات المسؤول.
شغّل Cardloader من قائمة البدء.

يحذّر SmartScreen لأن هذا الإصدار المبكر لم يُوقَّع رقميًا بعد. ويُنزّل ملف التثبيت Microsoft Edge WebView2 إن لم يكن موجودًا على الجهاز (وهو موجود في Windows 11). أما ملف .msi فيثبّت التطبيق لجميع المستخدمين ويتطلب صلاحيات المسؤول. وأداة TWAIN المساعدة للماسح الضوئي مضمّنة في كليهما.

الخطوة 2 · Linux

ثبّت Cardloader على Linux

اختر حزمة واحدة، ثم افتح الطرفية في المجلد الذي نزّلتها إليه:

Ubuntu وDebian وLinux Mint (.deb)

$ sudo apt install ./Cardloader_0.1.0_amd64.deb

يثبّت apt أيضًا مكتبة WebKitGTK التي يحتاج إليها Cardloader. شغّل Cardloader من قائمة التطبيقات، أو نفّذ الأمر cardloader.

Fedora وopenSUSE (.rpm)

$ sudo dnf install ./Cardloader-0.1.0-1.x86_64.rpm      # Fedora
$ sudo zypper install ./Cardloader-0.1.0-1.x86_64.rpm   # openSUSE

أي توزيعة (AppImage)

$ chmod +x Cardloader_0.1.0_amd64.AppImage
$ ./Cardloader_0.1.0_amd64.AppImage

إذا لم يعمل وظهرت رسالة تذكر FUSE، فثبّت libfuse2 (أو libfuse2t64 على Ubuntu 24.04).

الخطوة 3

جهّز نموذج الذكاء الاصطناعي المحلي أو Ximilar API

النموذج المحلي المجاني (دون اتصال)

افتح Settings → Identification → Local model، واقبل رخصة النموذج، ثم انقر زر التنزيل. حجمه نحو 330 MB، ويمكن إيقاف تنزيله مؤقتًا واستئنافه. بعدها تتعرّف الجلسات الجديدة على البطاقات على جهازك، دون حساب ودون إنترنت.

Ximilar API (اختياري)

للتعرّف الدقيق الذي يميّز النسخ المختلفة، ولدرجات الثقة والأسعار والتقييم، انسخ رمز API من تطبيق Ximilar، والصقه في Settings، ثم انقر Test connection. يُحفظ الرمز في سلسلة مفاتيح نظامك.

يتطلب التعرّف على المقتنيات خطة Business من Ximilar أو فترة تجريبية. وكل بطاقة تستهلك رصيدًا من API: طلب واحد لكل تعرّف (طلبان في وضع Auto) وطلب لكل تقييم. راجع أسعار Ximilar.

الخطوة 4

وصّل ماسح Fujitsu / Ricoh fi-8170

يشغّل Cardloader ماسح RICOH (فوجيتسو سابقًا) fi-8170 مباشرةً، وأي ماسح يدعم TWAIN 2.x ومزوّد بوحدة تغذية للمستندات على Windows، وأي ماسح يدعم SANE على macOS وLinux. وصّل الماسح عبر USB وثبّت برنامج التشغيل المناسب لنظامك:

النظام	ما الذي تثبّته	كيف يتواصل معه Cardloader
Windows	PaperStream IP (TWAIN) لماسح fi-8170	أداة TWAIN مساعدة مرفقة، تعمل في عملية مستقلة كي لا يُجمّد برنامجُ تشغيل عالقٌ التطبيقَ أبدًا
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (أو حزمة SANE في توزيعتك)؛ واختياريًا برنامج التشغيل `pfufs` من RICOH	SANE `scanimage`

لتتحقق من الماسح خارج Cardloader، شغّل scanimage -L على macOS أو Linux، أو افتحه في PaperStream Capture على Windows.
منفذ الشبكة في fi-8170 لا يعمل إلا عبر PaperStream على Windows؛ والماسح لا يدعم eSCL/AirScan.
ScanSnap والماسحات الأخرى: ليس لطرازات ScanSnap برنامج تشغيل TWAIN. دع برنامجها يحفظ الصور في مجلد، وأنشئ جلسة Watch folder (مجلد مراقَب)؛ فيحلّل Cardloader كل صورة فور وصولها.

الخطوة 5

كيف تمسح بطاقات التداول بالجملة: الإعدادات الموصى بها

إعدادات Cardloader الافتراضية للماسح مضبوطة على بطاقات التداول القياسية بمقاس 63 × 88 مم:

مسح مزدوج عبر ADF، فيُمسح وجه كل بطاقة وظهرها ويُطابَقان في مرور واحد.
600 dpi بالألوان، وهذا يكفي لقراءة أرقام البطاقات وللتقييم.
إطار بمقاس 66 × 92 مم، أكبر قليلًا من البطاقة، فلا تُقصّ حوافها أبدًا.
كشف التغذية المزدوجة معطّل: البطاقات الصلبة تسبّب أخطاء تغذية مزدوجة وهمية.
ابدأ برزم صغيرة من نحو 10 بطاقات، ولا تُدخل بطاقات داخل أغلفة واقية أو حافظات صلبة (top loader).

للمطوّرين

البناء من الشيفرة المصدرية

تحتاج إلى Rust، وNode.js 22 أو أحدث، ومتطلبات Tauri لنظامك، وCMake مع Clang لترجمة llama.cpp من أجل النموذج المحلي.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # تشغيل التطبيق مع إعادة التحميل الفوري
$ just install   # البناء والتثبيت محليًا

just اختياري؛ فملف Makefile فيه الأهداف نفسها. وللبناء دون النموذج المحلي، شغّل cargo build --no-default-features داخل src-tauri/. والمزيد في README.

مرجع

تحديث Cardloader أو إلغاء تثبيته

للتحديث، نزّل الإصدار الجديد وثبّته بالطريقة نفسها فوق القديم. وتبقى جلساتك وإعداداتك ورمز API والنماذج التي نزّلتها كما هي.

النظام	إلغاء التثبيت
macOS	اسحب Cardloader من مجلد التطبيقات إلى سلة المهملات.
Windows	الإعدادات ← التطبيقات ← التطبيقات المثبتة، ثم إلغاء التثبيت من قائمة ⋯ بجانب Cardloader.
Linux	`sudo apt remove cardloader` أو `sudo dnf remove cardloader`، أو احذف ملف AppImage.

إلغاء التثبيت يزيل التطبيق وحده. وتبقى جلساتك في مجلد البيانات أدناه إلى أن تحذفه.

مرجع

أين يحفظ Cardloader بياناتك

تبقى الجلسات والصور المصغّرة والصور الممسوحة وصور التقييم على جهازك. ولا تُعدَّل الصور الأصلية في جلسات المجلدات ولا تُنقل أبدًا، وحذف الجلسة لا يزيل إلا الملفات التي أنشأها Cardloader.

النظام	المجلد
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

ابدأ مسح بطاقاتك مجانًا

نزّل Cardloader لنظام Windows أو macOS أو Linux، ووجّهه إلى مجلد أو إلى الماسح الضوئي، وتعرّف على أول دفعة من بطاقاتك في دقائق. بلا اشتراك ولا حساب.

نزّل Cardloader ضع نجمة على GitHub