mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 02:45:58 +00:00
56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
---
|
||
id: search.engine.concept
|
||
title: 搜索引擎(Manticore 与 MySQL 回退)
|
||
type: concept
|
||
feature: search
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 搜索引擎
|
||
- Manticore
|
||
- 搜索插件
|
||
- 搜索很慢
|
||
- 为什么搜不到文件内容
|
||
- 语义搜索
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites: []
|
||
negative:
|
||
- 未安装 search 插件时无法搜索文件正文，只能按文件名模糊匹配
|
||
- 未安装 search 插件时不支持语义 / 向量 / 混合搜索，只能精确关键词
|
||
- 向量搜索还需要 ai 插件提供 Embedding，仅装 search 没装 ai 也走不了语义
|
||
last_verified: 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` 已经慢
|