Pasang Cardloader dan sambungkan pengimbas kad anda

Cardloader ialah aplikasi desktop percuma untuk Windows, macOS dan Linux. Pemasangan hanya mengambil masa seminit; menyambungkan Fujitsu/Ricoh fi-8170 untuk imbasan pukal memerlukan satu lagi pemacu.

Muat turun keluaran terkini Semua keluaran

Mula pantas

Muat turun. Muat turun pemasang untuk sistem anda daripada keluaran GitHub terkini.
Pasang. Pasang Cardloader dan bukanya buat kali pertama, mengikut panduan untuk macOS, Windows atau Linux.
Pilih enjin. Buka Settings dan muat turun model setempat yang percuma, atau tampal token API Ximilar anda untuk padanan tepat, harga dan grading.
Sambungkan pengimbas. Pilihan: pasang pemacu dan sambungkan fi-8170 atau pengimbas TWAIN atau SANE yang lain, atau gunakan folder yang dipantau.
Semak tetapan imbasan. Imbas dalam mod ADF dua sisi pada 600 dpi, dengan pengesanan multifeed dimatikan, dalam timbunan kecil.
Cipta sesi. Klik New session, pilih folder atau pengimbas anda, tentukan cara kad dikenal pasti dan digred, kemudian klik Create & run.
Semak dan eksport. Lihat keputusan dipaparkan, betulkan mana-mana padanan dengan satu klik dan eksport sesi ke CSV.

Langkah 1

Muat turun perisian pengimbas kad untuk Windows, Mac dan Linux

Cardloader 0.1.0 adalah percuma. Muat turun pemasang untuk sistem anda, kemudian ikuti panduannya di bawah:

Sistem	Muat turun	Keperluan
macOS	.dmg	macOS 11 Big Sur atau lebih baharu, Apple silicon atau Intel
Windows	.exe atau .msi	Windows 10 atau 11, 64-bit
Linux	.AppImage, .deb atau .rpm	x86-64; fail .deb memerlukan Ubuntu 22.04, Debian 12 atau lebih baharu

Versi lama dan nota keluaran ada di keluaran GitHub. Pemasang dibina daripada kod sumber terbuka oleh GitHub Actions.

macOS Windows Linux

Langkah 2 · macOS

Pasang Cardloader pada Mac

Buka Cardloader_0.1.0_universal.dmg daripada folder Downloads anda.
Dalam tetingkap yang muncul, seret Cardloader ke folder Applications.
Buka Cardloader daripada folder Applications. Pada kali pertama, macOS memaklumkan bahawa ia tidak dapat mengesahkan “Cardloader” bebas daripada perisian hasad: klik Done.
Buka System Settings → Privacy & Security, tatal ke bawah ke Security dan klik Open Anyway di sebelah mesej tentang Cardloader.
Sahkan dengan kata laluan atau Touch ID anda, kemudian klik Open. Mulai sekarang Cardloader dibuka seperti aplikasi lain, dan anda boleh mengeluarkan imej cakera.

macOS bertanya kerana binaan awal ini belum ditandatangani dengan sijil pembangun Apple. Pada macOS 14 dan lebih awal, klik kanan pada aplikasi dan pilih Open juga boleh digunakan. Dalam Terminal, xattr -dr com.apple.quarantine /Applications/Cardloader.app melakukan perkara yang sama.

Langkah 2 · Windows

Pasang Cardloader pada Windows

Jalankan Cardloader_0.1.0_x64-setup.exe daripada folder Downloads anda.
Jika tetingkap biru “Windows protected your PC” muncul, klik More info, kemudian Run anyway.
Ikuti langkah pemasang. Ia memasang Cardloader untuk akaun pengguna anda, tanpa hak pentadbir.
Mulakan Cardloader daripada menu Start.

SmartScreen memberi amaran kerana binaan awal ini belum ditandatangani dengan sijil kod. Pemasang akan memuat turun Microsoft Edge WebView2 jika PC anda belum memilikinya (Windows 11 sudah ada). Fail .msi memasang untuk semua pengguna dan memerlukan hak pentadbir. Pembantu pengimbas TWAIN disertakan dalam kedua-duanya.

Langkah 2 · Linux

Pasang Cardloader pada Linux

Pilih satu pakej. Buka terminal dalam folder tempat anda memuat turunnya:

Ubuntu, Debian, Linux Mint (.deb)

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

apt turut memasang WebKitGTK, yang diperlukan oleh Cardloader. Mulakan Cardloader daripada menu aplikasi anda, atau jalankan 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

Mana-mana distribusi (AppImage)

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

Jika ia tidak bermula dan menyebut FUSE, pasang libfuse2 (pada Ubuntu 24.04, libfuse2t64).

Langkah 3

Sediakan model AI setempat atau API Ximilar

Model setempat percuma (luar talian)

Buka Settings → Identification → Local model, terima lesen model dan klik muat turun. Saiznya kira-kira 330 MB dan muat turun boleh dijeda dan disambung semula. Selepas itu, sesi baharu akan mengenal pasti kad pada komputer anda, tanpa akaun dan tanpa internet.

