用途:针对个人语雀知识库做自然语言搜索与问答,适合用户想知道自己的文档中是否有某信息、查找某份文档或特定内容时使用。触发说法如“搜一下我的文档”“search my Yuque”“我的知识库里有没有……”。仅覆盖个人知识库,团队知识库需用 yuque-group 插件中的 smart-search。
主要能力:依赖 yuque-mcp 服务器的两个工具——yuque_search(按关键词搜索文档)和 yuque_get_doc(按 slug/id 读取文档全文)。流程为:先从用户问题提取1-3个简短中文关键词;调用 yuque_search(query 为关键词,type 为 doc);再按标题相关性、更新时间、所属个人仓库筛选前3-5篇;随后最多读取3篇文档(repo_id 取 book.namespace,doc_id 取 target.slug),首篇已能完整回答时可跳过其余;最后按“回答 / 关键要点 / 参考文档”格式输出,附文档链接、知识库名称与更新日期。
使用方式:工具参数需从搜索结果嵌套字段提取——target.slug 作 doc_id,target.book.namespace 作 repo_id,target.title 为标题,target.updated_at 为更新时间。回答语言与用户一致。
限制:不得编造文档中不存在的信息;搜索为空时应尝试同义词或拆分复合词,仍无结果则如实告知未找到;文档信息冲突时说明差异并指出较新者;答案不完整时说明缺什么。yuque_get_doc 返回 404 则跳过并提示文档可能已删除;403 则提示可能无访问权限;API 超时重试一次后提示连接问题;结果过多时聚焦前3篇并说明还有更多。