QA indexing preview ignores the 10-item limit

快速结论：当你在 Dify 的知识库索引预览中使用 Q&A 分段模式，且模型返回 10 条以上有效问答对时，会出现 “QA indexing preview ignores the 10-item limit”，即预览返回全部问答对而不受 10 条上限约束。优先排查 api/core/indexing_runner.py 中 indexing_estimate() 的计数器是否只检查了 preview_texts。

适用环境：Dify 1.17.1，Self Hosted（Source），复现分支为 upstream/main（bb02d3efcc）；Issue 未提供操作系统、Python、CUDA、显卡或依赖版本信息。

最快修复方案：暂无确认的一步修复方案。Issue 中给出的方向是：在 qa_model 分支内改为检查 len(qa_preview_texts) < 10，而不是复用 len(preview_texts)。

注意事项：该修复只应限制返回给前端的 qa_preview 预览列表，不应影响基于完整 documents 列表计算出的 total_segments；Issue 中尚未发现已合并的修复 PR，动手前请自行验证。

问题场景

在 Dify 中创建或打开知识库的 indexing preview，选择 Q&A segmentation（qa_model）模式，并上传一份可生成至少 11 组有效 Q1:/A1: 问答对的普通文档。随后调用 console 的 indexing-estimate 流程，或在 Web UI 中打开预览，检查响应中的 qa_preview 字段和前端渲染的预览条目。

报错原文

QA indexing preview ignores the 10-item limit

相关代码逻辑（来自 Issue 讨论）：

for document in documents:
    if len(preview_texts) < 10:
        if doc_form and doc_form == "qa_model":
            qa_detail = QAPreviewDetail(...)
            qa_preview_texts.append(qa_detail)   # unbounded
        else:
            preview_detail = PreviewDetail(...)
            preview_texts.append(preview_detail)  # bounded by the same check

原因分析

问题出在 api/core/indexing_runner.py 的 indexing_estimate() 中。循环的 10 条上限判断只作用于 preview_texts，而在 Q&A 模式下实际写入的是 qa_preview_texts。由于 preview_texts 在 Q&A 分支中始终为空列表，len(preview_texts) < 10 恒为 True，导致每个解析出的问答对都被追加进 qa_preview_texts，最终完整的列表被作为 qa_preview 返回。用于 Q&A 分段估算的 total_segments * 20 不受影响。

环境排查

确认 Dify 版本是否为 1.17.1，以及是否运行在 Self Hosted (Source) 模式。
确认所复现的分支/提交，例如 upstream/main（bb02d3efcc）。
检查 api/core/indexing_runner.py 中 indexing_estimate() 对应行的计数器逻辑。
确认知识库分段模式选择的是 Q&A（qa_model）。
确认模型返回的有效问答对数量是否已超过 10 组。
Issue 未提及操作系统、Python、CUDA、PyTorch、显卡或节点依赖，无需按这些项目排查。

解决步骤

打开 api/core/indexing_runner.py，定位 indexing_estimate() 中的文档遍历循环。
找到 if len(preview_texts) < 10: 这一判断。
在 doc_form == "qa_model" 分支内改用 len(qa_preview_texts) < 10 作为上限条件，使 Q&A 预览列表自身受 10 条约束。
保持 total_segments 的计算仍基于完整的 documents 列表，不因预览截断而改变。
保存后重启或重新加载后端服务，再重新触发 indexing-estimate 流程进行验证。

说明：上述步骤来自 Issue 讨论中给出的修复方向，尚未在 Issue 中确认已合并或发布，属于可优先尝试的方案。

验证方法

重新用同一份可生成 11 组以上有效问答对的文档，在 Q&A 分段模式下再次调用 indexing-estimate 或打开预览，检查返回的 qa_preview 是否最多只有 10 条，同时确认 total_segments 与修复前保持一致。若预览被限制为 10 条且总数估算不变，即可认为问题已解决。