这个品类的数据长什么样
这个品类的数据主要来自预算管理一体化系统、项目申报材料、资金支付数据、业务系统台账及满意度调查。日常处理的文档包括绩效目标表、自评表、绩效评价报告、佐证材料清单、整改报告。数据更新频率为年度，文档结构多包含结构化字段与非结构化佐证内容，字段涉及绩效目标、资金使用情况、产出效果等，无额外自定义单位。
这些特征在「文档解析与分块」这一环带来什么约束
年度批量更新的特性要求单次处理多份跨系统文档，需适配不同来源的格式差异。文档混合结构化字段与非结构化佐证内容，分块时需避免割裂绩效目标与资金使用的对应关联，否则会影响后续核验环节。多类型文档并存的场景，需要灵活调整分块规则，适配自评表、整改报告等不同文档的语义结构。批量处理大体积佐证材料时，需预留足够的解析时长与上传空间，防止流程中断。
配置怎么定
仅作参考；请以目标 FastGPT 发布版本与部署文档核验。
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
chunkSize | 800–1200 字符 | 适配绩效评价报告、自评表的段落语义长度，避免割裂绩效目标与资金使用的对应关联 |
chunkSplitter | 语义分块 | 适配文档中结构化字段与非结构化佐证混合的结构，保留内容逻辑完整性 |
customPdfParse | 开启 | 适配多来源PDF格式差异，解决本地工具正常但平台解析失败的场景 |
PARSE_FILE_TIMEOUT_SECONDS | 600 秒 | 应对年度批量处理的大体积文档，避免解析超时 |
UPLOAD_FILE_MAX_SIZE | 1000 MB | 支持单批次批量上传年度项目的全套佐证材料 |
chunkSettingMode | 手动配置 | 针对不同文档类型（如自评表、整改报告）调整分块参数，适配细分场景需求 |
容易做错的三处
- 现象：解析后references字段为空或未关联佐证材料。原因：未开启适配多字段解析的自定义配置，仅默认解析正文内容，未识别文档中的关联字段。
- 现象：修改分块默认参数后未生效，平台仍使用原始分块长度。原因：误将源码修改路径指向非FastGPT核心配置文件，或未重启服务使配置生效。
- 现象：上传PDF后无解析选项或解析失败。原因：未正确配置
customPdfParse参数，或上传文件大小超过限制，导致平台跳过解析流程。
怎么确认配好了
- 上传单份绩效自评表，查看解析后的分块内容，确认绩效目标与资金数据未被拆分至不同块中。
- 上传包含关联字段的佐证材料清单，检查解析结果是否包含关联字段内容。
- 调整
chunkSize参数后，上传大体积PDF文档，确认解析过程未出现超时报错。 - 查看平台配置日志，确认
customPdfParse和PARSE_FILE_TIMEOUT_SECONDS参数已正确加载。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-28，当时的最新发布版本为 FastGPT v4.17.0。