Git 仓库管理器

一个原生 macOS SwiftUI 应用，用于管理多个项目的 Git 状态。

功能特性

• 项目管理：添加项目根目录，自动递归扫描所有 Git 仓库
• 状态显示：实时显示每个仓库的分支、修改数、未推送提交数
• 基础操作：暂存、提交、拉取、推送、同步
• 分支管理：切换分支、创建分支、合并分支、获取远程
• 内置终端：执行任意 git 命令
• 项目组织：置顶项目、添加备注、拖拽排序
• 多语言支持：中文 / English
• 编辑器集成：右键快速在 VSCode / Cursor / Xcode / IDEA / PyCharm 中打开
• 快捷操作：右键菜单打开 Finder、终端

安装

方式一：直接下载（推荐）

1. 下载 GitRepoManager-macOS.dmg
2. 打开 DMG，将应用拖入 Applications 文件夹
3. 首次打开时，右键点击应用 → 打开（绕过 Gatekeeper）

方式二：从源码编译

需要 Xcode 14.0+，运行打包脚本：

./scripts/package_macos.sh Release --install

使用方法

1. 点击工具栏 + 按钮添加项目目录
2. 应用会自动扫描目录下的所有 Git 仓库
3. 在左侧列表选择仓库查看详情
4. 使用按钮执行常用操作，或切换到终端标签页执行自定义命令

快捷键

快捷键	功能
Cmd + R	刷新所有仓库状态
Cmd + N	添加新项目

右键菜单

项目右键：

• 重新扫描
• 置顶/取消置顶
• 编辑备注
• 移除项目

仓库右键：

• 在编辑器中打开（支持多编辑器选择）
• 在 Finder 中显示
• 在终端中打开
• 刷新状态

设置

工具栏提供：

• 默认编辑器选择（自动检测已安装的编辑器）
• 语言切换（中文 / English）

系统要求

• macOS 13.0 或更高版本

数据存储

配置数据存储在 ~/.project-git-status/config/ 目录：

• projects.json - 项目列表
• settings.json - 应用设置

项目结构

GitRepoManager/
├── App/                    # 应用入口
├── Models/                 # 数据模型
├── Services/               # 服务层（Git命令、持久化等）
├── ViewModels/             # 视图模型
└── Views/                  # UI视图
    ├── Sidebar/            # 侧边栏
    ├── Detail/             # 详情视图
    ├── Terminal/           # 终端视图
    └── Components/         # 通用组件

许可证

MIT License