From 262cec6fece65c360eabbc5a6a70c4f82663f686 Mon Sep 17 00:00:00 2001 From: Sleeps Date: Thu, 8 Oct 2026 10:30:16 +0100 Subject: [PATCH] Add caption-only lexical retrieval to Meilisearch client --- scene_search/meili.py | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/scene_search/meili.py b/scene_search/meili.py index 8652d05..c993c92 100644 --- a/scene_search/meili.py +++ b/scene_search/meili.py @@ -144,6 +144,32 @@ class Meili: self.session.get(f"{self.url}/indexes/{self.index}/stats") ).json() + def search_caption_text( + self, + query: str, + limit: int = 20, + filter_expression: str | None = None, + ) -> dict: + """Find literal caption matches without visual-vector dilution. + + The field restriction prevents title and tag matches from masquerading + as caption hits. Requiring all terms avoids loose one-word matches + displacing ordinary Jellyfin search results. + """ + payload = { + "q": query, + "limit": limit, + "attributesToSearchOn": ["caption"], + "matchingStrategy": "all", + "showRankingScore": True, + } + if filter_expression: + payload["filter"] = filter_expression + return self._check(self.session.post( + f"{self.url}/indexes/{self.index}/search", + json=payload, + )).json() + def search_vector( self, vector: Iterable[float],