# GitLab MR 管理插件

🚀 一个专为开发者设计的 uTools 插件，让您能够快速高效地管理 GitLab Merge Request。

## ✨ 功能特性

### 📋 MR 管理
- **查看 MR 列表** - 支持筛选、搜索、分页浏览
- **快速创建 MR** - 智能项目匹配，自动选择分支
- **一键操作** - 合并、关闭、复制链接、查看详情
- **实时状态** - 显示 MR 状态、作者、时间等信息

### 🔍 智能搜索
- **关键词搜索** - 按标题、描述搜索 MR
- **状态筛选** - 打开、关闭、已合并状态
- **范围筛选** - 我创建的、指派给我的
- **项目筛选** - 按特定项目筛选

### ⚡ 快速创建
- **智能匹配** - 输入项目名称自动匹配项目
- **分支选择** - 智能推荐源分支和目标分支
- **自动填充** - 自动读取最近提交信息作为标题

## 🏁 快速开始

### 1. 安装插件
在 uTools 中搜索"GitLab MR"并安装

### 2. 账号配置
首次使用需要绑定 GitLab 账号：

1. **获取 Private Token**：
- 登录您的 GitLab
- 进入 `Settings` → `Access Tokens`
- 创建新的 Personal Access Token
- 勾选 `api` 权限

2. **填写配置信息**：
- GitLab 地址：如 `https://gitlab.com` 或您的私有 GitLab 地址
- Private Token：上一步获取的 Token

3. **保存配置**：
- 插件会自动验证 Token 有效性
- 验证成功后即可使用

## 🎯 使用方法

### 方式一：关键词唤起
在 uTools 中输入以下关键词：
- `GitLab MR` / `MR` - 打开 MR 列表
- `创建MR` / `新建MR` - 快速创建新的 MR

### 方式二：快速创建（推荐）
在 uTools 中直接输入任意文本，如果匹配到项目名称，会显示"创建MR"选项

**示例**：
- 输入 `my-project` → 选择"创建MR" → 自动匹配项目并打开创建对话框
- 输入 `frontend` → 选择"创建MR" → 匹配包含"frontend"的项目

## 📖 详细功能

### MR 列表管理
- **查看列表** - 显示所有相关的 Merge Request
- **状态标识** - 清晰的状态标签（打开/关闭/已合并）
- **快速操作** -
- 🔗 复制链接
- ✅ 合并 MR
- ❌ 关闭 MR
- 👁️ 查看详情

### 高级筛选
- **关键词搜索** - 支持标题、描述搜索
- **状态筛选** - 快速筛选不同状态的 MR
- **作用域** - 查看我创建的或指派给我的 MR
- **项目筛选** - 按特定项目查看 MR

### 智能创建
- **项目匹配** - 输入项目名称，自动匹配最相关的项目
- **分支推荐** - 智能推荐合适的源分支和目标分支
- **自动填充** - 自动获取最近提交信息作为 MR 标题
- **状态提示** - 实时显示匹配结果和操作状态

## 🔒 数据安全

- **本地存储** - 您的 GitLab Token 和配置信息仅存储在本地
- **不上传云端** - 所有敏感数据不会同步到 uTools 服务器
- **权限最小化** - 只请求必要的 API 权限

## 🛠️ 常见问题

### Q: Token 验证失败怎么办？
A: 请检查：
1. GitLab 地址是否正确（需要包含 http:// 或 https://）
2. Token 是否有效且包含 `api` 权限
3. 网络连接是否正常

### Q: 无法看到某些项目的 MR？
A: 请确认：
1. 您对该项目有访问权限
2. Token 具有足够的权限
3. 项目设置允许查看 MR

### Q: 创建 MR 失败？
A: 请检查：
1. 源分支和目标分支是否存在
2. 是否有推送代码到源分支
3. 是否有创建 MR 的权限

## 📄 开源协议

本插件基于 MIT 协议开源，欢迎贡献代码和反馈问题。

## 🤝 支持与反馈

如果您在使用过程中遇到问题或有建议，欢迎：
- 提交 Issue 反馈问题
- 提供功能建议
- 参与代码贡献

---

**让 GitLab MR 管理变得更加高效！** 🎉