深浅模式
搜索与推荐
维护全站内容搜索索引，查看 Meilisearch 同步状态；相关推荐依赖可选推荐服务。
维护全站内容搜索索引，查看 Meilisearch 同步状态；相关推荐依赖可选推荐服务（如 Gorse）。
搜索索引（页面分区）
- 页顶统计卡片可快速判断 Meilisearch 是否在线、索引是否缺失或配置漂移
- 索引文档数与数据库行数长期偏差较大时，优先查同步队列是否有失败/死信
索引列表各索引文档数、数据库行数、连接状态；可单索引重建
同步队列增量同步事件：待处理 / 失败 / 死信；支持单条重试与批量重试
异步任务Meilisearch 后台任务进度与历史
同步索引配置将索引 schema 与 Meilisearch 对齐（非全量回灌）
全量重建从数据库回灌所有索引，耗时长，请低峰操作
运营日常维护
搜索索引为全站统一维护，不按区域拆分；以下建议由具备监控写权限的运维或运营负责人执行。全量重建会占用 CPU 与 IO，建议在深夜或业务低峰执行；重建进行中页顶会显示进度横幅。
- 1每日巡检打开搜索索引页 → 确认 Meilisearch 在线；扫一眼各索引文档数与数据库行数是否接近；同步队列无大量失败/死信
- 2内容上线后发布笔记、开通商家等批量操作后，隔几分钟刷新索引列表，确认对应索引文档数增长
- 3用户反馈搜不到先查内容是否未审核或被区域过滤 → 看同步队列失败项并重试 → 仍不行再对单索引重建（非全量）
- 4周度或低峰维护同步队列「重试全部失败/死信」；仅在 Meilisearch 升级或大面积缺失时执行全量重建
相关推荐（可选）
路径：系统监控 → 相关推荐评估。未部署时菜单可能为空。可选基础设施文档
区域配置
- 搜索索引为全站统一，文档内带 region_id 供客户端过滤
- 区域只影响用户能看到哪些内容，不需在区域管理单独开开关
验证是否生效
- 发布带独特关键词的测试笔记，客户端搜索能命中
- 搜索索引中文档总数与最近同步时间合理更新
常见问题
搜索无结果但内容存在Meilisearch 是否离线；笔记是否未审核或被区域距离过滤；查同步队列是否有失败项。
重建索引很慢大数据量正常；优先单索引重建，全量重建建议低峰操作。
同步队列堆积查看失败/死信原因；单条重试或「重试全部失败/死信」；持续堆积联系运维查 Meilisearch 容器。
没有搜索索引菜单当前账号无监控权限或搜索模块未启用。