在 Mac 上打开现有 Project。

开始之前#

需要 macOS 14（Sonoma）或更新版本，以及 GitHub.com 账号。桌面端支持个人和组织 Projects，暂不支持 GitHub Enterprise Server。

从下载页下载 ZIP，解压后将 GitStride.app 移入“应用程序”文件夹。

连接 GitHub 账号#

1. 打开 GitStride，在欢迎窗口选择打开 GitHub 设置，然后点击登录 GitHub…。
2. 选择复制代码并打开 GitHub，在 GitHub 的设备激活页面粘贴验证码并确认授权。
3. 选择个人账号或组织，再打开你已有的 Project。

你可以随时通过设置 → GitHub → 账户管理连接，也可以从帮助 → 欢迎使用 GitStride…重新打开欢迎窗口。

了解授权范围#

桌面 OAuth 请求 repo project read:org offline_access。其中 repo 包括仓库代码读写及私有仓库访问，范围大于仅查看看板。访问令牌和刷新令牌保存在 macOS 钥匙串中。

可查看和编辑的内容由 GitHub 权限决定。组织策略和 SSO 可能要求额外授权。本地缓存说明见隐私与权限。

已经使用 GitHub CLI？#

GitHub Release 版可以复用 CLI 登录。先安装 GitHub CLI，再运行：

gh auth login --hostname github.com
gh auth refresh --hostname github.com --scopes project,read:org

断开当前 App 连接后，选择设置 → GitHub → 连接方式 → GitHub CLI。GitStride 会继续使用连接时选定的账号，直到重新连接。断开 GitStride 不会退出终端中的 GitHub 登录。

继续使用现有工作流#

通过工作区指南了解视图与编辑。PR 自动化是可选功能，有独立授权流程；浏览和编辑 Project 不需要开启它。