Go: `ManualChunker` accepts but silently ignores `method` / `chunk_token_cap` / `include_heading_content`

快速结论：在 RAGFlow 的数据集解析器表单里给 manual chunker 填了 method / chunk_token_cap / include_heading_content，保存成功但切分时完全不生效，属于“保存成功但配置被静默丢弃”的情况。优先确认当前版本是否已包含 #20220 的修复，再看构造 ManualChunker 时是否输出了丢弃字段的 Warn 日志。

适用环境：Issue 已确认工具为 RAGFlow，组件为 Go 侧的 ManualChunker；标签为 bug / go。操作系统、Python、CUDA、显卡与依赖版本在 Issue 中未明确，不做补充。

最快修复方案：升级到包含 PR #20220（2026-10-22 合入）的版本。该 PR 让 ManualChunker 在构造时剥离上述三个参数并输出一条 Warn，而不是静默忽略。

注意事项：#20220 只解决“静默”问题，运行语义没有改变：三个参数对 manual 家族仍然不生效，只是会在日志里明确报出被丢弃的键。至于最终应该真正支持这三个参数、还是从表单里移除，Issue 里已明确列为后续工作，尚未有结论。

问题场景

在 RAGFlow 数据集解析器配置中使用 manual chunker 时，用户在表单里填写了 method、chunk_token_cap、include_heading_content。保存操作成功返回，但解析阶段 ManualChunker 在构造时并没有应用这三个值，导致用户以为配置已生效。Issue 指出这与 #19769、ApplyKB 的缺口属于同一类“表单承诺了运行时并不执行的设置”的静默无效问题。

报错原文

Go: `ManualChunker` accepts but silently ignores `method` / `chunk_token_cap` / `include_heading_content`

原因分析

从 Issue 描述看，manual chunker 的 operator 表单会接收并保存这三个参数，但在 NewManualChunker / 解析阶段，ManualChunker 并不读取它们。PR #20060 只是用代码注释记录了这一行为，没有作为缺陷跟踪。Issue 还明确区分了两个容易混淆的修复：PR #20043 / #20106 修的是数据集解析器标签页里 manual chunker 配置的显示问题，而这里的值是能往返保存但随后不被使用；PR #18551 只对 title-family chunk 强制 chunk_token_cap，不覆盖 manual 家族。

可能原因：manual chunker 的运行时价值在于 group-method 重排，因此 title-family 的三个参数在实现上没有对应语义，构造时直接被忽略。

环境排查

确认 RAGFlow 版本是否已包含 PR #20220（合入时间 2026-10-22）；此前版本仍为静默忽略。
确认出问题的节点是 manual chunker，而不是 title-family chunker；后者受 PR #18551 的 chunk_token_cap 约束，表现不同。
确认保存的配置是否确实来自 dataset parser 的 manual chunker 表单，避免与 #20043 / #20106 涉及的显示问题混淆。
Issue 未提供 Python、CUDA、PyTorch、显卡及依赖版本信息，这些不构成已确认的排查项。

解决步骤

将 RAGFlow 升级到包含 PR #20220 的版本。
升级后重新保存一次 manual chunker 配置，重新触发解析或构造 ManualChunker。
查看服务日志，确认每次构造出现一条 common.Warn，其中列出被丢弃的键（method / chunk_token_cap / include_heading_content）。
若在未升级版本上暂时无法升级，可优先尝试在配置中不再依赖这三个参数对 manual chunker 生效，避免把不生效的设置当作已应用。
若业务确实需要这三个参数对 manual 家族生效，目前无已验证实现；Issue 中把“支持参数”与“从表单移除”两种方案留作后续决策，需关注后续版本或 PR。

验证方法

升级后，无论调用方传入什么值，ManualChunker 构造结果应为 p.param.Method == "group"、p.param.ChunkTokenCap == 0、p.param.IncludeHeadingContent == false（与 #20220 新增测试断言一致），同时日志中出现一条列出被丢弃键的 Warn。若仍无任何提示、配置继续被静默忽略，说明当前运行的不是包含 #20220 的版本。