dootask/resources/ai-kb/zh/concept/search/intelligent.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
search.intelligent.concept	智能搜索(AI 语义搜索)	concept	search	end-user	zh	智能搜索 AI 搜索 语义搜索 自然语言搜索 intelligent_search 向量搜索	intelligent_search		应用商店（应用市场）已安装 search 插件（Manticore Search） 应用商店已安装 ai 插件（语义 / 向量搜索需用其生成 Embedding）	未安装 search 插件（Manticore）时回退普通 MySQL 关键词搜索，无语义能力 仅装 search 没装 ai 时，向量 / 语义 / 混合搜索无法生效，只能跑全文 text 索引建立有延迟，刚上传 / 新建的内容可能短时间内搜不到 智能搜索按权限过滤，搜不到的对象通常是无权访问	v1.7.90

智能搜索(AI 语义搜索)

定义

智能搜索是 DooTask 基于 Manticore Search 插件（search 插件）的统一检索能力，支持关键词（text）/ 语义向量（vector）/ 混合（hybrid）三种搜索类型，一次可跨任务 / 项目 / 文件内容 / 联系人 / 消息 5 类对象；AI 助手通过 MCP 工具 intelligent_search 调用同一套底座。

底层原理

• 走 SearchController 统一接口，优先使用 Manticore Search（需安装 search 插件）
• 未安装 search 插件时回退到普通 MySQL 关键词搜索，仍可按字面匹配搜索，但没有语义 / 向量能力
• 默认 search_type = hybrid（混合搜索）：同时打全文倒排分和 KNN 向量分
• 向量分由 ai 插件提供 Embedding（1536 维，兼容 OpenAI text-embedding-3-small）
• 中文用 ICU 分词，能处理常见同义词与近义表达

与关键词搜索的区别

• 关键词搜索：只命中字面匹配，「Q3 收入报表」搜「财务分析」会落空
• 智能搜索：理解意图，「财务分析」能命中「Q3 收入报表」「年度成本表」等语义相关文件
• 智能搜索仍保留关键词命中能力，相关度由混合算法加权

关键属性

• 入口：装齐 search + ai 后，全局搜索框会出现「AI 搜索」按钮，把搜索词转给 AI 助手；AI 助手自动调用 intelligent_search 工具
• 结果排序：按 relevance 综合分降序
• 权限范围：与基础 search 接口完全一致，只返回当前用户能看到的对象
• 延迟：依赖 Manticore 索引；新增内容入库到可搜的间隔通常为秒级

与全局搜索的关系

• 全局搜索 = 用户在搜索框内主动输入关键词的检索能力，详见 search.concept
• 智能搜索 = AI 助手在对话中代用户调用的同一套底座，搜索类型默认 hybrid

不支持

• 没装 search 插件（Manticore）时回退 MySQL 关键词搜索，关键词 / 语义 / 混合类型参数失效
• 装了 search 但没装 ai 插件时降级到全文，语义能力失效
• 不能跨用户搜别人的私聊 / 私有文件
• 单次每类对象不会返回超过 50 条（最多 50 条）