Skip to content

FruitsAI/Grape

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Grape

macOS 原生 Git 日常驾驶舱

Grape: Git, Simply Picked.

Grape 是一款给个人开发者使用的 macOS 原生 Git 客户端。

它不想变成一个功能越来越重的“万能面板”,而是想把每天最常做的几件事做顺:看改动、挑选要提交的内容、写提交、切换分支、拉取推送、查看最近历史。

如果现有工具让你觉得太重、太吵、太像“得先懂很多 Git 才能放心用”,那 Grape 想提供另一种感觉:像 macOS 自带工具一样清爽、稳定、直觉。

Grape 是什么

  • 它是什么: 一个 macOS 原生 Git 客户端,专注日常高频操作。
  • 它给谁用: 主要给每天都在写代码、维护自己项目或少量仓库的个人开发者。
  • 它先解决什么: 让本地改动、提交、分支和同步远端这些动作更顺、更安心。
  • 它为什么值得做: 现在的 Git 图形工具,要么偏重,要么偏密,要么偏入门包装,Grape 想做的是一个真正适合每天常开的 Mac 工具。

第一版要做什么

第一阶段目标不是公开发布,而是做出一个真的能自己每天用起来的内部版。

第一版聚焦这些能力:

  • 打开本地仓库
  • 克隆远端仓库
  • 最近仓库入口
  • 查看当前改动
  • 按文件选择提交内容
  • 按代码块选择提交内容
  • 暂存区视图
  • 编写提交说明
  • 创建和切换分支
  • 重命名、删除和整理分支
  • 拉取和推送
  • 查看最近历史
  • 提交关系图
  • 预览差异内容
  • 丢弃与恢复改动
  • 在发生冲突时提供完整处理界面

第一版的用户主路径应该很明确:

打开仓库 -> 看改动 -> 选择要提交的内容 -> 提交 -> 切换或新建分支 -> 拉取/推送 -> 查看最近历史

第一版不做什么

为了把体验做得足够清楚,第一版明确不做这些内容:

  • GitHub、Pull Request、Issue
  • 多人协作面板
  • 多仓库总览工作台
  • 面向少数人的高级低频功能堆叠

Grape 第一版默认一次专注一个仓库,不做多仓库总控台。

产品结构

Grape 的主界面采用“顶栏 + 常驻三栏”。

默认情况下,应用启动后会直接回到上次打开的仓库。只有在首次启动、没有最近仓库,或者仓库路径失效时,才进入仓库入口页。

1. 顶栏

顶栏负责轻量状态和高频动作:

  • 当前仓库名
  • 当前分支
  • 同步状态
  • 打开仓库
  • 拉取
  • 推送
  • 新建分支
  • 提交

2. 左侧栏

  • 仓库与分支上下文: 当前仓库、当前分支、同步状态摘要、未提交改动数量
  • 分支管理入口: 新建、切换、重命名、删除、追踪远端、整理分支

3. 中间主区

  • 当前改动: 文件列表、代码块选择、暂存区视图、丢弃与恢复改动
  • 提交区域: 提交说明输入和提交动作

4. 右侧栏

  • 提交关系图与最近历史: 帮用户看懂最近发生了什么
  • 差异预览: 让用户随时回看当前改动或已选提交内容

产品体验原则

Grape 的产品判断先围绕这几条来做:

  • 原生、安静、顺手: 像真正的 Mac 应用,不吵、不乱、不压人
  • 少而准: 只把高频动作放到最前面,不为了“看起来完整”而堆功能
  • 有保护感: 危险动作要有明确提醒,不能让用户莫名其妙丢改动
  • 说人话: 出错时直接告诉用户发生了什么、下一步该怎么办
  • 单仓库深做: 先把一个仓库内的体验做到扎实,再考虑更大的管理视角

视觉与品牌方向

“Grape” 这个名字会保留,因为它有记忆点,也能自然连接 Git 的提交和分支关系。

但品牌表达不会走夸张路线。Grape 的视觉应该更接近:

  • 清爽
  • 通透
  • 像系统自带工具

葡萄的意象可以存在,但应该是点到为止,而不是把整个产品做成一场隐喻表演。

建议的视觉方向:

  • 以 macOS 原生界面气质为基础
  • 适度使用通透材质和留白
  • 用深紫或通透紫作为强调色,而不是大面积铺满
  • 图标和界面都以“清晰、克制、好用”优先

Grape 的位置

Grape 不想和现有工具走同一条路。

  • 它不追求做成一个“大而全”的效率中心
  • 它不追求把界面做成只有熟练用户才会喜欢的密集工具箱
  • 它也不只是把 Git 包装得更入门一点

Grape 更想成为一款你愿意每天开着的 Mac 原生 Git 工具。

当前实现方向

当前默认方向是:

  • 只做 macOS
  • 先把原生桌面体验做好
  • 优先复用系统已有 Git 能力
  • 先完成可用的内部版,再考虑更大范围的发布

近期里程碑

Milestone 1

完成一个可用的内部版,让用户可以在不打开终端的情况下,走通一次完整的日常 Git 流程。

Milestone 2

把提交、切换分支、同步远端这三条高频路径打磨到足够顺手,减少来回跳出和误操作。

Milestone 3

继续完善历史查看、冲突提示和失败反馈,让 Grape 从“能用”变成“愿意常用”。

一句话总结

Grape 想做的,不是另一个什么都有的 Git 客户端。

它想做的是一个给个人开发者的、macOS 原生的、安静又顺手的 Git 日常工具。

About

MacOS 原生 git 客户端

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors