dootask/resources/ai-kb/zh/concept/search/engine.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.engine.concept	搜索引擎(Manticore 与 MySQL 回退)	concept	search	admin	zh	搜索引擎 Manticore 搜索插件 搜索很慢 为什么搜不到文件内容 语义搜索				未安装 search 插件时无法搜索文件正文，只能按文件名模糊匹配 未安装 search 插件时不支持语义 / 向量 / 混合搜索，只能精确关键词 向量搜索还需要 ai 插件提供 Embedding，仅装 search 没装 ai 也走不了语义	v1.7.90

搜索引擎(Manticore 与 MySQL 回退)

定义

DooTask 全局搜索底层有两套实现，按 Apps::isInstalled('search') 自动切换：装了应用市场的 search 插件就走 Manticore，没装就退回 MySQL LIKE 模糊查询。

Manticore 搜索引擎

Manticore Search 是独立的开源搜索引擎，作为可选插件部署在 DooTask 的 appstore 里。能力包括：

• 全文搜索（text）：倒排索引 + ICU 中文分词
• 向量搜索（vector）：1536 维 KNN（HNSW 算法），需配合 AI 插件生成 Embedding
• 混合搜索（hybrid，默认）：同时打全文和向量分，取加权综合排名
• 文件正文搜索：可搜 Word / Excel / PPT / PDF / TXT / 代码文件等内部文本

接口参数 search_type 取值 text / vector / hybrid，默认 hybrid，只在装了 Manticore 时生效。

MySQL 回退

未装 search 插件时调 searchByKeyword，用 MySQL LIKE %keyword% 匹配。能力受限：

• 只匹配字面关键词，不理解同义词或语义
• 不能搜文件正文（PDF / Office 内部文本搜不到）
• 大数据量下性能不如 Manticore
• 不支持 relevance 排序，按时间倒序

部署形态

插件镜像独立维护（appstore 应用：search），技术规格：

• 向量维度：1536，兼容 OpenAI text-embedding-3-small
• 中文分词：ICU Chinese
• 推荐至少 2GB 可用内存

何时升级到 Manticore

• 需要搜索文件内容（不仅是文件名）
• 用自然语言查文件（如「财务分析文档」→「Q3 收入报表」）
• 团队消息 / 任务量大，MySQL LIKE 已经慢