# GitGUI Manager

**Repository Path**: nelson_Q/git-gui-manager

## Basic Information

- **Project Name**: GitGUI Manager
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: 260407-feat-winui3-initial-setup
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GitGUI Manager

一款专为 Windows 11 设计的 Git 仓库管理桌面应用程序，融合 Windows 11 Fluent Design 与复古苹果拟物化设计风格。

## 技术栈

- **UI 框架**: WinUI 3 + WinAppSDK 1.5
- **架构模式**: MVVM
- **MVVM 工具包**: CommunityToolkit.Mvvm
- **Git 操作**: LibGit2Sharp
- **目标平台**: Windows 11 (兼容 Windows 10)

## 功能特性

- 多账户管理 (GitHub / Gitee)
- 仓库列表浏览与搜索
- 创建新仓库
- 文件夹上传到远程仓库
- 从远程仓库下载到本地
- 安全的凭据存储 (Windows Credential Manager)

## 系统要求

- Windows 11 (或 Windows 10 version 1809+)
- .NET 8 Runtime
- Windows App SDK 1.5

## 构建步骤

### 1. 安装依赖

确保已安装以下工具：

- [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)
- [Visual Studio 2022](https://visualstudio.microsoft.com/) (包含 Windows App SDK 开发工具)
- [Windows App SDK 1.5](https://learn.microsoft.com/windows/apps/windows-app-sdk/)

### 2. 克隆项目

```bash
git clone <repository-url>
cd GitGUI-Manager
```

### 3. 还原 NuGet 包

```bash
dotnet restore
```

### 4. 构建项目

```bash
dotnet build
```

### 5. 运行项目

```bash
dotnet run --project src/GitGUIManager/GitGUIManager.csproj
```

## 项目结构

```
GitGUI Manager/
├── GitGUIManager.sln
├── src/
│   └── GitGUIManager/
│       ├── App.xaml              # 应用入口
│       ├── MainWindow.xaml      # 主窗口
│       ├── Views/                # 视图层
│       ├── ViewModels/          # 视图模型层
│       ├── Models/               # 数据模型层
│       ├── Services/             # 服务层
│       ├── Controls/             # 自定义控件
│       ├── Converters/           # 值转换器
│       └── Themes/               # 样式资源
└── docs/
    └── plans/                    # 设计文档
```

## 使用说明

### 添加账户

1. 点击侧边栏「账户」
2. 选择平台 (GitHub 或 Gitee)
3. 输入 Personal Access Token
4. 点击「添加账户」

### 浏览仓库

1. 点击侧边栏「仓库」
2. 等待仓库列表加载
3. 使用搜索框过滤仓库

### 上传文件夹

1. 点击侧边栏「上传」
2. 选择「上传到远程」
3. 选择本地文件夹
4. 选择目标仓库
5. 输入提交信息（可选）
6. 点击「上传」

### 下载仓库

1. 点击侧边栏「下载」
2. 选择「下载到本地」
3. 选择远程仓库
4. 选择本地保存位置
5. 选择分支
6. 点击「下载」

## 获取 Token

### GitHub

1. 访问 https://github.com/settings/tokens
2. 点击 "Generate new token (classic)"
3. 选择需要的权限 (repo, user, etc.)
4. 生成并复制 Token

### Gitee

1. 访问 https://gitee.com/profile/personal_access_tokens
2. 点击 "生成新令牌"
3. 选择需要的权限 (projects, issues, etc.)
4. 生成并复制 Token

## 设计文档

详细的设计规格说明请参考 [docs/plans/2026-04-07-gitgui-manager-design.md](./docs/plans/2026-04-07-gitgui-manager-design.md)

## 许可证

MIT License