sbrunner/scan-to-paperless

文档扫描与无纸化处理工具

概述

该工具用于扫描物理文档、进行专业化处理，并将其导入无纸化系统（paperless）。支持多种高级扫描功能，如双面扫描、***扫描和辅助拆分，简化文档数字化流程。

使用方法

1. 使用scan命令（可自动补全联系人与标签）扫描文档。
2. 扫描后的文档将传输至NAS（推荐使用Syncthing同步）。
3. 文档在NAS上进行处理。
4. 使用scan-process-status命令查看文档处理状态。
5. 验证文档内容。
6. 若确认无误，删除REMOVE_TO_CONTINUE文件（如需重启处理，删除生成的任一图片；如需取消任务，直接删除文件夹）。
7. 处理流程将继续，并将文档导入无纸化系统。

核心功能与特性

双面扫描

1. 将纸张放入自动文档进纸器（ADF）。
2. 运行scan命令并添加--double-sided选项。
3. 按回车键开始扫描所有纸张的第一面。
4. 无需翻转纸张，直接将所有纸张重新放入自动文档进纸器。

工具会自动旋转并重新排序所有页面，生成正确顺序的文档。

***扫描

使用--append-credit-card选项可将多张扫描页垂直拼接，使***正反面位于同一页面。

辅助拆分

1. 常规扫描时添加--assisted-split选项。
2. 首次处理完成后，生成的图片将带有线条和数字标记：线条表示检测到的潜在拆分位置，长度代表检测强度。配置文件中将生成类似以下内容：

yaml
assisted_split:
- destinations:
  - 4  # 图片左侧部分的页码
  - 1  # 图片右侧部分的页码
  image: image-1.png  # 图片名称
  limits:
  - margin: 0  # 拆分周围的边距
    name: 0  # 生成图片上显示的数字
    value: 375  # 拆分位置（可手动编辑）
    vertical: true  # 垂直拆分图片
  - ...
  source: /source/975468/7-assisted-split/image-1.png
- ...

3. 编辑配置文件，确保目标页码数量比拆分限制多一个。目标页码格式如2.1表示第2页的第一部分，2.2表示第2页的第二部分。
4. 删除REMOVE_TO_CONTINUE文件。
5. 处理完成后生成最终图片，确认无误后再次删除REMOVE_TO_CONTINUE文件。

安装说明

在用户主目录的虚拟环境中安装：

bash
$ cd ~
$ python3 -m venv venv
$ ~/venv/bin/pip install scan-to-paperless
$ sudo activate-global-python-argcomplete
$ echo PATH=$PATH:~/venv/bin >> ~/.bashrc

NAS配置

需支持Docker环境。个人使用群晖DiskStation DS918+，可获取*.syno.json文件配置Docker服务。