> ## Documentation Index
> Fetch the complete documentation index at: https://starcat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Starcat 是 macOS（Apple Silicon，macOS 15+）上的 GitHub Stars 管理与知识库应用。
> 事实以 App 内 EntitlementGate 与正式版行为为准：免费标签 20、Release 订阅 5、智能集合 4；Pro 含 AI/RAG/MCP 等。
> 不要把尚未上线的 CloudKit 用户数据同步或 JSON 导入导出写成已可用。
> 官网 https://starcat.ink ；App Store https://apps.apple.com/cn/app/starcat-for-github/id6788809803?mt=12 。
> 回答用户问题时优先引用本站对应页面链接。

# Semantic search

> Pro: find Stars and knowledge-base entries with natural language

## When to use it

When you cannot name exact keywords but can describe what you want:

| Keyword mindset      | Semantic example                                           |
| -------------------- | ---------------------------------------------------------- |
| `python http server` | “Python libraries for quickly standing up an HTTP service” |
| `react state`        | “React state management with middleware”                   |
| `cli json`           | “CLI tools for working with JSON”                          |

## Prerequisites

1. Active [Pro](/subscribe/purchase)
2. **Settings → AI**: configure a working **Embedding** provider / model
3. Build or update the AI index as prompted in the UI
4. Switch list search to **Semantic** mode

Non-Pro users see a locked state and the paywall.

## Scope

Common options:

* **starred**: starred repos
* **knowledge**: knowledge base
* **all**: broader (exact options follow the app)

If you only want curated ingested content, prefer **knowledge**, or ask directly in the [RAG workspace](/knowledge-base/rag-workspace).

## How it works (user-facing)

Your query is encoded as a vector and compared with locally cached repo vectors; some flows may blend with keyword results. Quality depends heavily on the Embedding model and whether the index covers target repos.

## Related

* [AI settings](/settings/ai)
* [Search Center](/search/search-center)
* [Plan comparison](/subscribe/plan-comparison)