合并了《培训用完整操作手册》附录（10条）和《两天AI学习与项目实战·完整总结》故障案例集（12条）后去重的完整版本，共13条，每一条都是真实发生过的问题。遇到问题直接按现象查对应条目，也可以按"发生阶段"对照到对应章节。
| 编号 | 发生阶段 | 现象 | 可能原因 | 解决方法 |
|---|---|---|---|---|
| 1 | 第5章数据准备 | txt文件上传失败 | Mac TextEdit默认保存为RTF格式，不是真纯文本 | 改用Excel格式，顺带获得更可控的切片单元 |
| 2 | 第5章 建知识库 | 检索完全不生效，像关键词搜索 | 索引方式误选了"经济"模式 | 改选「高质量」 |
| 3 | 第5章 建知识库 | 知识库处理卡在"排队中"不动 | Embedding模型没有真正保存生效，还停在默认模型上 | 重新选择模型保存，用"可用"开关关闭再打开，强制触发重新处理；仍卡住则检查硅基流动账户余额 |
| 4 | 第5章 检索设置 | 检索到低相关度内容，AI"矬子里拔将军"（比如问菌菇相关问题却答成鲈鱼） | 知识库里没有真正相关的数据，检索仍强制返回Top K条 | 开启Score阈值（比如0.45），过滤低分结果 |
| 5 | 第8章 / 第9章 | 意图判断准确，但流程总走进同一个分支 | 条件分支的IF/ELIF判断值填错或重复（复制粘贴时没改值） | 逐条核对每个CASE的判断值是否不同 |
| 6 | 第9章 条件分支 | ELIF连接的节点是空的 | 用"+"新建导致没连到已有节点 | 改用拖拽连接线的方式手动连接到已有节点 |
| 7 | 任意新增节点后 | 新节点（如分类器）运行正常但流程断裂 | 新增节点后忘记手动连线到下一个节点 | 拖拽连接；这类问题不会报错，需要完整查看工作流运行记录才能发现 |
| 8 | 第10章 | 某分支（多知识库检索节点）检索返回空结果，AI开始编造内容 | 多知识库检索节点有独立的"召回设置"，其中默认选中了Rerank模型（如网易有道），报403权限错误 | 把召回设置切换到「权重设置」模式，语义1.0，绕开有问题的Rerank模型；原理见第6章 |
| 9 | 第11章 | SYSTEM里插入了变量，但"上下文未设置"警告不消失 | 用了普通变量语法（如{{#节点.result#}}），不是专门的"上下文"占位符 |
用{x}图标从变量列表底部选「上下文」选项插入 |
| 10 | 第11章 | 生成回答节点显示成功，但对话框看不到任何回复 | 忘记在后面接"直接回复"节点，LLM生成的内容只存在内部变量里 | 添加直接回复节点，用{x}插入对应text变量 |
| 11 | 附录C | AI回答答非所问，语气像在回应用户没说过的具体情况（"榴莲怎么看好坏"答成"你的有酒精味"语气） | 知识库数据的问题字段混合了不同粒度的提问方式 | 把通用问法和具体场景问法拆成独立的两条数据，且要同步修改旧数据，不能只加不改 |
| 12 | 附录C | 回答开头总是"你是想问...吧" | Prompt里没有约束表达方式 | 加一条"不要用复述句开头，直接回答"的要求 |
| 13 | 多轮对话场景（已在正文实现，不再是"进阶未覆盖"） | 开了"记忆"依然答非所问（比如先问"想买点水果"推荐车厘子凤梨，追问"有货吗"却答成推荐草莓） | "记忆"只能帮助分类判断，不能让检索环节理解用户省略掉的上下文 | 在「开始」和「意图判断」之间加一个Query改写节点，结合对话历史主动补全省略信息，并把后续节点的输入都改成引用它的输出，详见第7章 |