GitSync：移动端 Git 仓库同步客户端

项目简介

GitSync 是一款面向 Android 和 iOS 的跨平台 Git 客户端，核心目标是简化「远端仓库 ↔ 本地目录」的同步流程。完成一次性设置后，它就能在后台持续保持文件同步，同时提供多种手动触发方式，非常适合管理笔记库（如 Obsidian vault）、配置文件等需要版本管理的手机目录。

应用基于 Flutter 开发，并通过 flutter_rust_bridge 使用 Rust 编写核心逻辑。

主要功能

• 支持 Android 5+ 与 iOS 13+
• 认证方式：HTTP/S、SSH、OAuth（GitHub、GitLab、Gitea）
• 克隆远端仓库
• 同步仓库：fetch、pull、stage、commit、push，支持解决合并冲突，网络恢复后自动重试
• 多种同步触发机制：
  • App 打开或关闭时（Android）
  • 按周期定时同步
  • 快捷磁贴（Android）
  • 桌面小组件
  • iOS 快捷指令或自动化
  • 自定义 intent（进阶用法）
• 应用内浏览与编辑：文件浏览器、代码编辑器、图片查看器；最近提交记录与文件 / 行 / 提交 diff；分支管理（创建、重命名、删除、切换）；多远端管理（添加、重命名、删除、设置 URL）
• GitHub / GitLab 集成（通过 OAuth 登录后）：查看、评论、创建 issue 与 pull request，查看 workflow 运行（GitHub Actions）
• AI 功能：围绕仓库对话、提交信息等文本框的自动补全、可执行仓库操作的 Agent，聊天 / 工具 / 补全可分别选择模型，并提供一键隐藏全部 AI 功能的开关
• 用容器（containers）管理多个仓库
• 仓库级设置：签名提交、自定义同步提交信息、作者信息、编辑 .gitignore 与 .git/info/exclude、按仓库关闭 SSL 校验

安装与使用

普通用户可直接从官方分发渠道安装：Google Play、App Store、F-Droid、IzzyOnDroid 或 Obtainium。

如果你希望自行构建，需要准备 Flutter（版本见仓库 .fvmrc，当前为 3.35.2，使用 FVM 管理）、Rust stable 工具链、Android Studio（minSdk 21）或 macOS 上的 Xcode 15+ 与 CocoaPods。

git clone https://github.com/ViscousPot/GitSync.git
cd GitSync
fvm flutter pub get

OAuth 登录需要配置客户端 ID / 密钥，仓库提供了模板：

cp lib/constant/secrets.dart.template lib/constant/secrets.dart

设置 oauthRedirectUrl = "gitsync://auth"。若不配置，OAuth 登录流程不可用，但 HTTPS Basic 与 SSH 认证仍可正常使用。

Rust API 变更后需要重新生成桥接代码：

cargo install flutter_rust_bridge_codegen --version 2.12.0
flutter_rust_bridge_codegen generate

运行：

fvm flutter run

注意事项

• 项目采用 GPL-3.0 许可证。
• 自建版本必须自行准备 OAuth 凭据，否则只能使用 HTTPS Basic / SSH 认证。
• 更多说明可查阅项目 wiki。
• 遇到问题可通过邮件 [email protected] 或在仓库中提交 issue 反馈。

---

本作品整理自 GitHub 开源项目 ViscousPot/GitSync，原作者 @ViscousPot，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。