用途:这是一个本地运行的 PDF 命令行工具(compdf_cli),基于 ComPDFKit 的页面管理能力,用于编辑和组织 PDF 页面,并处理格式转换、压缩、对比与水印。
主要能力:split 拆分(按单页或范围)、merge 合并、extract 提取页面、rotate 旋转、delete 删除、insert 插入页面或图片、convert 标准格式转换(PDF/A、PDF/X、PDF/E、PDF/UA)、optimize 压缩优化(图像压缩、Fast Web View、清理注解/书签/表单/元数据)、compare 双文档叠加对比、watermark-text 与 watermark-image 添加文字或图片水印、watermark-delete 删除全部水印。通用选项含 --output/-o、--name、--overwrite。页面范围仅支持 “N” 或 “N-M”,不支持逗号分隔。
首次使用:CLI 二进制不随包提供。需从 download.compdf.com 下载对应平台压缩包并解压到 {skill_root}/scripts/(含 win/ 或 mac/ 前缀);Mac 需 chmod +x {skill_root}/scripts/mac/compdf_cli,再运行 <CLI> --help 验证。随后激活许可:向用户索取邮箱,POST https://wms.compdf.com/api/license/skillsTrial,正文 {"email":"<email>"};code=200 则把返回的 data.license XML 写入 <LICENSE_PATH>,code=500 则提示换邮箱重试。
运行环境:Windows 用 scripts/win/compdf_cli.exe 与 license_key_windows.xml;Mac 用 scripts/mac/compdf_cli 与 license_key_mac.xml;Windows 命令行为 cmd,Mac 为 bash。
限制:除 merge 会自动跳过加密 PDF 外,加密 PDF 会报错退出;不支持通配符、输出路径等于输入路径、多线程并行;watermark-delete 只能全部删除,不支持选择性删除;compare 仅做可视化叠加对比,不输出结构化差异;格式转换与优化结果取决于输入内容。退出码 0 成功、1 参数错误、2 文件未找到、3 运行时错误、4 许可失败。Mac 水印平铺需显式传 --full-screen。所有 PDF 处理均在本地完成,不上传文件内容;首次使用涉及下载与仅发送邮箱的许可激活,此后的命令可完全离线运行。