PuppyGit：Android Git 客户端

项目简介

PuppyGit 是一款运行在 Android 上的 Git 客户端，开源、免费、无广告。除了管理代码仓库，它还被用来同步笔记：可以把 Obsidian、Markor 等笔记应用创建的仓库当作 Git 仓库，在进出指定应用时自动 pull/push，实现 Android 上的笔记同步。

主要功能

• 仓库操作：fetch、merge、pull、push、rebase、cherry-pick、reset、squash commits、解决冲突
• 浏览与查看：文件浏览器、提交历史（git log）、reflog、tags、stashes、remotes、branches、submodules
• 克隆与补丁：支持 shallow clone（带 depth 的 git clone）、patch
• 内置简易文件编辑器（仅支持 UTF-8）与 Markdown 预览
• 自动同步：进入/退出指定应用时自动 pull/push，适合 Obsidian、Markor 等笔记应用
• 可被 Tasker 或其他自动化工具通过 HTTP 服务调用 pull/push/sync

内置编辑器功能比较基础，作者推荐配合 Squircle CE（代码编辑器，https://github.com/massivemadness/Squircle-CE ）或 Markor（Markdown 编辑器，https://github.com/gsantner/markor ）使用，安装后可通过 PuppyGit 的「Open As」功能直接调用。

安装与使用

可从两个渠道下载安装：

• GitHub Releases：https://github.com/catpuppyapp/PuppyGit/releases
• IzzyOnDroid：https://apt.izzysoft.de/fdroid/index/apk/com.catpuppyapp.puppygit.play.pro

从源码构建：把项目导入 Android Studio 后直接构建即可（需要 Android NDK）。

账号与认证

• 如果 GitHub / GitLab 等平台账号开启了两步验证（2FA），需要用 personal access token 代替密码登录。
  • GitHub 创建 token：https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token
  • GitLab 创建 token：https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token

SSH

首次连接未知主机时，PuppyGit 默认会询问允许或拒绝；也可以在设置页选择默认允许未知主机。通过 SSH 连接远程仓库只需要私钥和 passphrase，应用本身不支持生成 SSH 密钥，如需在 Android 上生成密钥，可使用作者的另一款应用 Ssh Key Man：https://github.com/catpuppyapp/PuppySshKeyMan/releases

注意事项

• 建议在设置页设置 master password，用于加密凭据中的密码 / passphrase。若不设置，会使用公开的默认密码加密，安全性不足。
• 旧版本中曾出现过的「PuppyGit Pro」只是改名，与现在的 PuppyGit 没有功能差异。
• 项目采用 GPL-3.0 许可证。

---

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