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

# Knowledge base overview

> Stars vs knowledge base boundaries, capability map, and onboarding path

## What the knowledge base is

The knowledge base is a **curated set of repositories you explicitly ingest** for retrieval and Q\&A in the RAG workspace. It is not the same as “all Stars.”

## Stars vs knowledge base

|                   | Stars                    | Knowledge base                  |
| ----------------- | ------------------------ | ------------------------------- |
| Source            | Synced from GitHub stars | Marked for ingest in Starcat    |
| Scale             | Can reach thousands      | Curated (often dozens to \~200) |
| List search       | ✅                        | ✅ (can also limit to knowledge) |
| Default RAG scope | ❌                        | ✅ ingested repos only           |
| Typical index     | FTS, etc.                | Chunks + keywords + vectors     |

Independence (remember this):

* Starring **does not** auto-ingest
* Unstarring **does not** auto-remove from the knowledge base
* Not starred but ingested: still searchable; you can also [subscribe to Releases](/release/subscription)

## What you need

1. [Pro](/subscribe/plan-comparison)
2. Chat + **Embedding** → [AI configuration](/ai-features/configuration)
3. Some ingested repositories → [Adding repos](/knowledge-base/adding-repos)

## Capability map

| I want to…                      | Go to                                                    |
| ------------------------------- | -------------------------------------------------------- |
| Add repos to the knowledge base | [Adding repos](/knowledge-base/adding-repos)             |
| Start asking questions          | [RAG workspace](/knowledge-base/rag-workspace) (⇧⌘K)     |
| Inspect cited source text       | [Citations & evidence](/knowledge-base/citations)        |
| Manage session history          | [Session management](/knowledge-base/session-management) |
| Fix low index coverage          | [Index management](/knowledge-base/index-management)     |

## Recommended onboarding path

<Steps>
  <Step title="Ingest 20–50 repos">Prioritize repos you actively use or consult often.</Step>
  <Step title="Confirm Embedding and coverage">[Settings → AI](/settings/ai) + workspace Index tab.</Step>
  <Step title="Try @ one repo first">Verify citations open correctly.</Step>
  <Step title="Then ask cross-repo questions">Remove overly narrow @, or @ two or three repos to compare.</Step>
</Steps>

## Entry points

* Sidebar Manage → Knowledge base / Library
* Toolbar “Knowledge base Q\&A” or default **⇧⌘K**
* Knowledge-related Smart Collections

## Related

* [Semantic search](/search/semantic-search) (list-level vector retrieval, not workspace Q\&A)
* [AI overview](/ai-features/overview)