PDFQFZ · PDF 骑缝章

在 Mac 上为多页 PDF 合同加盖骑缝章与页面印章，实时预览，批量导出。

功能

• 骑缝章：将印章切分到各页边缘，支持左、右、上、下四个方向；长合同按页数上限均衡分组。
• 页面印章：独立配置图片、尺寸与位置，可盖在第一页、最后一页、全部页或指定页。
• 去除白底：让白底印章的背景透明，减少对正文的遮挡；两类印章分别控制，可恢复原图效果。
• 实时预览：翻页、缩放、拖动印章定位，以及骑缝切片拼合检查。
• 批量处理：导入多份 PDF，或添加文件夹中直接包含的 PDF；逐文件显示处理结果。
• 保留原件：输出新的 PDF，同名结果自动编号，不覆盖原合同。
• 本地处理：合同与印章在本机处理，无需账号或云端服务。

界面与使用

主窗口左侧配置印章，右侧预览 PDF。骑缝章与完整页面印章可以独立开启，也可以同时使用。

1. 点击 添加 PDF，或按 ⌘O 导入合同。
2. 导入 PNG/JPEG 印章，设置宽高（mm）、页边、位置、旋转和不透明度。去白底默认开启。
3. 如需完整印章，开启 页面印章，选择素材与盖章页码。例如 1,3,5-8。
4. 翻页检查结果，使用 骑缝拼合 检查切片。拖动印章后松开鼠标应用位置。
5. 点击 导出 PDF，选择输出目录，在结果窗口查看每份文件的状态。

批量文件共用当前参数，但每份 PDF 独立切分。只有一页的文件不产生骑缝章，可以使用页面印章。

系统要求

• macOS 14 或更新版本。
• 当前本地构建与界面验证基于 Apple Silicon；Intel Mac 构建尚未验证。
• 运行已构建的 App 不需要 Python、Xcode 或第三方运行依赖。
• 从源码构建需要 Xcode、macOS SDK 与 Swift 5.10 或更新工具链。

当前为开发版本，未进行 Developer ID 签名和 Apple 公证，不保证在另一台 Mac 上可直接双击运行。系统可能要求确认应用来源。

从源码构建

git clone https://github.com/rickybaby0624/PDFQFZ.git
cd PDFQFZ
./script/build_and_run.sh

脚本构建 SwiftPM 可执行程序，将其打包到 dist/骑缝章.app，复制图标资源，并打开应用。

./script/build_and_run.sh --build   # 仅构建与打包，不结束正在运行的 App
./script/build_and_run.sh --verify  # 构建、启动并检查进程

默认启动命令会关闭本项目上一实例；当前会话尚不持久保存文件列表和盖章参数，需要保留设置时请使用 --build。

测试

SWIFTPM_MODULECACHE_OVERRIDE="$PWD/.build/module-cache" \
CLANG_MODULE_CACHE_PATH="$PWD/.build/module-cache" \
swift test --disable-sandbox

自动测试覆盖分组边界、页码范围、切片连续性、物理尺寸换算、旋转与裁剪页面、两类印章独立设置、白底处理、密码输入、同名输出保护，以及部分文字、链接、表单与目录的保留。

测试使用合成文档和图像。已有本机界面验证不等于对所有 PDF、高级表单、打印机或 macOS 版本的兼容性保证。

技术结构

系统框架：SwiftUI · AppKit · PDFKit · Core Graphics · ImageIO。SwiftPM 无第三方运行依赖。

Sources/
  StampCore/       # 印章素材、去白底、页面坐标、切片与 PDF 导出
  SeamStamp/
    App/           # 应用入口与菜单
    Stores/        # 文件队列、预览与导出状态
    Views/         # 设置栏、PDF 预览与结果窗口
Tests/             # 核心功能回归测试
Assets/            # 最终图标母版、PNG、iconset 与 ICNS
script/            # 构建启动与可选图标准备脚本

图标资源已包含在仓库中，正常构建无需重新生成。仅重新制作图标时，script/prepare_icon.py 需要 Python、Pillow、NumPy 和 macOS iconutil。

使用边界

• 本项目提供图片盖章，不提供数字证书签名、可信时间戳或防篡改保证。印章以具有可见外观的 PDF 注释保存，可被其他 PDF 编辑器修改。
• 尚不支持新增输出加密、多章连盖、随机位置或正文下方叠印。
• 检测到数字签名字段时拒绝处理，但不提供完整签名有效性验证。
• 印章尺寸对应整张图片画布，包含原有留白；不会自动裁切素材。
• 合同、印章、密码与参数不持久保存；密码仅用于当前会话的打开和输出校验。
• 已验证的加密 PDF 样本导出后仍需原密码打开；复杂 PDF 及大文件应先用副本验证。

项目状态

当前版本：0.1.1。已包含白底遮挡修复和“PDF＋叠页＋骑缝印记”图标。

原始合同、企业印章、参考截图、构建产物和本地测试输出不包含在仓库中。