GitLab Auto MR (VS Code 扩展)

在 VS Code 中进行分支合并时，根据当前源分支与目标分支自动生成规范的 Merge Request Title、Description，并自动指定 Reviewer。

完整操作步骤与常见问题见 使用说明。

产品范围、业务规则与验收标准见 产品需求文档（PRD）。

✨ 核心特性

1. 自动提取分支与项目信息：自动解析当前 Git 仓库的远程分支、GitLab 实例地址以及项目路径。
2. 规则化 Title 自动生成：基于自定义模板及分支语义占位符（如源分支、目标分支、分支类型、Jira/Issue 单号、最近 Commit 标题等）自动组装规范标题。
3. Commit 聚合 Description：自动统计两分支间的 Commits 提交历史、变动文件清单以及内嵌自测清单。
4. 自动指定 Reviewer：支持配置默认 Reviewer 用户名，自动调用 GitLab API 匹配对应的用户 ID 并指派。
5. 私有部署支持：完美支持企业私有部署的 GitLab (Self-hosted) 与自签名证书内网环境。
6. 安全存储 Token：支持通过 VS Code 原生 SecretStorage 加密安全保存 GitLab Access Token。
7. 上线版本检查：加载 GitLab 上的全部远程分支，默认过滤显示常用分支，按 / 逐层展开；选择 release/ 分支后，核对同版本 feature/ 分支的 MR 状态，并可直接为待处理分支创建 MR。

🛠 配置说明

在 VS Code 的 Settings（Ctrl + ,）中搜索 GitLab MR，可进行如下配置：

📋 内置 Merge Request 标题填写规范映射表

插件完全按照以下企业分支合并规范自动生成 Title，并智能从分支名或提交中提取 <Jira号>、<CRQ> 与 <摘要>：

注：若分支中未包含单号，插件会自动填入 <Jira号> 或 <CRQ> 占位符并在弹窗中高亮引导输入；如未命中上述特殊规范，则自动降级按 gitlabMr.titleTemplate 模板生成。

🚀 使用方法

1. 设置 GitLab Access Token

1. 按 Ctrl + Shift + P 打开命令面板；
2. 输入并执行：GitLab: Set Access Token；
3. 输入具有 api 读写权限的 GitLab Personal Access Token，回车保存。

2. 一键创建 Merge Request

1. 在 VS Code 左下角状态栏点击 $(git-pull-request) GitLab MR 按钮，或者按 Ctrl + Shift + P 运行 GitLab: Create Merge Request；
2. 插件会列出本地及已获取的远程分支，先选择 源分支（默认聚焦当前分支），再选择 目标分支；
   • 目标列表按内置合并规则将推荐分支置顶，并显示推荐原因；其他分支仍在后面，可自由选择。
   • feature / bugfix 优先推荐 release，其中路径第二段相同的 release 排在最前；release / hotfix 推荐测试环境和 main/master；conflict 推荐测试环境和 release；revert 推荐测试环境、release 和 main/master；main/master 基线回流推荐测试环境和 release。
   • 同等推荐级别内，配置的默认目标优先，其余保持原有顺序；未知源分支类型保持默认目标在前。不自动创建或合并 MR，仍需手动确认目标。
3. 插件根据配置规则生成 Title，并在输入框中展示供预览（直接回车即可使用自动生成的标题，亦可临时微调）；
4. 插件在后台自动聚合提交日志、变动文件生成 Description，并指派 Reviewer，调用 GitLab API 创建 MR；
5. 创建完成后右下角弹窗通知，并可直接一键打开或复制链接。

3. 检查上线版本

1. 点击活动栏的 上线检查 图标。已配置 GitLab Token 时，第一层自动加载完整远程分支列表（不是本地分支列表），无需先选择 release，也不需要点击加载更多。默认仅展示常用分支；多层分支名按 / 分层，目录默认折叠，可逐层展开。

2. 每个远程分支行内及右键菜单提供 检查上线分支合并状态 按钮，点击即可检查该分支；也可点击分支名称，或使用标题栏的检查图标及 GitLab MR: Check Release Readiness 命令搜索选择。首次使用请通过标题栏入口配置 Token 并加载分支。

3. 检查只同步所选分支与远程 main，不扫描其他分支。结果直接展示在所选分支的下一级，并自动展开定位：普通分支显示是否已全部合入 main；release 额外分别加载同版本 feature 和以自身为目标的 MR 的第一页（各最多 100 条），不受当前分支搜索范围影响。结果下的 加载更多 追加下一页；已经加载完的数据源不会重复请求，也不会重复检查 main。版本号取路径第二段。

