Quick MR - GitLab快速合并

一个极简的 VSCode 扩展，帮助您一键配置 GitLab 连接，快速创建 Merge Request 到任意分支，并支持用户分配。

✨ 主要特点

• 🔧 一次配置，全局使用 - 配置一次 GitLab 服务器和 Token，在所有项目中使用
• ⚡ 快速合并 - 使用快捷键 Ctrl+Shift+M 快速创建 MR 到指定分支
• 👥 用户分配功能 - 支持多选用户，自动分配负责人和审核人
• 📋 快速查看配置 - 使用快捷键快速查看和编辑当前配置
• 🎯 智能分支记忆 - 自动记住最近使用的目标分支，提供快速选择
• 🌐 多平台支持 - 支持 GitLab.com、Gitee、GitLab.cn 及自建 GitLab 服务器
• 📊 项目和用户预览 - 配置时可以预览 GitLab 下的所有项目和用户

🚀 快速开始

第一步：配置 GitLab 连接

1. 使用快捷键 Ctrl+Shift+G 或通过命令面板搜索 "配置 GitLab 连接"

2. 填写以下信息：

   • GitLab 服务器地址: 例如 https://gitlab.com
   • Access Token: 从 GitLab 获取的个人访问令牌

3. 点击"测试连接"验证配置

4. 点击"获取项目和用户"预览可用资源

5. 选择用户：在用户列表中多选要分配MR的用户

6. 保存配置

第二步：创建 Merge Request

1. 在任何 Git 项目中，使用快捷键 Ctrl+Shift+M
2. 输入目标分支名称（如 dev, main, develop）
3. 确认创建，插件会自动：
   • 检查 Git 状态
   • 验证分支存在性
   • 创建 MR 并分配给选中的用户
   • 提供MR链接

🔑 获取 GitLab Access Token

1. 登录您的 GitLab 账户
2. 进入 个人设置 > 访问令牌 (/-/profile/personal_access_tokens)
3. 创建新的访问令牌，确保勾选以下权限：
   • api - 访问 API
   • read_user - 读取用户信息
   • read_repository - 读取仓库信息

⌨️ 快捷键

💡 提示: 点击状态栏的 GitLab 图标也可以快速查看配置！

📋 命令列表

👥 用户分配功能

多选用户

• 在配置面板中，点击"获取项目和用户"加载用户列表
• 在用户列表中可以多选需要分配的用户
• 状态栏会显示已选择的用户数量

自动分配规则

• 第一个选中的用户: 自动设为 MR 的负责人 (Assignee)
• 所有选中的用户: 都会设为 MR 的审核人 (Reviewers)
• MR描述: 会自动包含分配的用户信息

示例场景

选中用户: [张三, 李四, 王五]
结果:
- 负责人: 张三
- 审核人: 张三, 李四, 王五 (所有选中的用户)
- 通知: 创建MR时所有用户都会收到通知

🌍 支持的 GitLab 服务

• GitLab.com - 官方公有云服务
• Gitee - 码云平台
• GitLab.cn - GitLab 中国版
• 自建 GitLab - 企业私有部署

💡 使用场景

日常开发工作流

# 1. 在功能分支上完成开发
git add .
git commit -m "feat: 新功能实现"
git push

# 2. 使用 Quick MR 快速创建合并请求
# 按 Ctrl+Shift+M，输入目标分支如 'dev'
# 自动分配给预选的团队成员

团队协作场景

• ✅ 代码审查: 自动分配审核人，确保代码质量
• ✅ 任务分配: 指定负责人，明确责任归属
• ✅ 团队通知: 相关人员自动收到MR通知
• ✅ 一致性: 团队使用统一的用户分配规则

多项目协作

• ✅ 一次配置 GitLab 连接信息和用户选择
• ✅ 在任何 GitLab 项目中直接使用
• ✅ 自动检测项目信息
• ✅ 智能记忆常用分支

⚙️ 配置选项

在 VSCode 设置中可以配置以下选项：

{
  "quick-mr.defaultTargetBranch": "main",
  "quick-mr.autoOpenMr": true,
  "quick-mr.enableSquash": true
}

🔧 故障排除

常见问题

1. 连接测试失败

   • 检查 GitLab 服务器地址是否正确
   • 确认 Access Token 具有足够权限
   • 验证网络连接

2. 找不到项目

   • 确认项目在 GitLab 上存在
   • 检查 Token 是否有项目访问权限
   • 验证项目 remote URL 配置

3. 分支不存在

   • 确认目标分支在远程仓库中存在
   • 检查分支名称拼写

4. 用户分配失败

   • 确认选中的用户在项目中有权限
   • 检查用户是否为项目成员
   • 验证Token是否有分配权限

📈 更新历史

v1.1.0

• ✨ 新增用户多选功能
• ✨ 新增快速查看配置命令
• 👥 支持MR自动分配负责人和审核人
• 📋 状态栏显示选中用户数量
• 🎯 优化用户体验和界面设计

v1.0.9

• 🔄 重构为统一 GitLab 配置模式
• ✨ 新增项目和用户预览功能
• 🎯 优化分支选择体验
• 📱 简化用户界面

v1.0.8

• 🐛 修复多仓库配置问题
• ⚡ 提升性能和稳定性

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

Quick MR - 让 GitLab 合并更简单，让团队协作更高效！ 🚀