核心用法
extract-pdf-compdf 是一款集成 ComPDF Cloud REST API 的文档处理技能，支持 50 余种 PDF 相关操作。核心功能包括：
格式转换：PDF ↔ Word/Excel/图片/Markdown 等双向转换
页面编辑：合并、拆分、旋转、删除 PDF 页面
内容处理：添加/移除水印、PDF 压缩、密码保护处理
智能识别：OCR 文字识别、AI 文档提取与解析（支持表格、发票结构化数据）
批量处理：单次任务最多 5 个文件，支持队列管理
使用流程遵循标准 API 调用模式：配置 API Key → 确认外部上传授权 → 选择服务节点（国际/中国）→ 匹配操作类型 → 构建参数 → 同步请求 → 结果处理。所有文件上传前必须获得用户明确同意，并告知 24 小时下载链接有效期限制。
显著优点
- 功能全面：单一技能覆盖文档处理全生命周期，从格式转换到智能解析
- 输出格式丰富：支持 JSON、XML、CSV、Excel、TXT、HTML 等结构化导出，便于对接自动化分析与 LLM 工作流
- AI 能力集成：内置 IDP（智能文档处理）模块，可自动提取发票、合同等复杂文档的关键字段
- 双节点部署：自动适配国际（compdf.com）与中国大陆（compdf.cn）网络环境
- 安全可控：API Key 本地存储完全由用户自主决定，可随时删除；每次上传前强制确认
潜在局限
- 外部依赖：文件必须上传至 ComPDF 云端处理，存在数据出境/出域风险
- 配额限制：免费套餐 30 天内限 200 个文件，大容量需求需付费升级
- 同步阻塞：采用同步
/process/端点，大文件或复杂任务可能导致响应延迟 - 链接时效：下载链接次日 24:00 失效，需及时保存结果
- 网络敏感：中国用户需正确选择 .cn 域名，否则可能连接失败
适合人群
- 企业自动化流程开发者（需将 PDF 数据导入 ERP/CRM 系统）
- 财务/法务人员（批量处理发票、合同扫描件）
- 数据分析师（提取 PDF 表格转为 Excel/JSON 进行分析）
- LLM 应用构建者（将文档内容结构化后输入 RAG 流程）
- 跨国团队（需处理中英混合文档及双区域合规要求）
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 数据隐私 | 文件上传至第三方云服务器 | 上传前强制用户确认；敏感文档建议脱敏或选择本地化方案 |
| API 密钥泄露 | Key 存储于本地文本文件 | 明确告知用户删除 `config/public_key.txt` 可随时撤销 |
| 服务中断 | 依赖 ComPDF 商业服务可用性 | 关注任务状态码，实现重试机制；保留原始文件备份 |
| 配额耗尽 | 免费额度有限 | 监控 `asset/info` 端点，提前预警 |
| OCR 识别误差 | 扫描件质量影响识别准确率 | 建议对关键字段人工复核，尤其涉及金额、日期等敏感数据 |