4. 只有分支下的第二层检查结果按需分页。分页未完成时显示 结果尚未完整；MR 尚未加载完时，feature 显示 MR 状态待确认，不提供补建 release MR 操作，防止把后续页面上的 MR 误判为未创建。所有相关 MR 加载完成后才确认已加载 feature 的最终状态；同版本 feature 分页也完成后，才可视为完整版本结果。失败时显示重试入口、保留已加载页面，点击后重试失败页。刷新和更换搜索词会清空旧数据与检查结果，重新加载完整第一层列表。

5. 除 main 自身外，分支最新代码已全部进入远程 main 时显示绿色通过图标及 代码已合入 main 标记。判断基于模拟合并后的代码树，而不是历史 MR 状态或提交 SHA，因此支持 squash/rebase，也允许 main 包含其他分支的改动。存在待合入改动或合并冲突时不标绿；目录不标记，release 的 MR 状态仍独立保留。

6. 点击标题栏的 漏斗图标，或运行 GitLab MR: Filter Branches (过滤常用分支)，可多选分支过滤条件。默认勾选 feature/、release/、dev、uat、main、bugfix/、hotfix/、tst、pre；以 / 结尾的条件匹配该目录下所有层级，其他条件精确匹配分支名（例如 dev 不匹配 develop 或 dev/test）。取消全部勾选并确认即可显示全部，按 Esc 取消则保持原条件。选择会保存在当前工作区，刷新和重启后保留；无匹配时可点击提示重新调整。

7. 未标记为已合入 main 的远程分支及上线检查中的功能分支，行内和右键菜单提供 创建 MR（按合并规则推荐目标分支）。点击后重新同步检查该分支，仍有待合入代码时，以所点分支为源分支，展示按现有合并规则排序的目标分支列表：feature/bugfix 优先推荐同版本 release，release/hotfix 推荐测试环境和 main/master，其余规则与一键创建 MR 相同，也可选择非推荐目标。选择目标后确认标题，沿用现有标题、描述、Reviewer 及 MR 选项配置。main 无须出现在当前分页中；若远程实际不存在 main，检查会报错并阻止此入口继续，通用创建入口仍可使用。

8. 点击内容区域第一行的 搜索分支，输入关键词，使用 GitLab 远程分支搜索并自动加载全部匹配结果，匹配语义以 GitLab 的 search 参数为准（可使用 ^、$ 约束开头、结尾）。返回结果继续应用常用分支过滤并保留目录层级。清空并确认重新加载完整远程列表，按 Esc 保持原搜索。空结果仍保留搜索入口。关键词仅保存在本次会话，刷新及调整常用分支过滤时保留，重启清空。

常用分支过滤仅处理已加载的远程结果，不额外请求 GitLab，也不删除已有结果。关键词搜索会重新请求远程并重置数据。顶部选择入口列出当前搜索返回的全部分支；未找到时请调整或清空搜索。第一层加载失败时保留已返回数据并提供“重试加载分支”，重试后自动读取剩余数据，不显示“加载更多”。标题保持 上线检查，不显示顶部过滤条件提示。

main 标记需要 Git 2.38+ 和可用的 origin 拉取权限。首次加载、刷新及远程搜索返回完整第一层列表后，自动检查该列表内的分支并恢复“代码已合入 main”的绿色标记；main 不必包含在搜索结果中。日常单分支检查只更新当前分支，第二层加载更多不会重复扫描或清除其他分支标记。自动检查失败时提示、保留分支列表，不显示失效的绿色标记。均不切换分支、不修改工作区或暂存区。第二层返回满 100 条时保留加载更多，最后一页恰好 100 条可能需要再点击一次确认没有后续数据。

💻 本地调试与安装

1. 本地调试运行： 在 VS Code 中打开本项目，按 F5 键即可启动扩展开发宿主窗口进行实时调试。

2. 打包为 VSIX 离线安装包：

   npx @vscode/vsce package
   

   生成 .vsix 文件后，在 VS Code 扩展面板中点击右上角 ... -> 从 VSIX 安装... 即可完成本地安装。 #� �g�i�t�l�a�b�-�m�e�r�g�e�-�r�e�q�u�s�t�-�v�s�c�o�d�e�-�e�x�t�e�n�s�i�o�n� � �