为 Vue CLI 前端项目生成含 build、test、deploy 三阶段的 .gitlab-ci.yml：build 缓存 node_modules 并执行 npm install 和 build；test 运行 npm test；deploy 用 rsync 推送 dist 至指定服务器路径。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在 VS Code 中用 CodeGeeX 插件快速生成一个可直接提交到 GitLab 仓库的 .gitlab-ci.yml 文件，但手动写 YAML 容易漏掉 stages、cache 或 artifacts 等关键结构，且不同语言项目（如 Node.js/Python/Java）的 job 配置差异大，靠记忆容易出错。
确认插件状态与项目上下文
打开 VS Code，确保左侧活动栏有蓝色机器人图标；若无，需先安装 CodeGeeX 官方插件并登录账号。
在项目根目录下新建空白文件，命名为 .gitlab-ci.yml —— 【必须命名为此名且位于根目录，否则 GitLab 无法自动识别】。
在文件第一行输入提示语：“为一个使用 Vue CLI 构建的前端项目生成 GitLab CI/CD 脚本，包含 build、test、deploy 三个阶段；build 阶段需缓存 node_modules 并执行 npm install 和 npm run build；test 阶段运行 npm test；deploy 阶段将 dist 目录内容同步至 /var/www/myapp。”
触发生成并验证基础结构
选中整段提示文字 → 右键 → “CodeGeeX → Generate Code”。
等待几秒后，生成内容会插入光标位置。检查是否包含 stages: 顶层定义，且三个 stage 名称与提示中完全一致（大小写、连字符均不可错）。
重点核对 build_job: 下是否有 cache: 区块，且 paths: 值为 - node_modules/ —— 若缺失，后续构建会重复下载依赖，拖慢流水线。
适配实际环境参数
方法一：直接修改生成脚本中的镜像与路径
将 image: node:18 改为 image: node:20.15.0 —— 这是当前 GitLab 共享 runner 最稳定的 LTS 版本，用高版本可能导致 npm ci 失败。
部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……
把 cp -r dist/* /var/www/myapp 替换为 rsync -av --delete dist/ user@server:/var/www/myapp/，并确保该行上方已添加 before_script: 区块用于 SSH 密钥注入。
方法二：用二次提示精准修正
在刚生成的 YAML 文件末尾新起一行，输入：“把 deploy 阶段改为通过 rsync 推送至 192.168.10.5 的 /var/www/app 目录，使用 deploy_user 用户和 ~/.ssh/id_rsa_deploy 私钥，跳过 host key 检查。”
选中这行新提示 → Ctrl+Enter 触发补全，CodeGeeX 会自动在 deploy job 中插入 before_script 和 script 块，无需手动拼接 SSH 参数。
本地语法校验与提交前检查
第一步：安装 GitLab CI Linter 扩展（如 “GitLab CI Linter”），启用后右下角会出现 “CI Lint” 按钮。
第二步：点击该按钮 → 粘贴当前 .gitlab-ci.yml 内容 → 点击 “Validate”。
若返回 “Valid configuration”，说明语法无硬错误；但注意：它不校验镜像是否存在或路径权限，【必须人工确认 deploy_user 对目标目录有写入权限，否则 job 会卡在 rsync 步骤】。
第三步：保存文件 → 在终端执行 git add .gitlab-ci.yml && git commit -m "ci: add GitLab pipeline" → 推送到远程仓库主分支。
