Appearance
全文搜索插件
插件信息
名称:全文搜索插件(search) 版本:v0.1.0 类型:官方插件 状态:已内置
概述
全文搜索插件为 MengStack 提供统一的搜索能力,支持跨内容类型搜索(文章、帖子、快讯)、搜索建议、热搜词管理和搜索日志记录。当前基于 SQL ILIKE 实现,后续可对接 Elasticsearch 等搜索引擎。
功能特性
- 多类型搜索:同时搜索文章、社区帖子、快讯等多种内容类型
- 搜索建议:根据输入关键词返回文章标题匹配和热搜词建议
- 热搜词管理:管理员配置热搜词,支持排序、过期时间、启用/禁用
- 搜索日志:记录每次搜索的查询词、用户、IP、结果数、耗时
- 搜索结果评分:按相关度排序搜索结果
数据模型
搜索日志(SearchLog)
| 字段 | 类型 | 说明 |
|---|---|---|
id | uuid | 主键(继承自 BaseModel) |
tenant_id | uuid | 租户 ID(继承自 BaseModel) |
query | string | 搜索关键词 |
user_id | uuid? | 搜索用户 ID(可为空,匿名搜索) |
ip | string | 搜索者 IP 地址 |
results | int | 搜索结果数量 |
duration | int64 | 搜索耗时(毫秒) |
created_at | time | 创建时间(继承自 BaseModel) |
updated_at | time | 更新时间(继承自 BaseModel) |
deleted_at | time | 软删除时间(继承自 BaseModel) |
热搜词(HotWord)
| 字段 | 类型 | 说明 |
|---|---|---|
id | uuid | 主键 |
tenant_id | uuid | 租户 ID |
word | string | 热搜词(租户内唯一) |
sort_order | int | 排序权重 |
search_count | int | 搜索次数 |
is_active | bool | 是否启用 |
expires_at | time? | 过期时间(为空则永不过期) |
created_at | time | 创建时间 |
updated_at | time | 更新时间 |
deleted_at | time | 软删除时间 |
搜索结果(SearchResult,仅响应体)
| 字段 | 类型 | 说明 |
|---|---|---|
id | uuid | 内容 ID |
type | string | 内容类型:article / post / flash |
title | string | 标题 |
summary | string | 摘要 |
url | string | 详情链接 |
score | float64 | 相关度评分 |
搜索范围
搜索引擎同时检索以下内容源:
| 内容源 | 表 | 匹配字段 |
|---|---|---|
| CMS 文章 | cms_articles | title、summary |
| 社区帖子 | community_posts | title、summary |
| 快讯 | flash_news | title、content |
搜索建议来源:
- 文章标题(
cms_articles.titleILIKE 匹配) - 启用状态的热搜词(
search_hot_words中is_active = true且未过期)
API 接口
公开接口
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/v1/search | 执行搜索(参数:q 关键词,type 类型过滤,page,page_size) |
GET | /api/v1/search/suggest | 获取搜索建议(参数:q 关键词) |
GET | /api/v1/search/hot-words | 获取热搜词列表 |
需认证接口
| 方法 | 路径 | 权限 | 说明 |
|---|---|---|---|
GET | /api/v1/search/logs | search.log.read | 查看搜索日志(分页) |
GET | /api/v1/search/top-queries | search.log.read | 获取热门查询统计 |
POST | /api/v1/search/hot-words | search.hotword.write | 创建热搜词 |
GET | /api/v1/search/hot-words/all | search.log.read | 获取全部热搜词列表 |
DELETE | /api/v1/search/hot-words/:id | search.hotword.write | 删除热搜词 |
事件
| 事件名 | 触发时机 |
|---|---|
search.performed | 每次搜索执行完成后 |
数据库表
| 表名 | 说明 |
|---|---|
search_logs | 搜索日志表 |
search_hot_words | 热搜词表 |
权限
| 权限标识 | 说明 |
|---|---|
search.log.read | 查看搜索日志和热门查询 |
search.hotword.write | 管理热搜词(创建、删除) |
依赖
- auth:用户认证
- rbac:权限模型
- org:多租户隔离
- cms:搜索文章内容(可选,未安装时跳过)
- community:搜索帖子内容(可选,未安装时跳过)
- flash:搜索快讯内容(可选,未安装时跳过)

