一、插件能做什么
“PDF灰度转换”用于把一个或多个彩色 PDF 批量转换成灰度 PDF，适合打印资料、归档文件、合同副本和需要减少彩色内容的文档。
插件在 Windows 本机重新生成 PDF，不会主动把文档上传到网络。它支持：
选择单个或多个 PDF，也可以选择整个文件夹；
按需扫描子文件夹；
覆盖源文件、保存到原 PDF 文件夹或保存到指定文件夹；
查看每个文件的进度和结果；
暂停队列、继续、取消和安全离开。
二、使用前准备
先确认源 PDF 可以正常打开，不要只把其它文件改名为 .pdf。
重要文件务必备份，尤其是准备使用“覆盖源文件”时。
关闭正在占用源 PDF 或目标 PDF 的阅读器、编辑器、资源管理器预览和同步软件。
确认磁盘有足够空间。转换时会先生成临时 PDF，短时间内需要额外空间。
首次使用建议只处理 1～2 个有代表性的文件，核对页面、字体和交互内容后再批量转换。
插件所需的转换组件由工具箱自动准备，普通客户不需要单独安装或移动程序文件。若启动转换时提示组件不可用，请联系软件提供方处理。
三、界面说明
插件只包含“操作”标签页。
“操作”页提供：
PDF来源：选择 PDF 文件或目录，也可从 Windows 资源管理器拖入；
保存文件夹：选择“保存到指定文件夹”时使用；
输出方式：三种互斥保存方式；
包含子文件夹：决定是否扫描所选目录的下级目录；
加载文件、开始转换、暂停/继续、取消和清空；
文件列表、状态筛选、分页数量、进度和失败原因。
输出方式、保存文件夹和文件列表分页数量直接在“操作”页设置，并会自动保存。
右上角的“返回”会回到插件列表；任务执行中返回时会先提示确认。“置顶”用于让工具箱窗口保持在其它窗口上方。
四、选择 PDF
方法一：选择文件
在“PDF来源”右侧单击“文件”。
在弹窗中选择一个或多个 PDF。
插件会自动扫描并显示文件列表。
方法二：选择目录
单击“目录”。
选择存放 PDF 的文件夹。
文件在下级目录时，开启“包含子文件夹”。
单击“加载文件”重新扫描。
方法三：拖拽
可以把 PDF、多个 PDF 或文件夹拖到“PDF来源”区域或文件列表区域。插件会读取真实 Windows 路径、去除重复项并重新扫描。
扫描规则：
扩展名 .pdf 不区分大小写；
插件还会检查文件头，伪装成 PDF 的其它文件会显示失败；
目录中的“文件名_灰白.pdf”“文件名_灰白(2).pdf”等历史输出会自动跳过，避免重复转换；
未开启“包含子文件夹”时，只扫描当前目录这一层。
五、三种输出方式
方式一：保存到原 PDF 文件夹
这是方便对比且不会修改源文件的方式。输出与源 PDF 放在同一目录，并自动增加“_灰白”后缀。
示例：
源文件：D:\资料\报告.pdf 输出： D:\资料\报告_灰白.pdf 如果目标已存在，会继续使用“报告_灰白(2).pdf”“报告_灰白(3).pdf”，不会覆盖已有结果。如果转换期间其它程序刚好创建了同名目标，本行会停止写入并提示失败，不会覆盖该文件；重新加载列表后再转换即可。
方式二：保存到指定文件夹
选择“保存到指定文件夹”，再选择一个保存目录。扫描多个子目录时，插件会尽量保留来源文件的相对目录结构。
示例：
源文件：D:\彩色资料\合同\合同A.pdf 保存目录：E:\灰度结果 输出：E:\灰度结果\合同\合同A.pdf 目标位置已有同名 PDF 时，只有在新文件转换并校验成功后才会覆盖该目标。需要保留旧结果时，请选择空目录或提前备份。 同一批次中如果多个来源文件映射到相同的相对路径，插件会为后续结果自动追加“(2)”“(3)”等序号，避免批次内互相覆盖。 同时选择不同盘符或不同共享根目录中的 PDF 时，无法保留共同目录结构，插件会按各自文件名输出；出现同名时仍会自动追加序号。
保存目录不能让计算出的输出路径与源文件相同；通过目录联接或符号链接实际指回源文件的路径也会被拒绝，否则该行会失败并提示更换目录。
方式三：覆盖源文件（高风险）
选择“覆盖源文件”后，开始转换前会出现红色确认框。插件先在源文件旁生成临时 PDF，确认转换成功且文件头有效后，再通过同目录备份与替换提交结果。写入失败时会自动恢复原文件并清理临时文件；如果极少数情况下自动恢复也失败，失败原因会显示原文件的备份路径，请不要删除该备份并联系软件提供方处理。
覆盖成功后插件没有撤销功能，原彩色 PDF 不能从插件内恢复。使用前必须自行备份。
六、开始转换
核对来源路径、文件数量和“包含子文件夹”设置。
在“操作”页选择输出方式；指定目录模式下确认保存文件夹已经选择。
单击“开始转换”。
转换组件不可用时，插件会在开始转换时提示错误；请联系软件提供方处理。
覆盖源文件模式下，再次确认风险。
等待文件状态变为最终状态。
每个 PDF 的转换参数由插件固定管理，页面没有隐藏的质量或分辨率参数。
七、文件列表和状态
单击列表上方的状态筛选按钮可以筛选文件，单击“总文件数”恢复全部。任务未运行时可以移除某一行或清空列表，这只改变本次任务列表，不会删除磁盘上的文件。
八、暂停、继续和取消
暂停
单击“暂停”后，当前正在转换的文件可能先完成；队列会在领取下一个文件前停住。按钮会变成“继续”。
继续
单击“继续”后，插件从剩余文件继续处理。
取消
单击“取消”会终止当前受控进程，并把尚未完成的项目标记为“已取消”。临时文件会清理，但取消前已经成功提交的输出不会回滚或删除。
返回或关闭
任务运行时单击“返回”或切换插件，工具箱会提示仍有任务。确认离开会中止未完成任务；选择留在页面则继续执行。
九、转换后的注意事项
插件会重新生成 PDF，而不是只修改一个颜色标记，因此结果可能与源文件存在差异：
原有数字签名通常会失效；
表单、批注、图层、附件、脚本、透明效果或特殊颜色空间可能变化；
某些嵌入字体、极端页面尺寸或损坏对象可能导致失败或显示差异；
加密或受密码保护的 PDF 可能无法处理；
文件大小可能变大或变小，灰度转换不等同于压缩。
重要业务文件应逐页抽查，特别是合同、票据、工程图纸、印刷文件和带数字签名的 PDF。
十、常见问题
1. 提示转换组件不可用
这不是 PDF 参数问题。请联系软件提供方检查插件所需组件是否已正确准备；普通客户不要手动改名、移动程序文件或修改安装记录。
2. 提示转换组件校验失败
转换组件文件损坏、不完整或准备失败时，工具箱不会继续使用不完整的组件。普通客户无需手动处理，可先检查磁盘空间与目录权限；问题仍存在时请联系软件提供方。
3. 文件没有出现在列表
检查扩展名是否为 PDF、文件是否只在下级目录、是否开启“包含子文件夹”，以及文件名是否已经带有“_灰白”或“_灰白(数字)”后缀。
4. 文件头不是有效的 PDF
文件内容不是标准 PDF，或文件已损坏。先用可靠阅读器打开并重新另存为 PDF，再加载转换后的文件。
5. 转换失败或提示文件被占用
关闭阅读器、编辑器、预览窗格和同步软件；检查源目录与保存目录的读写权限、磁盘空间和路径长度后重试。
6. 暂停后为什么当前文件还在处理
暂停作用于队列边界，不会把正在写入的 PDF 停在半成品状态。当前文件结束后才停止领取下一项，这是正常行为。
7. 取消后为什么仍有输出
取消只停止尚未完成的工作。取消前已经显示“已完成”的文件会保留。
8. 灰度文件为什么不一定更小
PDF 大小还受图片压缩、字体和对象结构等因素影响。插件目标是转换颜色，不保证压缩率。
9. 覆盖源文件后能恢复吗
不能。插件没有备份和撤销功能，只能从你在转换前制作的备份恢复。
十一、完整示例
假设源目录为：
D:\客户资料 ├─ 介绍.pdf └─ 合同 └─ 合同A.pdf 希望把结果放到新目录并保留结构：
单击“目录”，选择 D:\客户资料。
开启“包含子文件夹”。
选择“保存到指定文件夹”。
保存文件夹选择 E:\灰度结果。
单击“加载文件”，核对列表中有两个 PDF。
单击“开始转换”，等待两项显示“已完成”。
打开 E:\灰度结果\介绍.pdf 和 E:\灰度结果\合同\合同A.pdf 抽查。
十二、完成前检查清单
开始前：
源 PDF 可以正常打开。
子文件夹开关符合实际需要。
文件数量和相对路径已经核对。
输出方式和保存目录正确。
同名目标允许被覆盖。
覆盖源文件时已经备份。
阅读器、编辑器和同步软件没有占用文件。
插件所需资源已正确绑定并安装。
完成后：
任务已经停止。
失败与已取消项目已经逐项检查。
预期项目均为“已完成”。
指定目录模式下的相对目录结构正确。
至少打开并逐页抽查一个结果。
已检查字体、图片、透明效果、表单或批注等关键内容。
数字签名或其它交互功能的变化可以接受。