PDF Editor 是一个 PDF 文档处理命令行工具（CLI），构建于 ComPDFKit 的页面管理能力之上，主要面向需要批量、自动化处理 PDF 页面的场景。工具以命令行为交互方式，可由 Agent 自动检测平台并执行相应命令，无需用户手动说明操作系统。
一、主要能力 围绕页面与文档管理，提供以下命令：
- split：拆分 PDF，可按逐页（all）或按范围（range）拆分。
- merge：合并多个 PDF 文件，加密 PDF 会被自动跳过，剩余不足 2 个未加密文件时命令失败。
- extract：按指定范围提取页面。
- rotate：按指定页码与角度（90/180/270）旋转页面。
- delete：删除指定页面。
- insert：向目标 PDF 插入源 PDF 的页面或插入图片，并可指定插入位置与图片页面尺寸。
- convert：转换为标准格式，支持 pdfa-1a、pdfa-1b、pdfa-2a、pdfa-2b、pdfa-2u、pdfx-4、pdfe-1、pdfua-1，可指定 ICC 配置文件；PDF/UA 可设置标题与语言。
- optimize：文档优化与压缩，支持图像压缩、图像质量、目标 PPI、压缩算法选择，以及移除注释、书签、表单、元数据等；默认会移除未使用/空对象并启用 Flate 压缩，图像压缩需显式开启。
- compare：以叠加方式对比新旧文档，可配置颜色、透明度、混合模式与页面范围，输出为视觉叠加对比而非结构化差异列表。
- watermark-text / watermark-image：添加文字或图片水印，支持页面范围、字体、字号、颜色、透明度、旋转、缩放、对齐、偏移、间距、前景/背景、平铺等选项。
- watermark-delete：删除全部水印，不支持选择性删除。
二、使用方式 首次使用需完成两步准备：一是从 download.compdf.com 下载对应平台的 CLI 压缩包并解压到 scripts 目录（Mac 需执行 chmod +x 赋予执行权限），下载仅在首次进行；二是进行许可证激活，用户提供邮箱后向官方许可服务器提交以获取免费试用许可证，成功后写入本地 license_key_windows.xml / license_key_mac.xml。通用选项包括 --output/-o 指定输出路径、--name 指定输出文件名、--overwrite 允许覆盖。退出码含义为：0 成功、1 参数错误、2 文件不存在、3 运行时错误、4 许可证失败。
三、适用场景 适合需要对 PDF 做页面级整理的任务，例如批量拆分与合并、按页码抽取或删除页面、统一旋转、插入封面或插图、将文档转换为 PDF/A 等归档标准、压缩体积、版本间视觉比对，以及添加或清除水印。
四、限制 页面范围仅支持 "N" 或 "N-M"，不支持逗号分隔的多段范围；除 merge 外，加密 PDF 会导致报错退出；不支持通配符、输出路径与输入路径相同以及多线程并行执行；标准格式转换与优化效果取决于输入 PDF 内容；watermark-delete 无法选择性删除；compare 不输出结构化差异列表。Mac 平台平铺水印需显式传入 --full-screen。
五、隐私与网络 所有 PDF 处理均在本地进行，不上传文件内容。外部交互仅在首次使用时发生：从官方服务器下载 CLI 二进制文件（不发送数据），以及提交邮箱获取许可证。CLI 不收集使用统计、崩溃报告或匿名数据，初始设置完成后可完全离线运行，许可证文件仅保存在本地 scripts 目录。