מתקינים את 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 מתיקיית ההורדות.
אם מופיע החלון הכחול "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 (ב-Ubuntu 24.04: libfuse2t64).

שלב 3

הגדרת מודל ה-AI המקומי או Ximilar API

מודל מקומי חינמי (אופליין)

פתחו את Settings → Identification → Local model, אשרו את רישיון המודל ולחצו על ההורדה. המודל שוקל כ-330 MB, ואפשר לעצור את ההורדה ולהמשיך אותה. מעכשיו סשנים חדשים מזהים קלפים על המחשב שלכם, בלי חשבון ובלי אינטרנט.

Ximilar API (אופציונלי)

בשביל התאמות מדויקות בין גרסאות, רמות ביטחון, מחירים וגריידינג, העתיקו את טוקן ה-API שלכם מXimilar App, הדביקו אותו ב-Settings ולחצו על Test connection. הטוקן נשמר במחזיק המפתחות של המערכת.

זיהוי פריטי אספנות דורש תוכנית Business של Ximilar או תקופת ניסיון. כל קלף עולה קרדיטים של API: קריאה אחת לכל זיהוי (שתיים במצב Auto) ועוד אחת לכל גריידינג. פרטים במחירון של Ximilar.

שלב 4

חיבור סורק Fujitsu / Ricoh fi-8170

Cardloader מפעיל ישירות את fi-8170 של RICOH (לשעבר Fujitsu), וגם כל סורק TWAIN 2.x עם מזין מסמכים ב-Windows וכל סורק SANE ב-macOS וב-Linux. חברו את הסורק ב-USB והתקינו את הדרייבר למערכת שלכם:

מערכת	מה להתקין	איך Cardloader מדבר איתו
Windows	PaperStream IP (TWAIN) ל-fi-8170	רכיב עזר של TWAIN שמגיע עם האפליקציה ורץ בתהליך נפרד, כך שדרייבר תקוע אף פעם לא מקפיא את האפליקציה
macOS	`brew install sane-backends`	`scanimage` של SANE
Linux	`sudo apt install sane-utils` (או חבילת SANE של ההפצה שלכם); ואם רוצים, גם הדרייבר `pfufs` של RICOH	`scanimage` של SANE

כדי לבדוק את הסורק מחוץ ל-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 קלפים, ואל תכניסו לסורק קלפים בשרוולים או בטופ-לואדרים.

למפתחים

בנייה מקוד המקור

צריך 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       # הרצת האפליקציה עם hot reload
$ 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