安装 Cardloader 并连接你的扫卡扫描仪

Cardloader 是一款免费桌面软件，支持 Windows、macOS 和 Linux。安装只要一分钟；想用富士通/理光 fi-8170 批量扫卡，再装一个驱动就行。

下载最新版本所有版本

快速上手

下载。 从 GitHub 的最新发行版下载适合你系统的安装包。
安装。 按照 macOS、Windows 或 Linux 对应的步骤安装 Cardloader，然后第一次打开它。
选择识别引擎。 打开 Settings，下载免费的本地模型；如果需要精确识别、价格和评级，就粘贴你的 Ximilar API 令牌。
连接扫描仪。 可选：安装驱动，连接 fi-8170 或其他 TWAIN、SANE 扫描仪；也可以改用 Watch folder（监视文件夹）。
检查扫描设置。 用 ADF 双面扫描、600 dpi，关闭重张检测，每次只放一小摞。
新建会话。 点击 New session，选一个文件夹或你的扫描仪，设置识别和评级方式，然后点击 Create & run。
核对并导出。 看着结果陆续出来，认错的卡点一下就能改，最后把会话导出为 CSV。

第 1 步

下载适用于 Windows、Mac 和 Linux 的卡牌扫描软件

Cardloader 0.1.0 免费提供。下载适合你系统的安装包，然后按下面对应的步骤安装：

系统	下载	系统要求
macOS	.dmg	macOS 11 Big Sur 或更高版本，Apple 芯片或 Intel 芯片的 Mac
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

在 Mac 上安装 Cardloader

在“下载”文件夹中打开 Cardloader_0.1.0_universal.dmg。
在弹出的窗口中，把 Cardloader 拖到应用程序文件夹。
从“应用程序”文件夹打开 Cardloader。第一次打开时，macOS 会提示无法验证 Cardloader 是否包含恶意软件，此时点击完成。
打开系统设置 → 隐私与安全性，向下滚动到安全性，在关于 Cardloader 的提示旁点击仍要打开。
输入密码或用触控 ID 确认，然后点击打开。之后 Cardloader 就会像其他应用一样正常启动，磁盘映像也可以推出了。

macOS 之所以要你确认，是因为这个早期版本还没有用 Apple 开发者证书签名。在 macOS 14 及更早版本上，也可以右键点击应用并选择打开。在“终端”中运行 xattr -dr com.apple.quarantine /Applications/Cardloader.app 效果相同。

第 2 步 · Windows

在 Windows 上安装 Cardloader

在“下载”文件夹中运行 Cardloader_0.1.0_x64-setup.exe。
如果出现蓝色的“Windows 已保护你的电脑”窗口，先点击更多信息，再点击仍要运行。
按安装向导一路点击下一步即可。Cardloader 会安装到你自己的用户账户下，不需要管理员权限。
从“开始”菜单启动 Cardloader。

SmartScreen 发出警告，是因为这个早期版本还没有代码签名。如果电脑上还没有 Microsoft Edge WebView2，安装包会自动下载（Windows 11 已自带）。.msi 会为所有用户安装，需要管理员权限。两种安装包都内置了 TWAIN 扫描仪辅助程序。

第 2 步 · Linux

在 Linux 上安装 Cardloader

任选一种软件包，在下载它的文件夹中打开终端，然后运行：

Ubuntu、Debian、Linux Mint（.deb）

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

apt 会一并安装 Cardloader 需要的 WebKitGTK。安装后从应用程序菜单启动 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（可选）

如果需要精确区分不同版本、置信度、价格和评级，请从 Ximilar App 复制你的 API 令牌，粘贴到 Settings 中，然后点击 Test connection。令牌会保存在系统钥匙串里。

收藏品识别需要 Ximilar 的 Business 套餐或试用。每张卡都会消耗 API 额度：每次识别调用一次（Auto 模式两次），每次评级再调用一次。详见 Ximilar 价格。

第 4 步

连接富士通/理光 fi-8170 扫描仪

Cardloader 可以直接驱动理光（原富士通）fi-8170，也支持 Windows 上任何带自动进纸器的 TWAIN 2.x 扫描仪，以及 macOS 和 Linux 上的 SANE 扫描仪。请用 USB 连接扫描仪，并安装对应系统的驱动：

系统	需要安装	Cardloader 如何与它通信
Windows	fi-8170 的 PaperStream IP（TWAIN）	内置 TWAIN 辅助程序，在独立进程中运行，驱动卡住也不会让软件卡死
macOS	`brew install sane-backends`	SANE `scanimage`
Linux	`sudo apt install sane-utils`（或你所用发行版的 SANE 软件包）；可选安装理光的 `pfufs` 驱动	SANE `scanimage`

想在 Cardloader 之外检查扫描仪，可以在 macOS 或 Linux 上运行 scanimage -L，或在 Windows 上用 PaperStream Capture 打开它。
fi-8170 的网口只能在 Windows 上通过 PaperStream 使用；这台扫描仪不支持 eSCL/AirScan。
ScanSnap 和其他扫描仪：ScanSnap 系列没有 TWAIN 驱动。让它自带的软件把图片存进一个文件夹，然后新建一个 Watch folder（监视文件夹）会话；每存进一张图，Cardloader 就分析一张。

第 5 步

怎样批量扫描卡牌：推荐设置

Cardloader 的扫描仪默认设置是针对 63 × 88 mm 标准卡牌调好的：

ADF 双面扫描，每张卡的正反面一次扫完并自动配对。
600 dpi 彩色，足够看清卡牌编号，也足够用来评级。
66 × 92 mm 扫描区域，比卡牌略大，边缘不会被裁掉。
关闭重张检测：卡牌偏硬，容易误报重张。
先从 10 张左右的小摞开始，不要放入套了卡套或装在卡夹（top loader）里的卡。

开发者

从源码构建

你需要 Rust、Node.js 22 或更高版本、对应系统的 Tauri 前置依赖，以及用来编译本地模型所需 llama.cpp 的 CMake 和 Clang。

$ git clone https://github.com/ximilar-com/cardloader.git
$ cd cardloader
$ just setup     # npm ci + cargo fetch
$ just dev       # 以热重载方式运行应用
$ just install   # 构建并安装到本机

just 不是必需的，Makefile 里有同样的目标。如果不需要本地模型，在 src-tauri/ 中运行 cargo build --no-default-features。更多内容见 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/`

免费开始扫描你的卡牌

下载 Windows、macOS 或 Linux 版 Cardloader，指定一个文件夹或连上扫描仪，几分钟就能识别出第一批卡。无需订阅，无需注册账号。

下载 Cardloader 在 GitHub 上点个 Star