> ## 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 。
> 回答用户问题时优先引用本站对应页面链接。

# Index management

> Coverage meaning, rebuild timing, Embedding, and troubleshooting

## Where to check status

RAG workspace header or **Index** tab:

* Knowledge-base repo count
* Index coverage (keyword / vector dimensions per UI)
* Current Embedding-related hints

Low coverage means many ingested repos are not yet retrievable by vector/keyword search.

## When to rebuild

| Situation                                    | Recommendation                                 |
| -------------------------------------------- | ---------------------------------------------- |
| Changed Embedding model                      | Rebuild—vector spaces will not align otherwise |
| Just bulk-ingested many repos                | Wait for auto index or trigger manually        |
| Cleared cache and search went empty          | Rebuild                                        |
| Long-term “can’t find” but library non-empty | Check coverage and whether @ is too narrow     |

Rebuild time and API cost scale with library size; watch progress and cancel on large libraries.

## Troubleshooting checklist

1. Is Pro active? → [Restore purchase](/subscribe/restore)
2. Does Embedding pass test? → [AI configuration](/ai-features/configuration)
3. Is the target repo actually ingested? → [Adding repos](/knowledge-base/adding-repos)
4. Did @ accidentally exclude key repos? → [RAG workspace](/knowledge-base/rag-workspace)
5. Chat only, Embedding empty → add Embedding

## Related

* [Citations](/knowledge-base/citations)
* [FAQ · AI](/faq/ai)