核心用法
dify-kb-search 是一款专为 RAG（检索增强生成）设计的知识库搜索技能，通过调用 Dify Dataset API 实现智能文档检索。主要包含两大工具：
- dify_list：自动发现所有可用知识库，返回数据集 ID、名称、文档数量及描述
- dify_search：执行精准检索，支持
hybrid_search（混合）、semantic_search（语义）、keyword_search（关键词）三种搜索策略
通过环境变量配置 DIFY_API_KEY 和 DIFY_BASE_URL 即可零代码接入，无需硬编码任何参数。支持自动数据集发现、可配置返回数量（top_k）、结果重排序（reranking）等高级功能。
显著优点
1. 搜索策略灵活：三种搜索模式覆盖不同场景——混合搜索平衡精度与召回，语义搜索适合概念匹配，关键词搜索适合术语查询
2. 零配置上手：自动发现数据集 ID，减少手动维护成本
3. 企业级集成：原生支持 Dify 生态，无缝对接现有知识管理流程
4. RAG 原生设计：返回结构化结果含相关性分数、文档标题、内容片段，便于直接注入 LLM 上下文
5. 调试友好：提供详细错误分类（连接失败、权限不足、数据集缺失）和手动调试命令
潜在缺点与局限性
1. 依赖外部服务：完全依赖 Dify 实例可用性，无本地缓存或离线模式
2. 单次单库查询：不支持跨数据集联合搜索，多库场景需手动循环调用
3. 结果截断风险：返回内容为片段而非完整文档，复杂问题可能丢失上下文
4. 网络延迟敏感：API 调用引入额外延迟，高并发场景需考虑限流
5. 安全责任共担：API 密钥管理完全依赖用户环境变量配置，误配置风险较高
适合人群
- 已部署 Dify 知识库的企业用户
- 需要快速构建文档问答 AI 的开发者
- 希望将私有知识注入 LLM 对话的 RAG 应用架构师
常规风险
- 密钥泄露风险：API Key 若硬编码或误提交至版本控制，可能导致知识库数据泄露
- 数据出境合规：若 DIFY_BASE_URL 指向境外服务器，需评估数据合规要求
- 权限边界模糊：Dify API Key 通常具备完整数据集访问权限，缺乏细粒度 RBAC
- 搜索结果污染：若知识库包含过时或错误信息，RAG 会将其作为"可信来源"注入回答