用途与准备
用于批量调整 PDF 的明暗、颜色、纸张背景和扫描文字，适合偏黄、灰底、文字偏淡或带噪点的扫描文档。可以先预览，再按相同设置输出完整 PDF；不会修改来源 PDF 或压缩文件。
开始前请准备：
64 位 Windows 电脑和工具箱 2.4.0 或更新版本。
已安装、启用的 PDF调色处理 插件，以及工具箱提示的完整处理资源。若提示资源未就绪，先在“本地插件”修复资源，再重新打开插件。
独立备份待处理文件。预览和开始处理前仍须按提示选择 我已备份，插件不会替您备份。
可写的输出文件夹、缓存文件夹及足够磁盘空间。建议先用少量有代表性的页面确认效果。
快速开始
打开 PDF调色处理，进入“配置”页，选择输出目录和缓存目录。修改后点击 保存设置；“取消更改”只撤销尚未保存的任务设置。
回到“操作”页，点击 选择文件 多选 PDF、ZIP、RAR、7Z、TAR、TGZ、TAR.GZ 或 PDF.GZ，也可以把这些文件拖入列表。
选择页面范围：全部处理、跳过前两页或跳过首尾页。
点击 配置，选择预设或调整参数，再保存设置。
点击某一行的 预览，确认已备份后检查效果。多页 PDF 可以翻页；压缩文件可以切换其中的 PDF。关闭预览不会开始正式处理。
检查输出位置，点击 开始。在备份提示中选择 我已备份 才会继续；选择“取消”不会启动任务。
查看每行状态、页进度和失败说明。完成后点击 打开目录 查看结果；“清空已完成”只移除列表中的完成、失败记录，不删除来源或已保存成品。
重复添加的文件会保留为多个任务，不会自动去重。拖入文件夹不会扫描其中的文件或子文件夹；需要处理的文件请直接多选加入。
未开始处理时，清空待处理 可以一次移除所有待处理行，保留完成、失败记录和已经保存的结果；它不删除来源文件，也不代替运行中的“取消”。
页面范围与预览
跳过不等于删除：成品仍包含全部页面，页序不变。“处理 N 张”表示文档总页数，不是图像数量或被调色的页数。
预览使用打开预览时的文件和设置，压缩选项也参与预览。预览期间不更改配置或来源文件；需要换设置时，先关闭预览、保存新设置，再重新打开。首次预览或切换较大文档可能需要等待，预览并非只展示未处理的原图。
重要材料请检查小字、细线、印章、彩色图表和照片。预览只帮助确认效果，不能代替处理后的逐页复核。
调色参数
可从默认值开始，每次少量调整一个参数，再比较预览。
初始基础值为亮度 0、对比度 5、饱和度 5、伽马 0.8、去灰 20、锐化 80、降噪 80，自动增强关闭。“恢复默认”恢复调色、文字增强、压缩和页面范围的初始设置，不删除自定义预设。
若除伽马为 1 外，其余六项基础参数都为 0，并且关闭自动增强，处理任务会失败且不生成成品。请至少调整一项基础参数或打开自动增强；仅打开文字增强不满足此条件。
文字增强
打开“文字增强”后，可调整加深强度、加粗强度和识别阈值。初始开启，加深与加粗均为 50，阈值为 128。
加深强度：让偏淡的文字更明显，范围 0～100。
加粗强度：加强文字边缘，范围 0～100。细小文字不要一次调得过高，以免笔画粘连。
识别阈值：调整参与增强的明暗范围，范围 50～200；它不是文字识别准确率。
这是页面文字外观增强，不会识别正文或生成可搜索文字。彩色背景、反白字、浅灰图表可能受到影响，请结合预览判断。
预设的选择、保存和删除
内置方案包括 文档增强、照片优化、去黄、文字增强。内置方案不能覆盖或删除；应用时会更新基础参数和相应文字增强设置，不改变压缩方式或页面范围。
保存自己的常用方案：
在调色配置中调好基础参数和自动增强开关。
输入预设名称，点击保存。空名称不会保存；相同名称会直接覆盖原同名自定义预设。
需要保留旧方案时，使用另一个名称另存。
在预设列表中选择已保存的方案即可应用。修改基础参数或文字增强后，当前选择会回到“自定义参数”。
自定义预设只保存七项基础参数和自动增强开关，不保存文字增强、压缩、页面范围、路径或任务。已保存、删除的自定义预设会立即保留，取消外层配置弹窗不会撤销这些操作。
删除自定义预设需要确认；取消删除则保持原样。删除当前预设后会回到“自定义参数”，已经显示的参数值不会被清空。插件不提供预设重命名或导入、导出；需要改名时另存新名称，再删除旧名称。
压缩设置
自适应：默认选项，按页面内容在所选质量范围内处理；初始范围为 75～95，可在 50～100 内调整上下界。
固定质量：对需要压缩的页面使用指定质量，范围 50～100，初始值 90。值越低通常越省空间，但文字边缘和照片细节可能受损。
无损：避免额外的有损压缩，适合优先保留调色后细节的文档；文件可能较大。
压缩设置独立于预设，不会因选择另一个调色预设而自动切换。文件大小取决于原文档内容，不能保证每份结果都比来源更小。
输出、覆盖与压缩文件
普通 报告.pdf 输出为选定目录中的 报告_hd.pdf，来源保持不变。
已有同名结果会被覆盖。 开始前请确认输出目录中没有需要保留的同名 _hd.pdf。正在查看结果的程序可能占用文件，出现保存失败时先关闭占用，再重试。
ZIP、RAR、7Z、TAR、TGZ、TAR.GZ 中只处理 PDF，忽略普通图片等非 PDF 内容。结果仍是独立 PDF，集中写入输出目录，不重新生成压缩文件，也不保留内部文件夹层级。
单独压缩的 PDF 必须保留 .pdf.gz 后缀，例如 报告.pdf.gz 输出为 报告_hd.pdf。仅以 .gz 结尾而不保留 .pdf 或 .tar 的文件会提示未找到 PDF；请使用正确的原文件名，不要把其它内容改名伪装成 PDF 或 TAR。
文件按名称顺序处理。来自不同子文件夹的同名 PDF 会使用同一结果名，后处理的覆盖先处理的；建议提前整理重名文件。
个别 PDF 成员损坏时，会记录失败并继续其它成员。已保存的成品保留，行内可展开失败详情；存在失败成员的任务不会计作全部成功。
没有 PDF 的压缩文件会失败。加密、损坏或带不安全成员的压缩文件不会尝试绕过限制或索要密码。
不接受符号链接、目录联接或硬链接；来源发生变化时停止相应操作，请重新添加文件后处理。
压缩文件内单个成员最多 128 MiB，累计展开大小最多 2 GiB；TGZ、TAR.GZ 的外层展开也受 2 GiB 限制，内部成员仍受 128 MiB 限制。超限时请先在可信环境中拆分文件。
成品会保留文档信息、有效书签和附件。部分文档处理后，原有文字、批注的可编辑形态可能改变；需要搜索、复制、修改或核验数字签名时，请保留并使用原件，不把调色成品当作原始签名文件。
并发、取消与离开
“配置”页可以选择同时处理 1、2、4 或 8 个任务，默认 4。大图、长文档或电脑内存紧张时，建议降为 1 或 2；提高并发不保证更快。
取消：停止点击时正在处理的任务，并等待其真正结束；这些行回到待处理，可以重新开始。排队中的其它任务仍会继续，不等于取消整个列表。
已经保存的成品不会因取消而撤回；未完成的暂存结果不作为正式成品列出。原先已有的同名结果不会被未完成候选替换。
返回时若有活动任务或预览缓存，按工具箱提示选择继续等待或强制离开。强制离开会停止本插件尚未结束的操作并清理自有缓存，不影响其它插件或您自己打开的文档。
重新进入插件后可以继续使用；配置、任务目录设置和自定义预设会保留。文件列表和运行进度不作为长期任务保存。
本插件没有暂停、继续按钮。不要用关闭窗口代替普通取消。
常见问题
显示“所需资源未就绪”
返回“本地插件”，完成资源下载或修复后重新打开。不要手动替换程序文件或更改工具箱、插件目录。若提示升级工具箱，先升级到要求的版本。
选择了文件但不能开始
检查是否还有正在执行的操作、是否有待处理文件、处理资源是否就绪，以及输出和缓存目录是否有效。未完成备份确认不会开始。
PDF 失败或无法预览
查看该行原因，确认文件可以正常打开、没有密码且未损坏。先在有权使用该文件的情况下准备一份可正常打开的副本，再重新加入。不要仅修改扩展名，也不要在处理过程中修改或替换来源。
取消后还有任务继续
普通取消只针对当时活动的任务，等待中的任务会继续。需要停止本插件全部工作时，使用返回提示中的强制离开，并等待清理结束。
显示缓存尚未清理
先等待正在进行的操作结束，再点击 重试清理。此操作只清理本插件创建的任务缓存，不清空您选择的整个缓存文件夹，也不删除来源或已保存成品。仍失败时，保留错误说明并联系支持，不要强行删除其它任务目录。
文件变大、颜色过重或细字不清
降低锐化、加粗或降噪强度，关闭不需要的增强，重新预览。优先用无损检查调色本身，再选择适合的压缩设置。对关键材料，务必核对全部页数、页面顺序、细字、印章和附件。