这个决定什么时候必须做
当企业启动知识库建设、文档对话类应用开发，或现有文档解析流程无法覆盖多格式文档、解析准确率不达标时，该决策成为必须处理的问题。做早的代价：在未明确业务文档类型、解析需求量级前，提前部署增强解析或外部服务，会带来不必要的资源投入与配置复杂度。做晚的代价：若因解析能力不足导致知识库数据质量差、文档对话无法响应需求，会延误项目上线，影响用户体验，甚至导致已投入的业务流程返工。此外，当企业需要支持OCR识别、多模态文档解析，或现有内置解析服务存在兼容性问题（如图片上传解析超时、路径错误、循环结构BSON报错）时，也需启动该决策。例如，当遇到扫描版PDF无法正确识别、复杂表格解析混乱、图片在知识库中无法显示等场景时，现有内置解析方案已无法满足需求，需重新评估选型。
判据矩阵
| 候选方案 | 支持文档类型 | 图片解析能力 | 复杂格式处理能力 | 部署复杂度 | 配置依赖项 | 解析结果格式 | 兼容性 |
|---|---|---|---|---|---|---|---|
| 内置解析 | 普通文本、标准PDF、常见办公文档 | 基础图片解析，存在上传超时、路径拼接错误问题 | 扫描版PDF、复杂表格识别效果有限 | 无需额外部署，随主服务启动 | 依赖主服务环境变量，无额外配置 | 标准Markdown，部分场景存在span标签残留 | 存在循环结构BSON错误、分块配置异常等问题 |
| 增强解析服务 | 标准PDF、扫描版PDF、图片型文档 | 支持OCR识别，修复图片路径显示问题 | 支持全图片PDF、复杂表格识别，结果接近pdf-marker | 需额外部署解析服务（如MinerU、Doc2X） | 需配置解析服务地址、FILE_DOMAIN等环境变量 | 优化后的Markdown，减少span标签，支持表格HTML格式 | 需适配服务地址与环境变量，存在分块配置异常风险 |
| 外部解析服务 | 全格式文档（含专业格式） | 支持多模态OCR，可自定义识别模型 | 支持自定义解析逻辑，适配复杂业务场景 | 无需本地部署，调用第三方服务接口 | 需配置服务API地址、访问密钥等 | 可自定义返回格式，适配业务需求 | 依赖第三方服务稳定性，无本地部署兼容性问题 |
每个判据为什么重要
支持文档类型
支持文档类型决定了解析方案能否覆盖企业现有文档资产的全量范围。若方案仅支持普通文本格式，无法处理扫描版PDF、图片型研究报告等场景，会导致大量文档无法被有效解析，知识库数据覆盖率不足。例如当企业存在大量扫描版合同、图片型项目报告时，仅支持基础格式的内置解析方案无法满足需求，需切换至支持OCR的增强解析或外部服务。
图片解析能力
图片类文档的解析效果直接影响多模态知识库的质量。若图片解析存在超时、路径错误、无法显示等问题，会导致知识库中图片丢失、显示异常，降低用户对知识库的信任度。例如在预览文档时图片无法加载，会让使用者无法获取完整的文档信息，影响文档对话的准确性。部分场景下，图片解析失败还会导致整个文档解析任务中断，延误业务流程。
复杂格式处理能力
复杂格式如跨页表格、嵌套列表、数学公式等的解析效果，决定了专业文档的可用价值。若方案无法正确识别复杂表格，会导致数据丢失或格式混乱，无法用于后续的数据分析或问答。例如相关改进方案可实现全图片PDF的正确识别，弥补了基础解析的不足，让扫描版文档的内容可被有效利用。
部署复杂度
部署复杂度影响方案的落地周期与维护成本。无需额外部署的内置解析方案可快速上线，但功能有限，无法应对复杂场景的需求。需额外部署的增强解析方案需要配置服务地址、环境变量等，增加了运维工作量与学习成本。外部服务则无需本地部署，但依赖第三方服务的可用性与配置，需提前评估服务的稳定性与适配性。
配置依赖项
配置依赖项的多少决定了方案的适配难度。例如增强解析方案需要配置FILE_DOMAIN等环境变量来修复图片路径问题，若配置不当会导致图片无法显示，影响知识库的预览效果。而内置解析的配置依赖较少，但无法应对复杂场景的需求。若配置项过多或过于复杂，会增加运维人员的学习成本，降低方案的落地效率。
解析结果格式
解析结果的格式直接影响后续的分块、索引与展示。例如带有span标签的解析结果会导致前端渲染异常，无法正常显示文档内容。而优化后的Markdown格式可直接用于知识库分块与展示，减少后续的格式调整工作。此外，支持表格HTML格式的解析结果，可让复杂表格的内容在知识库中正常显示，提升用户体验。
兼容性
兼容性决定了方案能否与现有系统环境适配。例如存在循环结构BSON错误、分块配置不生效等问题，会导致解析任务失败，影响业务流程。若方案存在兼容性问题，需花费大量时间排查与修复，延误项目上线。因此，在选型时需优先考虑与现有系统环境兼容的方案，减少后续的维护成本。
换的代价
切换文档解析方案时，需承担多维度的成本。首先是数据迁移成本：已上传的文档数据需重新解析，若原解析结果存在格式问题，需重新处理现有知识库的所有文档，包括图片、文本、表格等内容，耗时与文档总量正相关。其次是索引重建成本：原有的向量索引基于旧的解析结果构建，切换方案后需清空原有索引，重新生成分块与向量数据，若使用了自定义索引规则，需同步调整索引配置。然后是停机窗口：部分切换操作需重启主服务或解析服务，会导致短暂的服务不可用，需选择业务低峰期执行，减少对业务的影响。验证工作量：需对切换后的解析结果进行全面测试，包括不同格式文档的解析效果、图片显示情况、复杂表格识别准确性等，需覆盖所有业务场景的文档类型，确保解析结果符合业务需求。此外，若使用了增强解析或外部服务，还需重新配置服务地址、环境变量等参数，避免出现路径错误、超时等问题。
什么情况下这个决定可以先不做
当企业的文档资产仅包含纯文本格式，且无图片、扫描版文档、复杂表格等场景时，该决定可以先不做。此时内置解析方案已可满足基础的文档解析需求，无需额外投入资源部署增强解析或外部服务。此外，若企业暂无知识库建设、文档对话类应用的规划，仅需基础的文档存储功能，也无需启动该决策。当解析需求的量级较小，且对解析准确率的要求不高时，也可暂缓选型决策，待业务需求明确后再进行评估。例如，企业仅需存储少量普通文本文档，无需进行复杂的问答或数据分析，内置解析方案已足够使用。另外，若企业已完成现有解析方案的配置，且当前业务场景未出现解析问题，也可暂缓决策，直到出现新的业务需求或现有方案无法满足需求时再进行调整。
继续阅读
参考资料
需要进一步确认时
上述判据可依据公开文档与部署实测逐项核对。若需要结合具体业务规模、数据边界与运维条件确定选型，可通过商务咨询获取评估支持；云服务形态可直接开始使用，先验证业务可行性再决定部署形态。