AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
fix(image-search): make query relevance the primary scoring dimension
hugohe301960fd4a7fe
diff --git a/skills/ppt-master/scripts/image_search.py b/skills/ppt-master/scripts/image_search.pyindex 75ff3f8b..f4f75c73 100644--- a/skills/ppt-master/scripts/image_search.py+++ b/skills/ppt-master/scripts/image_search.py@@ -177,11 +177,19 @@ def two_stage_search(if not candidates:continue- ranked = sorted(- candidates,- key=lambda c: score_candidate(c, request),- reverse=True,- )+ # Score and rank; drop candidates rejected by score_candidate+ # (score == -inf — typically zero relevance against the query).+ scored = [(score_candidate(c, request), c) for c in candidates]+ ranked = [+ c for s, c in sorted(scored, key=lambda sc: sc[0], reverse=True)+ if s != float("-inf")+ ]+ if not ranked:+ print(+ f" no candidate matched the query; trying next provider/stage",+ file=sys.stderr,+ )+ continuefor candidate in ranked:try:diff --git a/skills/ppt-master/scripts/image_sources/provider_common.py b/skills/ppt-master/scripts/image_sources/provider_common.pyindex 0ea0801a..9039a795 100644--- a/skills/ppt-master/scripts/image_sources/provider_common.py+++ b/skills/ppt-master/scripts/image_sources/provider_common.py@@ -308,17 +308,69 @@ def normalize_orientation(width: int, height: int) -> str:return "square"+def _query_tokens(query: str) -> list[str]:+ """Extract ASCII keyword tokens from a query for relevance scoring.++ Uses the same noise-word filtering as ``simplify_query`` so the+ relevance signal lines up with the keywords we actually search by.+ Non-ASCII tokens (CJK etc.) are dropped — image metadata is mostly+ English even on multi-language providers, so substring matching CJK+ against an English title is unreliable. When this leaves no tokens,+ ``compute_relevance`` falls back to neutral (1.0) and lets the other+ score dimensions decide.+ """+ cleaned = re.sub(r"#[0-9a-fA-F]{3,8}", "", query.lower())+ cleaned = re.sub(r"\([^)]*\)", "", cleaned)+ words = [w for w in cleaned.split() if len(w) > 2 and w.isascii()]+ if not words:+ return []+ after_hard = [w for w in words if w not in _NOISE_WORDS]+ after_soft = [w for w in after_hard if w not in _SOFT_NOISE_WORDS]+ return after_soft if after_soft else after_hard+++def _candidate_text(candidate: AssetCandidate) -> str:+ """Concatenate the candidate's matchable metadata fields for scoring."""+ return " ".join(filter(None, (candidate.title, candidate.author))).lower()+++def compute_relevance(candidate: AssetCandidate, query: str) -> float:+ """Fraction of query tokens that appear in the candidate's metadata.++ Range ``[0.0, 1.0]``. Returns ``1.0`` (neutral) when the query has no+ ASCII tokens to match — this lets non-English queries fall through+ to license / size scoring without being unfairly rejected.+ """+ tokens = _query_tokens(query)+ if not tokens:+ return 1.0+ text = _candidate_text(candidate)+ if not text:+ return 0.0+ hits = sum(1 for t in tokens if t in text)+ return hits / len(tokens)++def score_candidate(candidate: AssetCandidate, request: ImageSearchRequest) -> float:- """Score a candidate against a request. Higher is better; -inf rejects."""+ """Score a candidate against a request. Higher is better; -inf rejects.++ Relevance dominates: a candidate whose metadata shares no query+ tokens is rejected outright, so size / license / orientation cannot+ rescue an irrelevant image from a permissive provider.+ """if not candidate.license_tier:return float("-inf")- score = 10000.0+ relevance = compute_relevance(candidate, request.query)+ if relevance == 0.0:+ return float("-inf")++ score = relevance * 10000.0- # Strongly prefer no-attribution candidates so the deck stays clean- # even when both tiers are returned in the same search.+ # No-attribution preference is a tie-breaker, not a steamroller —+ # keeping it small lets a strongly-relevant CC BY beat an irrelevant CC0.if candidate.license_tier == LICENSE_TIER_NO_ATTRIBUTION:- score += 5000.0+ score += 500.0candidate_orientation = normalize_orientation(candidate.width, candidate.height)requested = (request.orientation or "").strip().lower()