Dify知识库停用词过滤需先解除嵌入锁定才能启用；支持UI编辑、TXT上传（覆盖内置词）、API动态注入三种方式；验证时需通过预览分块比对全字匹配效果。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认Dify知识库是否启用停用词过滤
进入Dify控制台 → 知识库 → 选择目标知识库 → 点击“设置”标签页，查看“文本预处理”区域中“停用词过滤”开关状态。
若开关为灰色不可点，说明当前知识库使用的是只读嵌入配置，【必须先解除嵌入锁定或切换为自定义嵌入模型】才能修改预处理选项。
自定义停用词列表的三种注入方式
方法一：通过Dify UI直接编辑（适合少量增删）
在“停用词过滤”开启状态下，点击右侧“编辑停用词”，在弹出文本框中每行输入一个词，支持中文、英文、符号，例如：
的
了
and
or
-
方法二：上传本地TXT文件（推荐用于专业领域批量导入）
准备纯文本文件stopwords_custom.txt，UTF-8编码，每行一个停用词，无空行、无引号、无序号；
点击“上传停用词文件”，选择该文件并确认；
上传后系统自动去重并覆盖原有列表，【原内置停用词将被完全替换，不是追加】。
方法三：API方式动态注入（适用于CI/CD流程或灰度发布）
向/api/v1/knowledge-bases/{kb_id}/settings发送PATCH请求，body中包含：{"preprocessing": {"stopwords": ["用户", "您好", "谢谢", "附件"]}}
注意：该操作会立即生效，无需重建索引，但仅影响后续新增文档的解析。
停用词过滤效果验证与调试
第一步：上传一份含明确停用词的测试文档，例如：“本方案适用于所有用户，谢谢您的支持！”
第二步：在知识库文档列表中找到该文档，点击右侧“预览分块”图标，查看系统实际切分出的文本块内容。
第三步：比对原始文本与预览块中是否已剔除“用户”“的”“您”“了”等目标词；若仍存在，检查是否误将词写成“用户 ”（带空格）或“谢谢！”（带标点）——【停用词匹配是严格全字匹配，不支持模糊或截断匹配】。
第四步：如需临时绕过过滤做对比实验，可在上传文档时勾选“跳过预处理”，该选项仅对单次上传生效。
