安装与系统要求

系统要求、App Store 与 Direct 的差异、安装步骤和更新方式

​

用途

Starcat 只提供 macOS 桌面客户端。App Store 和 Direct（官网 DMG）看起来是同一个 App，但本地数据库和 Pro 授权是两套。

​

系统要求

要求	说明
操作系统	macOS 15 Sequoia 或更高
芯片	Apple Silicon（M 系列）。没有 Intel 构建
网络	同步 Stars、探索、在线购买、通知需要联网
GitHub	需要 GitHub 账号才能拉 Stars

没有 Windows / Linux 桌面版。CLI 可以装在更多平台，但仓库数据和写权限仍来自本机（或已配对的）Starcat App。

​

两个渠道怎么选

​

Mac App Store

• 下载：Starcat for GitHub
• 运行在 App Store 沙盒里：不能启动你自己安装的 Codex CLI、CodeFlow 等外部可执行文件
• Pro 走 Apple 内购（StoreKit / Apple ID）
• 更新：启动或重新激活时检测新版本；操作菜单或菜单栏「检查更新」会打开 Mac App Store，Starcat 不自己下载商店包

​

Direct（官网）

• 下载：starcat.ink
• 打开 DMG，拖到「应用程序」
• Pro 走官网结账 + License，见 许可证
• 更新由 Sparkle 负责：启动检查，也可在设置或 操作 菜单里手动检查并安装
• 可配置本机 Agent Runtime、CodebaseMemory、RAG 的 CLI 推理等，见 集成

两个渠道的数据目录相互独立。换渠道等于换一套本地库。不要直接拷 SQLite 文件；先按 备份 处理。

Direct：DMG 窗口，Starcat 图标拖到 Applications

截图待补充 · images/screenshots/getting-started/direct-dmg.webp

​

安装步骤

1. 下载

   从 App Store 或官网取最新版。两个渠道不会自动合并数据。
2. 装入 Applications

   App Store 会直接装好。Direct 打开 DMG，把 Starcat 拖进「应用程序」。

3. 第一次打开

   若 Gatekeeper 拦截：系统设置 → 隐私与安全性 → 仍要打开。

4. 欢迎页

   全屏欢迎只出现一次。之后可在 设置 → 通用 → 重看首次引导 再看一遍（会重置 Getting Started 清单进度）。

首次全屏欢迎 / 功能导览

截图待补充 · images/screenshots/getting-started/welcome.webp

​

注意

• 本机可同时装着两个渠道，它们不会共用标签和笔记。日常用一个即可。
• Direct 的 Sparkle 更新入口不会出现在 App Store 构建里，避免审核包暴露自更新。
• 装好后下一步是登录并亲手点同步，见 快速开始。

​

相关

• 连接 GitHub
• 购买 Pro
• 备份