API Ximilar (pilihan)

Untuk padanan tepat merentas versi, skor keyakinan, harga dan grading, salin token API anda daripada Ximilar App, tampal ke dalam Settings dan klik Test connection. Token disimpan dalam rantai kunci sistem anda.

Pengecaman barang koleksi memerlukan pelan Ximilar Business atau percubaan. Setiap kad menggunakan kredit API: satu panggilan bagi setiap pengecaman (dua dalam mod Auto) serta satu bagi setiap grading. Lihat harga Ximilar.

Langkah 4

Sambungkan pengimbas Fujitsu / Ricoh fi-8170

Cardloader mengendalikan terus RICOH (dahulunya Fujitsu) fi-8170, serta mana-mana pengimbas TWAIN 2.x yang mempunyai penyuap dokumen pada Windows atau pengimbas SANE pada macOS dan Linux. Sambungkan pengimbas melalui USB dan pasang pemacu untuk sistem anda:

Sistem	Apa yang perlu dipasang	Cara Cardloader berhubung dengannya
Windows	PaperStream IP (TWAIN) untuk fi-8170	Pembantu TWAIN yang disertakan, dalam prosesnya sendiri supaya pemacu yang tersekat tidak membekukan aplikasi
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils` (atau pakej SANE distribusi anda); secara pilihan, pemacu `pfufs` daripada RICOH	SANE `scanimage`

Untuk menyemak pengimbas di luar Cardloader, jalankan scanimage -L pada macOS atau Linux, atau bukanya dalam PaperStream Capture pada Windows.
Port rangkaian fi-8170 hanya berfungsi melalui PaperStream pada Windows; pengimbas ini tidak menyokong eSCL/AirScan.
ScanSnap dan pengimbas lain: model ScanSnap tidak mempunyai pemacu TWAIN. Biarkan perisiannya sendiri menyimpan imej ke dalam folder dan cipta sesi Watch folder (folder yang dipantau); Cardloader menganalisis setiap imej sebaik sahaja ia masuk.

Langkah 5

Cara mengimbas kad dagangan secara pukal: tetapan yang disyorkan

Tetapan lalai pengimbas dalam Cardloader ditala untuk kad dagangan standard bersaiz 63 × 88 mm:

ADF dua sisi (penyuap dokumen automatik), supaya bahagian depan dan belakang setiap kad diimbas dan dipadankan dalam satu laluan.
600 dpi, berwarna, yang mencukupi untuk nombor kad dan grading.
Bingkai 66 × 92 mm, sedikit lebih besar daripada kad, supaya tepinya tidak pernah terpotong.
Pengesanan multifeed (suapan berganda) dimatikan: kad yang keras mencetuskan ralat suapan berganda yang palsu.
Mulakan dengan timbunan kecil kira-kira 10 kad, dan jangan masukkan kad bersarung (sleeve) atau top loader.

Untuk pembangun

Bina daripada kod sumber

Anda memerlukan Rust, Node.js 22 atau lebih baharu, prasyarat Tauri untuk sistem anda, serta CMake dengan Clang untuk mengompil llama.cpp bagi model setempat.

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # jalankan aplikasi dengan hot reload
$ just install   # bina dan pasang secara setempat

just adalah pilihan; Makefile mempunyai sasaran yang sama. Untuk membina tanpa model setempat, jalankan cargo build --no-default-features dalam src-tauri/. Maklumat lanjut dalam README.

Rujukan

Kemas kini atau nyahpasang Cardloader

Untuk mengemas kini, muat turun versi baharu dan pasang dengan cara yang sama, di atas versi lama. Sesi, tetapan, token API dan model yang dimuat turun akan dikekalkan.

Sistem	Nyahpasang
macOS	Seret Cardloader dari Applications ke Bin.
Windows	Settings → Apps → Installed apps, kemudian Uninstall dalam menu ⋯ Cardloader.
Linux	`sudo apt remove cardloader`, `sudo dnf remove cardloader`, atau padam fail AppImage.

Nyahpasang hanya membuang aplikasi. Sesi anda kekal dalam folder data di bawah sehingga anda memadamnya.

Rujukan

Tempat Cardloader menyimpan data anda

Sesi, lakaran kecil, imbasan dan lapisan grading kekal pada komputer anda. Imej asal dalam sesi folder tidak pernah diubah atau dipindahkan, dan memadam sesi hanya membuang fail yang dicipta oleh Cardloader.

Sistem	Folder
macOS	`~/Library/Application Support/com.ximilar.cardloader/`
Windows	`%APPDATA%\com.ximilar.cardloader\`
Linux	`~/.local/share/com.ximilar.cardloader/`

Mula imbas kad anda secara percuma

Muat turun Cardloader untuk Windows, macOS atau Linux, halakan kepada folder atau pengimbas anda, dan kenal pasti kumpulan kad pertama anda dalam beberapa minit. Tanpa langganan, tanpa akaun.

Muat turun Cardloader Beri bintang di GitHub