核心用法
pdf-editor-compdf 是基于 ComPDFKit SDK 的专业 PDF 处理 CLI 工具封装 Skill，通过 Agent 自动下载并调用官方二进制实现文档操作。首次使用需从 download.compdf.com 下载平台专用 CLI（Windows 为 compdf_cli.exe，Mac 为 compdf_cli），并用邮箱在 wms.compdf.com 激活免费试用许可。
主要功能矩阵：
- 页面管理：
split（拆分单页/按范围）、merge（多文件合并）、extract（提取指定页）、delete（删除页面）、insert（插入 PDF 页面或图片）、rotate（90°/180°/270° 旋转） - 格式转换：
convert支持 PDF/A-1a/1b/2a/2b/2u、PDF/X-4、PDF/E-1、PDF/UA-1 标准转换，内置 sRGB/FOGRA ICC 配置文件 - 优化压缩：
optimize提供图像压缩（JPEG/JPEG2000/JBIG2/CCITT）、页面内容优化、Fast Web View、元数据/批注/书签/表单清理 - 安全标记：
watermark-text/watermark-image支持文字/图片水印（可配置透明度、旋转、平铺模式），watermark-delete移除全部水印 - 文档比对：
compare生成视觉叠加对比图，用红蓝双色高亮差异
跨平台差异注意：Mac 水印需显式传递 --full-screen 才启用平铺模式，Windows 默认平铺；Mac 透明度用 0-1 浮点，Windows 用 0-255 整数。
显著优点
1. 企业级 SDK 背书：ComPDFKit 是 KDAN 旗下 PDF Technologies, Inc. 的商业级 PDF 引擎，合规性经过 ISO 标准验证
2. 纯本地化执行：所有 PDF 处理在本地完成，文件内容零上传，满足敏感文档离线处理需求
3. 标准格式支持：完整的 PDF/A 和 PDF/UA 无障碍标准转换，适合档案长期保存和政府/医疗合规场景
4. 参数设计专业：提供 ICC 色彩配置、增量保存、图像 PPI 控制等高级选项，超越普通开源工具
5. 自动化友好：CLI 接口配合 Agent 可实现批量文档处理流水线，支持 --overwrite 等无人值守选项
潜在局限与风险
1. 首次配置门槛：必须完成二元下载 + 邮箱激活两步初始化，无法即开即用；许可过期需联系销售（exit code 4）
2. 页码语法受限：仅支持 "N" 或 "N-M" 格式，不支持逗号分隔多段范围（如 "1-3,5,8-10"）
3. 加密文档处理差：除 merge 自动跳过加密文件外，其余命令遇加密 PDF 直接报错退出
4. 水印删除粗放：watermark-delete 只能全删，无法选择性移除特定水印
5. 对比功能局限：仅生成视觉叠加图，不输出结构化差异列表（如文本增删位置）
6. 商业许可依赖：试用到期后需付费，长期使用成本高于开源替代方案（如 qpdf、pdftk、cpdf）
适合人群
- 企业合规部门：需要将大量文档转为 PDF/A 存档格式的档案管理员
- 设计/出版流程：处理印刷前文档、需精确控制色彩配置（ICC）和图像压缩的专业人员
- 法律/财务团队：对文档安全性敏感、要求本地处理不上云的合同审查场景
- 自动化集成者：希望将 PDF 处理嵌入 Agent 工作流、需要稳定 CLI 接口的开发者
- Mac/Windows 跨平台用户：需要统一命令体验的双平台办公环境
常规风险
- 供应链风险：CLI 二进制从 CDN 下载，虽经 TLS 加密但仍存在中间人攻击或 CDN 入侵的理论可能
- 邮箱隐私：激活时邮箱传输至 ComPDFKit 服务器，需评估是否符合组织数据跨境政策
- 二进制权限：下载的 CLI 获得本地文件系统读写权限，建议沙箱运行
- 许可失效风险：试用过期后功能中断，关键业务流程需提前规划商业授权