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

# 备份与恢复

> 手动备份本地数据；云同步尚未上线

## 为什么要备份

标签、笔记、状态、智能集合规则等**无法从 GitHub 重新生成**。换机、重装、误点恢复出厂前，请先备份。

## 手动备份（推荐）

<Steps>
  <Step title="完全退出 Starcat">避免拷贝到正在写入的数据库。</Step>

  <Step title="复制数据目录">
    Direct 常见路径：

    ```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
    ~/Library/Application Support/Starcat/
    ```

    App Store 版在沙盒容器内，路径不同。可在 **设置 → 存储** 用 Finder 入口定位后再拷贝。
  </Step>

  <Step title="存到安全位置">外置盘 / 加密备份均可。</Step>
</Steps>

## 手动恢复

1. 完全退出 Starcat
2. 将备份恢复到**同一渠道**对应路径（App Store 与 Direct 不要混用）
3. 再打开 App

## 云同步（即将推出）

<Warning>
  iCloud / CloudKit 用户数据同步**尚未提供**。本站不会再写「打开同步开关即可换机恢复」的假步骤。
</Warning>

## 优先级表

| 优先级 | 数据                      |
| --- | ----------------------- |
| 高   | 标签、笔记、状态、集合规则           |
| 中   | AI / RAG 会话历史           |
| 低   | README / 图片 / 摘要缓存（可重建） |

Stars 列表可重新同步，一般不必单独备份。

## 相关

* [存储说明](/zh-Hans/data-privacy/storage)
* [数据导出（即将推出）](/zh-Hans/share-export/data-export)