# foldgit **Repository Path**: liyu2015/foldgit ## Basic Information - **Project Name**: foldgit - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-11 - **Last Updated**: 2026-11-11 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

FoldGit

FoldGit

把所有仓库,折进一个窗口。
原生、轻量的 macOS Git 客户端。

官网 · 使用手册 · English

FoldGit 的 macOS 界面:仓库分组、提交关系图、目录树、暂存区与展开的并排差异 ## 为什么做 FoldGit 越来越多的代码由 AI Agent 生成,查看改动常常不必再打开 IDE。但生产代码仍需要有人过一遍:改了哪些文件、动了哪几行、有没有越界。 FoldGit 就是为此准备的一个轻巧、安静的窗口:所有仓库随手可及,改动看得清楚,界面遵循 macOS 的视觉习惯。现有 Git 客户端很难同时做到美观、简洁和轻量;方向相近的项目也有,但交互和底层都已偏离太远,不适合在原项目里调整,于是重新开始。 ## 功能 - **折叠仓库,而不是移动文件夹。** 所有仓库常驻侧边栏。导入一个目录,其中的仓库自动成组;也可以新建分组,把不同位置的仓库收在一起。分组不会移动任何文件夹,不活跃的仓库可以再折一层。 - **工作树是一等公民。** 自动发现关联工作树,带着分支名显示在所属仓库下方。支持新建、移动、锁定、移除和清理缺失记录;「完成工作树」可合并到目标分支并收尾清理。侧边栏显示各工作树状态,已合并的可一键清理。合并冲突在原生弹窗中处理。 - **查看与提交。** 提交图(可查看当前分支或全部提交),单栏与双栏差异(随窗口宽度自动切换),代码块暂存,修改上次提交,撤销提交,提交信息模板与常用片段。 - **提交视角与目录视角。** 按提交查看改动,或浏览带语法高亮的完整文件,并可从任意差异直接跳转查看(macOS)。 - **分支、标签与比较。** 切换、合并、重命名和删除分支,管理标签,比较任意两个分支或标签。 - **原生菜单与快捷键。** 通过菜单栏打开最近使用的仓库、执行仓库与提交操作、定位 HEAD,以及控制差异显示。帮助菜单内提供快捷键说明。 - **快速搜索。** 按作者、邮箱或提交信息实时筛选历史。搜索在后台进行,复用索引、分页返回,新输入会取消旧查询,支持中文输入法上屏后触发。 - **仓库多了也不乱。** 可按目录名、仓库文件夹名或自定义显示名称过滤;可按名称、最近打开、最近修改、最近添加排序,或保留手动顺序。 - **日常所需。** 推送与拉取,Stash,自动获取(只下载、不合并),在编辑器或终端中打开,亮暗色外观,八种界面语言。 - **原生且小巧。** SwiftUI 与 AppKit 原生实现,不含 Electron,安装包仅几 MB。 ## 安装 需要 macOS 26 及以上的 Apple Silicon Mac,并已安装 Git。没有 Git 的话,运行 `xcode-select --install`。 ### Homebrew 已安装 [Homebrew](https://brew.sh/) 的用户可以直接运行: ```sh brew install --cask dufu1991/tap/foldgit ``` 更新时,先运行 `brew update`,再运行 `brew upgrade --cask dufu1991/tap/foldgit`。 ### 下载 DMG 1. 在 [Releases](https://github.com/dufu1991/foldgit/releases/latest) 下载最新的 `FoldGit-macOS-arm64.dmg`。 2. 打开 DMG,把 FoldGit 拖进「应用程序」。 ### 首次打开 FoldGit 安装后,在「应用程序」里双击 FoldGit。如果 macOS 提示无法验证该应用,请按以下步骤操作。 1. 在弹窗中点「完成」。 2. 打开「系统设置 → 隐私与安全」,向下找到「安全性」,在 FoldGit 的提示旁点「**仍要打开**」。 3. 确认打开 FoldGit。如果系统要求验证身份,按提示完成验证。 后续可在 FoldGit 中通过「检查更新」安装新版本。通过 DMG 或 Homebrew 替换应用后,macOS 可能再次要求放行。
找不到「仍要打开」时 如果找不到「仍要打开」,或 macOS 提示 FoldGit「已损坏」,先从 FoldGit 官方发布页重新下载并重试。确认应用来源可信且未被篡改后,如果仍无法打开,可在终端执行以下命令,移除这份应用的下载隔离标记,再重新打开 FoldGit。 ```sh xattr -dr com.apple.quarantine /Applications/FoldGit.app ```
### 使用手册 见 foldgit.com 上的[使用手册](https://foldgit.com/manual)。 ## Windows 版 仓库中还包含一个基于 C#、WinUI 3 和 .NET 10 的 Windows 客户端(Windows 11 24H2 及以上,x64 与 ARM64)。它目前只是最简实现,作者没有 Windows 设备,无法继续打磨。非常欢迎感兴趣的你参与建设,开发步骤见 [Windows 说明](Platforms/Windows/README.md)。 在 [Releases](https://github.com/dufu1991/foldgit/releases/latest) 下载 Windows x64 或 ARM64 的 EXE,双击安装即可,无需另行下载运行时。 ## 支持 FoldGit FoldGit 由 dufu 独立开发和维护。如果它让你查看代码、管理仓库更轻松,欢迎通过赞助支持后续开发与维护。感谢每一份支持! - [Buy Me a Coffee](https://www.buymeacoffee.com/dufu1991) - [PayPal](https://paypal.me/dufu1991) 海外用户可使用上述链接,国内用户可通过微信或支付宝扫码赞助。点击二维码可查看原图。
微信赞赏支付宝收款
微信赞赏二维码 支付宝收款二维码
## 开发 ### 目录结构 ```text Package.swift 共享 Swift Package 入口 Package.resolved 共享依赖锁定 Shared/ Sources/FoldGitCore/ 平台无关的 Git 与业务核心 Resources/Branding/ 共享图标源文件、矢量图层与通用图片 Resources/FileIcons/ 共享文件类型图标与匹配规则 Resources/Localization/ 八种语言的文案源目录 Resources/Licenses/ 项目许可与第三方许可声明 Fixtures/ 跨语言行为样例 Testing/ 可复用的临时仓库测试工具 Tests/FoldGitCoreTests/ 独立共享核心测试 Platforms/ macOS/ 原生 macOS 应用及其全部私有文件 Sources/ SwiftUI、AppKit、状态绑定和系统服务 Resources/ 本地化与 Apple 资源目录 Configuration/ 应用标识、签名和导出配置 Tests/ macOS 界面与系统集成测试 FoldGit.xcodeproj/ Xcode 工程 project.yml macOS 工程生成配置 Windows/ WinUI 3 应用、C# 核心、系统适配与安装包打包 Scripts/ 资源生成、校验与打包工具 website/ 落地页与使用手册(静态页面) .github/ 共享核心与平台构建工作流 ``` 共享模块不依赖 AppKit、SwiftUI 或 macOS 偏好存储。macOS 应用通过本地 Swift Package 依赖引用核心,不把共享源码重复编译到应用模块。 ### 共享核心 使用 Swift 6.2 或更新版本,并确保 Git 位于 `PATH` 中。在项目根目录执行: ```sh swift test python3 Scripts/check-platform-boundaries.py python3 Scripts/validate-windows.py # 校验无需 XAML 编译器即可检查的 Windows 输入 ``` CI 分别验证共享核心、Windows 共享核心和 macOS 应用。 ### macOS 应用 仅支持 Apple Silicon Mac,最低系统版本为 macOS 26,使用 Xcode 27.1、Swift 6.4 验证。打开 `Platforms/macOS/FoldGit.xcodeproj` 开发。 本地 Debug 构建和测试使用固定的 Apple Development 证书,以便 macOS 在重新构建后继续识别已有的文件访问授权。首次配置时,将 `Platforms/macOS/Configuration/LocalSigning.xcconfig.example` 复制为同目录下的 `LocalSigning.xcconfig`,填写证书的团队标识(证书主题中的 `OU` 字段)。该文件已加入 Git 忽略列表,可以把 `CODE_SIGN_IDENTITY` 设置为证书的 SHA-1 指纹以固定具体证书。开发时保持相同的 Bundle ID 和应用路径,构建命令不要传入 `CODE_SIGNING_ALLOWED=NO`;首次切换签名可能需要重新授权一次。CI 中不启动交互式应用的构建仍可显式禁用签名。 ```sh xcodebuild test -project Platforms/macOS/FoldGit.xcodeproj -scheme FoldGit \ -configuration Debug -destination 'platform=macOS' python3 Scripts/validate-localizations.py ``` 翻译统一在 `Shared/Resources/Localization` 中维护。Xcode 构建时调用 Python 3,在应用包内生成原生翻译资源。 使用 XcodeGen 2.45 或更新版本重新生成 macOS 工程: ```sh xcodegen generate --spec Platforms/macOS/project.yml ``` ### 图标与本地打包 共享品牌资源位于 `Shared/Resources/Branding`。macOS 直接引用分层图标,Windows、网站构建与 README 共用同目录的无损 WebP 原图。 生成仅含 Apple Silicon(`arm64`)架构的本地 Release 安装包: ```sh Scripts/package-macos.sh ``` 产物位于 `dist/macos`,包含 `FoldGit.app`、以 `macOS-arm64` 命名的 DMG 和 ZIP,以及 SHA-256 校验文件。本地脚本使用 ad hoc 签名,不执行 Apple 公证。 ### 发布 用 `python3 Scripts/version.py set <版本号>` 设置版本并推送到 `main`,[发布工作流](.github/workflows/release.yml)会发布 macOS DMG 与 Windows EXE 安装包。Homebrew tap 每 6 小时自动检查新版本,使用自身的 `GITHUB_TOKEN` 更新 Cask,无须配置个人令牌;GitHub 调度繁忙时可能延迟。 macOS 使用 Sparkle 进行应用内更新。CI 必须配置固定的 `SPARKLE_EDDSA_PRIVATE_KEY`,并在构建时生成带签名的 `appcast.xml`,作为 Release 附件发布;更新包与更新源均经过 EdDSA 验证,不使用 Developer ID。日志仅维护在 `Shared/Resources/Updates/changelog.json`,与网站构建共用;中文界面显示中文说明,其余语言暂时显示英文。密钥、发版和实际升级验证说明见 [macOS 更新维护](Platforms/macOS/UPDATES.md)。 ### 网站 `website/` 保存落地页与使用手册的源文件,发布在 [foldgit.com](https://foldgit.com)。运行 `python3 Scripts/build-website.py`,从共享资源生成 `dist/website`。构建依赖、Cloudflare Pages 配置、本地预览与截图方式见 [website/README.md](website/README.md)。 ## 开源许可 FoldGit 是由 dufu 独立维护的开源项目,采用 [MIT 许可证](LICENSE),自有代码版权归 dufu 所有。 第三方代码与资源保留各自的版权与许可声明,包括 Sparkle、ShikiSwift(MIT)、Swift Subprocess(Apache-2.0)、Swift System(Apache-2.0,含 Swift Runtime Library Exception)和 Material Icon Theme(MIT)。macOS 发布包随附 ShikiSwift 的全部语法文件、GitHub Light 和 GitHub Dark 两套主题,以及随包资源的许可声明。Windows 还包含 .NET Community Toolkit MVVM、Windows App SDK 和 Win2D。组件清单、来源版本、本地修改说明与许可条款位于 [Shared/Resources/Licenses/LICENSE.txt](Shared/Resources/Licenses/LICENSE.txt),随两个平台的应用分发,可在设置的「开源许可」中查看。