Grove · 支持

iPhone 与 iPad 上的原生 Git 客户端

快速上手

1. 克隆仓库：在首页点「克隆仓库」，输入仓库地址（支持 SSH），选择本机存放位置后开始克隆。
2. 打开已有仓库：选择设备上已有的 Git 仓库目录（包括 Obsidian 库所在的普通目录），授权后 Grove 原地工作，不复制你的文件。
3. 查看与提交：在「变更」页查看工作区改动，审阅差异后填写提交信息并提交。
4. 分支与合并：在「历史」页查看提交图与分支；合并前 Grove 会给出审阅信息，冲突文件逐条列出。
5. 同步远端：抓取（fetch）只更新远端跟踪信息，不会改动你本地 HEAD；推送结果不确定时 Grove 会明确提示，不会假报成功。

凭据与 SSH

• SSH 密钥与凭据保存在 iOS / iPadOS 系统钥匙串中，仅本机可用。
• 远端主机指纹变化时 Grove 会阻断连接并请你人工确认，这是安全特性，不是故障。

GitHub 登录（下一版计划）

• 以下说明对应正在准备的下一个版本；当前 App Store 在售的 v1.0 尚未包含 GitHub 登录。
• 完全可选：不登录 GitHub 也能使用克隆、提交、合并与 SSH 同步等全部现有功能。
• 如何登录：在本机发起登录后，Grove 显示设备码，你到 github.com 输入并亲自批准；Grove 不索要应用的 Client Secret。
• 授权范围：GitHub 会显示请求的 repo（包括私有仓库的读写权限）与 write:public_key（公钥登记与查看）范围；你批准前可以查看，之后可在 GitHub 网页随时撤销。
• 公钥登记：只有在你明确确认后，Grove 才把本设备 SSH 公钥登记到你的 GitHub 账号；此后仓库的 Git 传输仍经你选择的 SSH 远端进行。
• 令牌位置：GitHub 访问令牌仅保存在本机系统钥匙串（仅本机、解锁后可用），可随时在应用内退出登录清除；开发者没有账号后端，不接收令牌。

常见问题

• 推送后显示「状态未知」？远端没有给出明确结果时 Grove 如实显示未知，请先抓取再核对远端跟踪分支。
• 支持 Obsidian 吗？支持。把 Obsidian 库目录初始化为 Git 仓库（或已是仓库）后，用「打开已有仓库」授权即可。
• 数据会上传吗？开发者没有账号后端，没有第三方分析、广告 SDK 或遥测回传。Git 与可选的 GitHub 请求连接你指定或授权的服务；下一版的购买、恢复与权益检查由 Apple StoreKit 处理。SSH 密钥、凭据与 GitHub 令牌保存在本机系统钥匙串。详见隐私政策。
• Grove Pro 如何恢复？下一版在「设置 → Grove Pro」提供「恢复购买」。请使用购买时的 Apple 账号；GitHub 账号与购买权益相互独立。一次买断多仓库，无订阅；已有仓库始终可用。

问题反馈

在 App 内可生成诊断分享内容（字段白名单 JSON，不含路径、主机、凭据与提交内容），分享前可自行检查。请通过以下方式联系我们：lazywc@gmail.com