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

# AI features overview

> Pro AI capability map, entry points, setup prerequisites, and conservative policy

## Prerequisites

1. Activate [Pro](/subscribe/purchase) → see the entitlement table in [Plan comparison](/subscribe/plan-comparison)
2. Configure a Provider under **Settings → AI** ([BYOK](/subscribe/byok), [step-by-step setup](/ai-features/configuration))
3. Pick default models for each task: Chat (summary / chat / tags) and **Embedding** (semantic search / RAG)

Missing Embedding is the most common reason you have Pro but still cannot use semantic search or RAG.

## Capability map

| Feature             | Typical entry                               | Docs                                                   |
| ------------------- | ------------------------------------------- | ------------------------------------------------------ |
| AI summary          | Detail panel **⇧⌘A**                        | [Summary](/ai-features/summary)                        |
| AI chat             | Same panel; can detach to a separate window | [Chat](/ai-features/chat)                              |
| Tag recommendations | Panel / Auto Tidy                           | [Tag recommendations](/ai-features/tag-recommendation) |
| README translation  | README toolbar                              | [Translation](/ai-features/readme-translation)         |
| AI personal notes   | **Generate with AI** in the notes area      | [Personal notes](/ai-features/personal-notes)          |
| Semantic search     | List semantic mode                          | [Semantic search](/search/semantic-search)             |
| RAG Q\&A            | **⇧⌘K**                                     | [Knowledge base](/knowledge-base/overview)             |
| Auto Tidy           | Settings → AI                               | [Auto Tidy](/ai-features/auto-tidy)                    |
| Agent workspace     | Separate window                             | [Agent Beta](/agent-workspace/overview)                |

Notes:

* The **web** scope in [Search Center](/search/search-center) does not require Pro
* If AI attaches live web context, Pro and toggle rules still apply → [External search](/search/external-search)

## Conservative policy

| Scenario            | Rule                                          |
| ------------------- | --------------------------------------------- |
| Tag recommendations | Written only after you confirm                |
| AI notes            | Saved only after you confirm the draft        |
| Agent               | Data changes require explicit authorization   |
| Auto Tidy           | Runs only the actions and triggers you enable |

## Recommended onboarding order

<Steps>
  <Step title="Configure models">[AI configuration](/ai-features/configuration) → test connection.</Step>
  <Step title="Try one repo">Detail → ⇧⌘A → summary or ask one question.</Step>
  <Step title="When you need semantic search">Add Embedding → build index → list semantic mode.</Step>
  <Step title="When you need cross-repo Q&A">Curate ingest → [RAG workspace](/knowledge-base/rag-workspace).</Step>
  <Step title="Then automate">After output quality looks good, enable [Auto Tidy](/ai-features/auto-tidy).</Step>
</Steps>

## Related

* [AI settings overview](/settings/ai)
* [FAQ · AI](/faq/ai)