# gitflow

**Repository Path**: uking/gitflow

## Basic Information

- **Project Name**: gitflow
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-23
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GitFlow Desktop

一个功能齐全、界面美观的跨平台 Git GUI 客户端，基于 Tauri 2 + React 19 + TypeScript 构建。

## 特性

- **现代化 UI** — 深色/浅色/跟随系统主题
- **仓库管理** — 克隆、打开、初始化、拖放打开、**多仓库标签页**
- **文件状态** — 更改列表、分块/行级部分暂存、冲突解决、**外部 merge tool**
- **提交历史** — 可视化提交图谱、reflog、cherry-pick/revert/compare、**交互式 rebase**
- **分支管理** — 创建、切换（脏工作区 stash 提示）、合并、变基、worktree、**bisect**
- **Stash / 标签 / 子模块 / 稀疏检出**
- **Git LFS** — 跟踪/取消跟踪、已跟踪文件列表
- **远程操作** — fetch、pull、push 预览与进度、凭证状态引导
- **Diff 视图** — 统一/并排模式、语法高亮、大文件虚拟滚动、Blame、搜索
- **GitHub 集成（PAT）** — Pull Request 列表面板
- **命令面板与快捷键**、**i18n 框架**（中文完整 / 英文占位）
- **内置终端面板**

## 快速开始

### 环境要求

- **Node.js** >= 18
- **Rust** >= 1.75
- **pnpm** >= 8
- **Git** >= 2.30

### 安装与运行

```bash
pnpm install
pnpm tauri dev
```

### 构建

```bash
pnpm tauri build
```

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | React 19、TypeScript 7、Tailwind CSS 4、Zustand 5、Vite 8 |
| 桌面 | Tauri 2 |
| 后端 | Rust（Git CLI 包装器） |

## 开发命令

```bash
pnpm dev          # 前端开发服务器
pnpm tauri dev    # Tauri 开发模式
pnpm build        # 构建前端
pnpm lint         # ESLint
pnpm typecheck    # TypeScript 检查
pnpm test         # Vitest 单元测试
pnpm format       # Prettier 格式化
```

## 项目结构

```
src/                 # React 前端
├── components/      # UI、布局、共享组件
├── features/        # 按功能划分的视图模块
├── stores/          # Zustand 状态
├── hooks/           # 自定义 Hooks
├── utils/           # 工具函数
└── types/           # TypeScript 类型

src-tauri/           # Rust 后端
├── src/commands/    # Tauri 命令入口
└── src/git/         # Git 解析与执行逻辑
```

Tauri 命令完整列表见 [`src-tauri/src/lib.rs`](src-tauri/src/lib.rs) 中的 `generate_handler!` 宏。

## 快捷键

| 操作 | Windows/Linux | macOS |
|------|---------------|-------|
| 更改 / 历史 / 分支 / Stash / 标签 / 子模块 / 设置 | `Ctrl+1` – `Ctrl+7` | `Cmd+1` – `Cmd+7` |
| 命令面板 | `Ctrl+K` | `Cmd+K` |
| 快捷键帮助 | `Ctrl+/` | `Cmd+/` |
| 切换终端 | `` Ctrl+` `` | `` Cmd+` `` |
| 刷新状态 | `F5` | `Cmd+R` |
| 拉取 / 推送 | `Ctrl+Alt+L` / `Ctrl+Alt+P` | `Cmd+Alt+L` / `Cmd+Alt+P` |

## 许可证

MIT License