欢迎使用古籍数字拼合工具！本工具专为古籍数字化修复与排版设计，基于“分合之道”哲学，将复杂的拼版操作化解为直观的交互，助您轻松完成筒子页拼接、整版切分、印刷配册等专业任务。
一、功能概览
- 双页拼接：将单页左右拼合为完整筒子页，自动处理中缝。
- 滚动拼接：实现古籍书页连续滚动（如1-0、2-1…），用于拼接摊开扫描书籍。
- 整版分单：将已拼接好的筒子页整版切分为左右单页。
- 蝶装输出：按锁线精装配页规则（如1-16, 2-15…）生成小册子PDF。
- 参数微调：支持每对页的独立位移、缩放、横缩、旋转，图像边距与画布边距全局控制。
- 参考框线：可拖拽绘制红色虚线框，用于对齐标准版框。
- 项目保存/加载：所有调整参数可保存为JSON文件，随时恢复工作状态。
- 快捷键支持：键盘微调、翻页、缩放，提升效率。
二、快速入门
1. 启动程序
双击 古籍拼合工具.exe，等待主界面出现。程序采用古风宣纸配色，左侧为控制面板，右侧为预览画布。
2. 打开文件
- 点击 打开 PDF 按钮，选择待处理的PDF文件。
- 或点击 选择图片文件夹，载入一系列图片（按文件名排序）。
- 加载成功后，预览区将显示第一对页面，并且会自动缩放至适合窗口大小。
3. 基本查看
- 翻页：使用 “◀ 上一对” / “下一对 ▶” 按钮，或按键盘 PageUp / PageDown。
- 缩放画布：鼠标滚轮（以光标为中心缩放）。
- 平移画布：在预览区按住鼠标右键并拖拽。
- 恢复默认视图：右键单击预览区（非遮盖模式）即可将画布恢复至适合窗口大小。
三、界面布局
左侧控制面板从上至下依次为：
- 文件操作区：打开文件、当前控制页提示。
- 拼接模式：双拼页、整版分单、奇数页自动补白。
- 画布边距（全局）：控制最终输出页面的四边留白或裁切（百分比，负值裁切）。
- 图像边距（当前对）：控制当前这一对左右页自身的裁剪（百分比）。
- 变换参数（当前对）：缩放、横缩（横向拉伸）、旋转角度，仅对当前页对生效。
- 中缝重叠：调节左右页向中线靠拢的程度，可设为全局默认。
- 参考框线：绘制红色虚线参考框。
- 保存 PDF：导出最终文件。
- 帮助：查看内置使用说明。
- 状态栏：显示当前操作反馈。
四、详细操作指南
4.1 切换控制页与拖拽移动
- 切换控制侧：单击预览画布的左半区，控制页变为“左页”；单击右半区，控制页变为“右页”。当前控制页在状态标签中显示。
- 拖拽移动页面：在画布上按住左键拖拽，可实时移动当前控制页。移动方向与鼠标拖拽方向一致（上拖即上移）。
- 微调：选中左/右页后，使用键盘方向键进行1点步长的精细调节。
4.2 缩放与视图控制
- 缩放：鼠标滚轮向前放大，向后缩小。缩放中心始终跟随鼠标指针，便于查看细节。
- 恢复视图：右键单击画布（非遮盖模式）即可重置缩放并居中显示全图。
- 右键双击：快速将视图缩放至2倍或恢复至1倍。
4.3 边距与变换参数调节
- 画布边距（全局）：四个输入框（左/右/上/下），单位%。正值＝增加白边，负值＝裁切画布。修改后预览实时更新。
- 图像边距（当前对）：同样四个输入框，单位%，控制当前页对中左、右页各自的裁剪量，不影响画布大小。例如，左页左边距设为20%，则左页左边20%的内容会被裁掉。
- 缩放：分别调节左右页的显示比例，100%为原始大小。
- 横缩：仅改变页面宽度，高度不变，用于校正版框倾斜或宽度不一致。
- 旋转：顺时针为正，可任意角度（对当前页对生效）。
注意：以上变换参数均仅对当前页对有效，切换页对后会自动加载该页对的设置。所有参数修改后都会实时预览，并且会自动保存到项目文件中。
4.4 中缝重叠
- 左右页中线附近可能会因扫描等原因造成接缝不齐。通过调节重叠百分比，可以让左页向右延伸、右页向左延伸，使中缝自然融合。
- 点击 设为全局 可将当前值作为所有页对的默认重叠值，若某一页对单独调整过，则会覆盖全局值。要恢复全局值，只需将该对的数值改回与全局相同即可。
4.5 参考框线
- 勾选“启用”后，可在画布上拖拽绘制红色虚线矩形，松开后自动记录宽高及位置。
- 可手动修改宽、高、水平偏移、垂直偏移数值，框线实时更新。
- 锁定后不再响应拖拽，避免误触。
4.6 删除页面
点击 删除当前页 按钮，会删除当前控制侧对应的原始页面（从原始页面列表中移除）。删除后程序会重新配对，页码自动调整。此操作不可撤销，请谨慎使用。
4.7 遮盖功能
遮盖功能用于修补页面上的污损区域，目前正在优化中，暂不可用。将在后续版本中提供。
五、导出 PDF
点击 保存 PDF 按钮，弹出保存对话框，您可以选择输出模式：
- 拼接（左右合并）：将左右页拼合为一张宽幅PDF，适合直接打印或阅读。
- 分割（先右后左单页）：输出为独立的单页PDF，右页在前，左页在后。常用于标准化单页处理。
- 蝶装（错页拼合）：按照古籍锁线精装的配页规则重新组合页面，生成适合装订的小册子。需输入每册页数（必须是4的倍数，默认16页）。程序会在原始页面前插入一页空白，然后按 (1,16),(15,2),(3,14),… 的规律配对，输出可直接打印并手工折页装订的PDF。
导出进度条会显示当前处理进度，导出完成后弹出提示。导出过程中可以切换窗口或进行其他操作。
六、快捷键一览
七、项目保存与加载
在导出对话框中，您可以：
- 保存项目：将所有拼接参数（位移、缩放、边距、重叠等）保存为 .json 文件，方便下次继续处理。
- 加载项目：打开之前保存的 .json 文件，程序会自动恢复全部设置，包括原始页面列表、当前页码和所有调整参数。
建议：每次处理完一部分页面后及时保存项目，以防意外退出丢失进度。
八、常见问题
Q：为什么打开某些PDF会卡顿？
A：个别PDF可能包含损坏的压缩流，程序渲染时会尝试修复，可能导致短暂卡顿。请尝试用其他软件修复PDF后再打开。程序已针对大文件进行优化，通常1GB内的PDF都能流畅处理。
Q：导出的PDF和预览不一样？
A：请确保未修改全局画布边距或图像边距，导出时会应用所有当前参数。如有疑问，可先保存项目，再重新加载导出。
Q：如何恢复默认设置？
A：关闭程序，删除项目JSON文件，重新打开PDF即恢复初始状态。
Q：蝶装导出后页码不对？
A：请确认每册页数设置为4的倍数，并且原始页面总数适合分册。程序会在第一页插入空白页，因此页码会整体后移，这是锁线装订的正常流程。
九、设计哲学
本工具的核心思想源自“分合之道”：以分为法，以合为宗。通过对画布、图像、变换参数的巧妙分离，实现了在不修改原始像素的前提下，自由组合出各种阅读形态。更多理论阐述请见《分合之道：古籍数字拼合的本体论与方法论》文档。
感谢您的使用！如有反馈或问题，欢迎联系。