核心功能
ComPDF Conversion CLI 是 ComPDFKit 官方推出的 Python SDK 封装工具，专注于 PDF 与图片的高精度格式转换。支持将 PDF 及 JPG/PNG/TIFF 等 8 种图片格式转换为 Word、Excel、PPT、HTML、Markdown、JSON、CSV、TXT、RTF、Image 共 10 种输出格式，覆盖文档数字化全流程需求。
显著优势
- AI 布局分析：内置约 525MB 的 Document AI 模型，可智能识别文档结构（表格、段落、栏位），默认启用
--enable-ai-layout，转换保留原始版式 - OCR 智能增强：支持 15 种语言识别（中/英/日/韩/阿拉伯等），图片输入自动触发 OCR，无需手动配置
- 格式智能适配：HTML 输出自动启用 BOX 布局模式，Excel 支持按页/按表/按文档分工作表策略
- 商业级可靠性：来自 KDAN 旗下 ComPDFKit 公司，SDK 经过数百万文档验证，转换稳定性高
- 离线可用：支持自定义 license.xml 和 model 文件，满足内网环境部署需求
潜在局限
- 试用限制：默认试用许可仅 200 次转换，超出需购买商业授权（https://www.compdf.com/contact-sales）
- 首载延迟：首次使用需下载 license.xml（~1KB）和 documentai.model（~525MB），网络环境差时体验受阻
- 平台限制：仅支持 Windows/macOS，Linux 环境无法运行
- Python 版本：实测依赖 Python 3.14 wheel，官方文档与实际包存在版本表述差异
适合人群
- 企业文档管理员：批量将扫描件/合同/报表转为可编辑 Office 格式
- 开发者：需集成 PDF 转换能力的 Python 项目（配合
--output-document-per-page实现细粒度控制） - 数据分析师：将 PDF 表格提取为结构化 Excel/CSV，支持
--excel-all-content保留全部信息 - 内容创作者：PDF 转 Markdown/HTML 用于网站发布，保留书签层级结构
常规风险
- 网络依赖风险：首次运行必须连接 compdf.com 下载授权文件，断网环境需预置文件
- 模型完整性风险：525MB 模型下载中断可能导致文件损坏，脚本已做
.part临时文件原子重命名防护 - 许可合规风险：禁止分发 SDK 源码/文档给第三方，企业部署需确保 license 覆盖实际使用节点
- 隐私注意：转换过程在本地执行，但 license 验证需联网，涉密文档建议配置离线 license