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

# RAG 工作台

> 独立窗口三栏：提问、@ 选仓、时间线、引用与索引

## 打开（Pro）

| 方式   | 说明                                                  |
| ---- | --------------------------------------------------- |
| 快捷键  | 默认 **⇧⌘K**（可改 → [快捷键](/zh-Hans/settings/shortcuts)） |
| 工具栏  | 「知识库问答」                                             |
| 其它入口 | 知识库页 / 相关 Smart Collection                          |

前置：

1. [Pro](/zh-Hans/subscribe/plan-comparison)
2. Chat + Embedding 已在 [设置 → AI](/zh-Hans/settings/ai) 配好
3. 知识库里至少有一些[已入库](/zh-Hans/knowledge-base/adding-repos)仓库

## 三栏布局

```
┌────────────┬─────────────────────┬──────────────────┐
│ 会话列表    │ 问答流 + 执行时间线   │ 引用 / 计划 / 索引 │
│ 新建/置顶   │ Composer + @        │ Evidence / Index  │
└────────────┴─────────────────────┴──────────────────┘
```

* 左右栏可拖拽调宽，重开窗口常会恢复
* 中栏在生成时可看到检索/规划/生成等步骤，运行中可手动折叠

## 提问流程

<Steps>
  <Step title="写问题">
    尽量具体。例如：

    * 「我知识库里做本地优先同步的库，冲突策略有哪些？」
    * 「@foo/bar @baz/qux 这两个在嵌入式场景怎么选？」
  </Step>

  <Step title="@ 选仓（可选）">
    输入 `@` 打开知识库仓库选择器；可多选；顶部芯片可删。
    用于 only / prefer / exclude 一类范围控制（以界面语义为准）。
  </Step>

  <Step title="发送">
    观察时间线；等待流式或分段输出。
  </Step>

  <Step title="核对引用">
    点击回答中的引用芯片 → 右侧证据。见 [引用与证据](/zh-Hans/knowledge-base/citations)。
  </Step>
</Steps>

## 默认检索范围

**只检索已入库仓库**，不包含「仅 Star 未入库」。

空库时会出现引导：从 Smart Collections、Search、Explore 入库。见 [添加入库](/zh-Hans/knowledge-base/adding-repos)。

## 联网上下文

若启用 External Search 作为实时上下文：

* 成功时回答可能混入网页证据
* 失败时卡片可能引导你打开 **设置 → 集成 → External Search**

见 [外部搜索](/zh-Hans/search/external-search)。

## 只读承诺

工作台以问答为主：**不会**在未确认时改标签 / 笔记 / 状态。要改数据请用整理 UI 或 [CLI `--apply`](/zh-Hans/cli/usage)。

## 会话与导出

左栏管理历史；可导出 Markdown。见 [会话管理](/zh-Hans/knowledge-base/session-management)。

## 索引不健康时

顶栏覆盖率过低或提示无索引 → [索引管理](/zh-Hans/knowledge-base/index-management)。

## 相关

* [知识库概述](/zh-Hans/knowledge-base/overview)
* [AI 配置](/zh-Hans/ai-features/configuration)
* [FAQ · AI](/zh-Hans/faq/ai)