需单独配置同义词表和术语库，因dify不自动识别语义等价关系，如“重置密码”与“初始化账户凭证”、“crm”与“客户关系管理平台”无法自动匹配，否则rag效果断崖式下跌。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为什么需要单独配置同义词表和术语库
当用户搜索“重置密码”时，知识库中只存着“初始化账户凭证”，AI大概率无法匹配；同样，“CRM系统”在文档里写作“客户关系管理平台”，但没做映射，检索就直接失效。Dify默认不自动识别这类语义等价关系，必须手动导入结构化同义词与术语数据，否则RAG效果会断崖式下跌。
准备同义词表：JSON格式必须严格达标
新建一个文本文件，命名为synonyms.json，内容必须是标准JSON数组，每个对象含source和targets两个字段：
[{"source":"重置密码","targets":["初始化账户凭证","清除登录状态","还原认证信息"]},{"source":"CRM","targets":["客户关系管理平台","客户管理系统"]}]
【source字段值必须唯一，且不能包含空格或特殊符号】。如果出现重复source，Dify导入时会静默跳过后续同名项，导致部分同义词丢失。
准备术语库：CSV格式需三列且无标题行
用Excel或记事本新建CSV文件，命名为glossary.csv，仅保留三列：术语原文、标准译名、简要解释。示例：
AI智能体,智能体应用,基于大模型构建的可执行任务单元
向量嵌入,向量化表示,将文本转换为高维空间数值向量的过程
保存时务必选择UTF-8编码，**不要带BOM头**。带BOM的CSV在Dify中会导致首列乱码，整个术语库解析失败。
上传同义词表与术语库到知识库
进入Dify工作台→知识库→选择目标知识库→点击右上角“设置”图标→下滑至“高级设置”区域→找到“同义词表”和“术语库”两个上传入口。
方法一：同义词表上传
点击“同义词表”旁的“上传文件”，选择已准备好的synonyms.json，确认上传。上传后页面不会立即刷新，需手动点击右上角“保存更改”按钮才生效。
方法二：术语库上传
点击“术语库”旁的“上传文件”，选择glossary.csv，上传完成即刻启用，无需额外保存操作。
注意：两个文件必须分别上传，不可打包压缩，也不可合并为一个文件。Dify不识别zip或合并后的混合格式。
验证同义词与术语是否生效
第一步：在知识库详情页点击“测试检索”按钮
第二步：输入原始术语，例如“CRM”→观察返回结果中是否出现“客户关系管理平台”相关段落
第三步：输入同义词，例如“重置密码”→检查是否命中含“初始化账户凭证”的文档块
第四步：若未命中，立即检查JSON中source字段是否拼写一致、CSV是否含隐藏BOM、知识库是否已重新索引（上传后约2分钟自动触发）
