更新日志索引设置#

验证状态：已源码核验、未联调（中心代理段已闭合；Meilisearch 服务器本体不在本工作区）；适用基线：源码归纳 @ 2026-09-14

用途与场景#

把分区日志索引的可过滤/可排序/可搜索属性与分页、分面上限收敛为 Web 期望值。当前 Web 在每次会话首搜时对命中的分区索引执行（幂等的收敛写，已有期望设置时零提交）。

使用位置#

页面/功能	角色或空间分支
分区日志搜索的索引初始化（用户日志/GPS/电量）	登录用户
MQTT 连接统计	同上

端点#

PATCH /main-service/system-api/meilisearch/indexes/{uid}/settings（SDK 经中心代理访问检索引擎）— 把分区索引设置收敛为 Web 期望值（幂等收敛写，无差异零提交）。

代理契约：MeilisearchProxyController 透传 /system-api/meilisearch/** 全部方法（登录 token 被代理剥除并以服务端 api-key 重写，响应不走中心 {status,data} 信封）；该代理不在 Swagger 分组，属清单层已知缺口项（allowlist 登记）。分区索引的写侧调度见设备业务 · runtime-links 运行时关联。

动线与完成判据#

HTTP 完成且无异常即「提交完成」；设置在引擎侧生效的时机本页不提供判据。若读-比阶段无差异则零提交。

错误与边界#

上游错误经代理保留上游 HTTP 状态（同枚举日志检索索引）。收敛写幂等：同一索引重复执行在设置一致时零提交；不一致时重复提交同一设置集合。

调用关系与资源清理#

无长连接资源。首搜流程：getIndexes → 过滤候选索引 → initIndexes（getSettings + 本操作）→ multiSearch。hasInitializedIndexesRef 保证每会话只初始化一次。

已知缺口#

Meilisearch 服务器本体不在本工作区：任务异步生效时机、api-key 权限模型（该 key 是否具备 settings 更新能力）、404/错误码行为未核验；代理层无细粒度权限意味着访问控制依赖部署配置。