Jenkins Pipeline Batch Trigger

VSCode 扩展：批量触发 Jenkins Pipeline，实时监控构建状态，支持 Pre/Post Action 自动化引擎。

功能概览

功能	说明
批量触发	勾选多个 Pipeline，一键触发，支持全局参数 + 每 job 独立参数
实时状态	Running / Success / Failed / Unstable / Aborted 状态徽标，自动刷新默认开启（间隔 1 分钟，可调）
批量中止	一键中止所有运行中的构建
侧边栏树	自定义文件夹/Job 树结构，复选框批量选择，状态感知图标
Pre/Post Actions	触发前注入参数、完成后提取日志写回状态，实现跨运行闭环
构建轮询	单定时器 + 指数退避，自动检测构建完成并执行 Post-Actions
参数模板	保存/复用参数组合，支持分类管理与拖拽归类，快速切换不同环境配置
日志内容提取	按自定义正则/JS 脚本规则从选中 Pipeline 的构建日志批量提取内容，结果可复制/导出，可选回写参数
状态栏	底部显示运行/队列/失败计数，点击打开 Output Channel

安装

从 VSIX 安装

# VSIX 文件名格式：jenkins-batch-trigger-v<版本号>.vsix（如 v1.0.8）
# 每次 push 到 main/master 会自动构建并发布到 GitHub Releases，直接下载最新版即可
code --install-extension jenkins-batch-trigger-v1.0.8.vsix

从源码构建

git clone https://github.com/Amos666/jenkins-batch-trigger.git
cd jenkins-batch-trigger
npm install
npm run compile
# F5 启动扩展开发宿主，或：
npx @vscode/vsce package --no-dependencies

快速开始

第一步：配置 Jenkins 连接

点击侧边栏 Jenkins Batch 图标打开扩展
点击树视图标题栏的 齿轮图标（Configure Jenkins Connection）
按提示输入：
- Jenkins URL：https://jenkins.example.com（不带末尾斜杠）
- 用户名：你的 Jenkins 登录名
- API Token：在 Jenkins → 用户设置 → API Token 中生成
- 信任自签名证书：内网 Jenkins 通常选「是」

配置保存在 VSCode 全局设置中，API Token 安全存储在 SecretStorage。

第二步：组织 Pipeline 树

点击树视图标题栏的 新建文件夹 图标，创建分组（如「支付线」「每日发版」）
右键文件夹 → Add Job Nodes，弹出 Job 选择面板
在面板中搜索、勾选需要管理的 Pipeline，确认添加
树结构保存在 globalState，跨 workspace 共享

第三步：批量触发

在侧边栏树中勾选要触发的 Job（支持文件夹级联选择）
中央面板自动显示已选 Job 列表（名称默认显示为 上级目录/job名，双击表头可切换层级）
点击参数按钮设置触发参数（JSON 编辑器 + KV 快捷编辑）
点击 触发选中，确认预览后批量触发
状态列实时更新（自动刷新默认开启，间隔 1 分钟），构建链接可直接跳转 Jenkins 页面

使用详解

侧边栏树操作

操作	方式
新建文件夹	标题栏 📁 图标 / 右键文件夹 → New Subfolder
添加 Job	标题栏 + 图标 / 右键文件夹 → Add Job Nodes
重命名	右键节点 → Rename
删除	右键节点 → Delete（支持多选批量删除）
刷新状态	右键文件夹 → Refresh Status
切换显示名	双击 Job 节点循环：`名称` → `父目录/名称` → `祖父/父/名称`
过滤	标题栏漏斗图标，按名称/路径过滤
启用 Actions	右键 Job → Toggle Pre/Post Actions（出现 ⚡ 标记）
配置 Actions	右键已启用的 Job → Configure Actions

中央面板操作技巧

功能	说明
Pipeline 名称显示	默认显示 `上级目录/job名`；双击「流水线」表头循环切换：`仅 job 名` → `上级目录/job` → `上上级/上级/job`
列宽调整	拖动表头右边缘调整列宽（拖动后不再自动适配宽度）
自动刷新	默认开启、间隔 1 分钟，可勾选开关或从下拉框调整（5s / 10s / 30s / 1m / 3m / 5m）；只轮询非终态的 job，减少请求
活动日志	拖拽分隔条调整高度，点标题折叠/展开，支持导出到编辑器与清除
超时看守	工具栏 ⏱ 设置分钟数，超时自动中止对应 pipeline

参数系统

全局批量参数：点击工具栏「参数」按钮，支持两种编辑模式：

JSON 编辑器：直接编辑 { "BRANCH": "main", "ENV": "prod" }
KV 快捷编辑：逐行添加键值对

每 Job 独立参数：点击表格行的「✎ 参数」链接，为该 Job 设置专属参数（优先于全局参数）。

参数模板：配置好参数后点「＋存为模板」，下次点击模板芯片一键套用；「↻ 更新当前模板」把当前参数写回所选模板。

模板分类：

在「参数」弹框点「＋新建分类」创建分类（如「生产环境」「测试环境」）
把模板芯片拖到目标分类块内（或拖到该分类下的其他模板上）即完成归类
拖回「未分类」块可取消归类；分类之间可任意拖拽调整
点分类头部的 ✕ 删除分类，其中模板自动移回「未分类」
按住分类头部（名称栏）上下拖动，可调整分类之间的显示顺序
未创建分类时模板平铺显示，原有拖拽排序、套用、删除行为完全不变

模板分类小案例：参数模板越来越多，想按环境分组——「参数」弹框 →「＋新建分类」创建「生产环境」「测试环境」；把 prod-full、prod-hotfix 拖进「生产环境」，test-smoke 拖进「测试环境」；按住「测试环境」分类头部往上拖可让它排在前面。以后发版先展开对应分类，点一下模板芯片即可套用；误删分类也不怕，模板会自动回到「未分类」。

Pipeline 显示层级小案例：同时管理 pay/order 和 trade/order 两个同名 job 时，列表默认显示 上级目录/job名（pay/order、trade/order）可避免混淆；双击「流水线」表头还能切到三层显示 上上级/上级/job。

触发预览

点击「触发选中」后会弹出确认面板，显示每个 Job 实际使用的参数（全局 or 独立），确认后才真正触发。

日志内容提取

从当前选中 Pipeline 的构建日志（full log）中按自定义规则批量提取内容，适用于收集构建产物 ID、部署版本号、扫描报告链接等场景。

入口：工具栏「🔍 日志提取」按钮（需先在列表中选中至少一个 Pipeline）。

提取规则：

点「＋新建规则」创建规则，支持两种类型：
- 正则表达式：正则 + 取值策略（首个匹配 / 最后匹配（默认）/ 全部匹配）。含捕获组时取第 1 个分组的值，否则取整条匹配；按行匹配
- JS 脚本（规则芯片上带 ƒ 标记）：沙箱执行（5 秒超时），可用变量 log（完整日志文本）和 lines（按行数组）。提取结果为赋给 result 的值，未赋值时取最后一个表达式的值；可返回字符串或字符串数组，返回空/undefined 视为未匹配
两种类型都可填可选的回写参数名
规则以芯片形式展示，点击选中/取消，✎ 编辑（名称不可改）、✕ 删除；规则全局保存复用

JS 脚本示例：

// 提取最后一个 CHANGE_ID
const ms = [...log.matchAll(/CHANGE_ID=(\w+)/g)];
result = ms.length ? ms[ms.length - 1][1] : '';

// 统计 ERROR 行并拼接前 3 条
const errs = lines.filter(l => l.includes('ERROR'));
errs.length ? errs.slice(0, 3) : null;

使用流程：

目标无需再次选择——与批量触发一致，只提取表格中已勾选的 Pipeline（弹框内只读展示，无构建记录的自动跳过，构建中的会提示日志可能不完整），只需勾选要提取的规则（可多选）
点「开始提取」，逐个拉取日志并应用所有选中规则，结果表格实时刷新，可随时「取消」
完成后显示成功/未匹配/失败统计；「复制」得到 TSV 文本，「导出」写入新编辑器（默认 TSV 表格），「导出 JSON」得到结构化结果便于程序解析（含生成时间、规则列表、每个 pipeline 按规则名索引的取值）
默认只查看和导出。如需回写参数：勾选「回写到参数」，预览每个 job×规则的键值后选择模式。回写是合并而非覆盖——新键添加、同名键覆盖、其他原有参数保留：
- 每 job 专属参数：结果与该 Pipeline 当前生效参数（已有专属参数则用它，否则用全局参数）合并后写入专属参数（多 Pipeline 值不同时推荐）
- 全局批量参数：结果合并进全局参数（同名键冲突时该模式自动禁用）
点「回写到参数」二次确认后生效，下次触发即携带提取值

完整案例：发版后收集部署版本与失败摘要

场景：3 个服务（pay/order、pay/user、pay/gateway）刚完成一轮构建，你需要收集每个服务部署的镜像 tag、变更 ID，并统计 ERROR 行数，为下一轮灰度触发做准备。

第 1 步：假设某个服务的构建日志（Console Output）包含：

[Pipeline] Start of Pipeline
Building image registry.example.com/pay/order:v2.3.1
CHANGE_ID=chg-1001
Deploying to staging ...
ERROR: slow response from db (retry 1)
Deploy done, image=registry.example.com/pay/order:v2.3.1
[Pipeline] End of Pipeline

第 2 步：打开「🔍 日志提取」→「＋新建规则」，创建 3 条规则：

规则名	类型	配置	回写参数名
镜像Tag	正则	`image=[^:]*:(v[\d.]+)`，策略：最后匹配	`IMAGE_TAG`
变更ID	正则	`CHANGE_ID=(\w[\w-]*)`，策略：最后匹配	`CHANGE_ID`
错误统计	JS 脚本	见下方，无 result 赋值取末表达式	留空（仅查看）

错误统计脚本：

const errs = lines.filter(l => l.includes('ERROR'));
errs.length ? errs.length + ' 条' : '';

第 3 步：勾选 3 条规则，点「开始提取」（目标即列表中已勾选的 3 个 Pipeline，无需再选）。结果表格：

Pipeline	#	镜像Tag	变更ID	错误统计
pay/order	#58	v2.3.1	chg-1001	1 条
pay/user	#61	v2.3.1	chg-1002	未匹配
pay/gateway	#33	v2.2.9	chg-0988	2 条

第 4 步：点「导出」把表格存到编辑器留档（点「导出 JSON」则得到如下结构化数据，方便脚本解析）：

{
  "generated_at": "2026-08-22T09:30:00.000Z",
  "rules": [
    { "name": "镜像Tag", "kind": "regex", "strategy": "last", "targetKey": "IMAGE_TAG" },
    { "name": "错误统计", "kind": "script", "strategy": "last", "targetKey": "" }
  ],
  "pipelines": [
    { "pipeline": "pay/order", "jobPath": "pay/order", "buildNumber": 58,
      "values": { "镜像Tag": ["v2.3.1"], "变更ID": ["chg-1001"], "错误统计": ["1 条"] } }
  ]
}

如需把版本信息带给下一轮触发，勾选「回写到参数」：

各服务 tag 不同 → 选「每 job 专属参数」，预览确认后回写
假设当前全局参数为 { "ENV": "staging" }，回写后 pay/order 的专属参数变为 { "ENV": "staging", "IMAGE_TAG": "v2.3.1", "CHANGE_ID": "chg-1001" }（原有参数保留，提取键合并），下次触发自动携带

小技巧：

正则拿不准时先在「JS 脚本」类型里用 log.match(...) 试错，稳定后再改回正则规则
脚本返回数组时单元格用逗号连接显示，完整内容悬停可见
脚本里 console.log 无效（无控制台输出），调试靠 result 返回值
规则是全局保存的，团队内常用规则建一次即可长期复用

扩展间调用：batchTrigger 命令

「批量触发」能力已注册为 VSCode 命令 jenkins-batch-trigger.batchTrigger，其他插件可在自己的流程中调用（如发版流水线、自动化任务链）。不传参数时行为与点击页面「批量触发」按钮完全一致：使用页面参数编辑器的当前参数（携带参数时走 buildWithParameters），只触发表格中勾选的行，并应用每 Job 专属参数；启用 Pre/Post Actions 的 job 执行完整 Action 链路。页面的参数、勾选状态和每 Job 参数会实时同步持久化，即使 webview 面板已关闭，命令仍使用最后一次页面状态。

命令签名

vscode.commands.executeCommand(
  "jenkins-batch-trigger.batchTrigger",
  tplName?: string,             // 可选①：参数模板名称；不传则使用页面参数编辑器的当前参数（与按钮一致）
  jobPaths?: BatchTriggerJobSpec[] // 可选②：目标 job 列表，元素可为纯路径字符串或 { path, params } 对象；
                                   //   不传则触发页面表格中勾选的行（与按钮一致）
): Promise<BatchTriggerResult>

jobPaths 数组元素支持两种形态（可混用），对象形态与 webview「每 Job 专属参数」功能完全一致：

type BatchTriggerJobSpec =
  | string  // 形态1：纯 job 路径 —— 只用基础参数（模板 / 页面参数）
  | {
      path: string;                    // 形态2：job 完整路径（Jenkins fullName）
      params?: Record<string, string>; // 专属参数：覆盖基础参数的同名键，其余保留；还可追加基础参数中没有的键
    };

参数说明：

参数	类型	说明
`tplName`	`string \\| undefined`	参数模板名称（在「参数」弹框中保存的模板，与分类无关）。传入的模板不存在时命令直接失败并在 `errors` 中返回错误；不传则使用页面参数编辑器的当前参数（即点击「批量触发」按钮会发送的那份参数，含手动编辑但未存为模板的值）；页面从未打开过时才回退到激活模板
`jobPaths`	`BatchTriggerJobSpec[] \\| undefined`	目标 job 列表。纯字符串形态传 Jenkins job 完整路径（如 `infra/k8s/releaseproject1/release19/testjob1`）；对象形态可额外携带该 job 的专属参数。路径需已添加到 Pipeline 树中（按路径精确匹配，容忍首尾斜杠）；不传则触发页面表格中勾选的行（与按钮一致，不是表格的全部行）；页面从未打开过时才回退为侧边栏当前选中的全部 job

参数合并优先级（与 webview 按钮一致，逐级覆盖同名键）：

基础参数（模板 或 页面参数编辑器当前值）
  < 页面已保存的每 Job 专属参数
  < 命令传入的 { path, params } 专属参数

实际生效参数 = { ...基础参数, ...该job专属参数 }（同名键以专属参数优先，其余保留）
命令中未指定专属参数的 job：仍沿用页面已保存的每 Job 专属参数（与按钮行为一致）
命令与页面同时存在某 job 的专属参数：合并，命令优先——同名键以命令为准，其余保留页面设置

边界规则：

情况	处理
`params` 值为 number / boolean	自动转字符串（`3` → `"3"`）
`params` 值为嵌套对象 / 数组	该 job 计入 `errors` 并跳过，不会带错误参数静默触发
元素为空对象 / 缺少 `path`	计入 `errors` 并跳过
`path` 不在 Pipeline 树中	计入 `errors`（不静默忽略）
同一路径重复出现	按出现顺序合并，后者覆盖前者同名键；纯字符串条目不清空已收集的专属参数
`params: {}` 或省略	等价于纯字符串

返回值 BatchTriggerResult：

{
  ok: boolean;                                   // 全部成功为 true
  nodeIds: string[];                             // 实际触发的树节点 ID
  params: Record<string, string>;                // 实际生效的基础参数（模板或页面当前参数）
  jobParams: Record<string, Record<string, string>>; // 按 job 路径键的实际生效专属参数（页面与命令合并后的结果）
  errors: string[];                              // 每个失败的错误信息（模板/job 不存在、触发失败等）
}

使用示例

以下示例假设模板 111111 的参数为 testparam1=pr-1, testparam2=testparam2, testparam3=testparam3, klkl=ll。

// 1. 指定模板 + 指定 job 地址（最常用：外部流程明确驱动）
const r = await vscode.commands.executeCommand(
  "jenkins-batch-trigger.batchTrigger",
  "prod-full",                                     // 参数模板名
  ["infra/k8s/releaseproject1/release20/testjob1"] // job 路径（多个传数组）
);
if (!r.ok) console.error("触发失败:", r.errors);

// 2. 为单个 job 设置专属参数，覆盖模板默认值（与页面「每 Job 专属参数」功能一致）
//    testjob1 → testparam1=pr-1&testparam2=testparam2&testparam3=testparam3&klkl=ll
//    testjob2 → testparam1=pr-2&testparam2=testparam2&testparam3=testparam3&klkl=ll&extraParam=abc
const r2 = await vscode.commands.executeCommand(
  "jenkins-batch-trigger.batchTrigger",
  "111111",
  [
    // 形态1：纯字符串 —— 全用模板参数
    "infra/k8s/releaseproject1/release20/testjob1",
    // 形态2：对象 —— testparam1 覆盖模板的 pr-1，extraParam 为新增参数
    {
      path: "infra/k8s/releaseproject1/release20/testjob2",
      params: { testparam1: "pr-2", extraParam: "abc" },
    },
  ]
);

// 3. 只指定 job 地址（含专属参数），参数用页面参数编辑器的当前值（与按钮相同）
await vscode.commands.executeCommand(
  "jenkins-batch-trigger.batchTrigger",
  undefined,
  [
    "infra/k8s/releaseproject1/release19/testjob1",
    { path: "infra/k8s/releaseproject1/release19/testjob2", params: { testparam1: "pr-2" } },
  ]
);

// 4. 只指定模板，目标用页面表格中勾选的行（与按钮相同）
await vscode.commands.executeCommand(
  "jenkins-batch-trigger.batchTrigger",
  "test-smoke"  // 模板名；job 地址不传 → 触发页面上勾选的行
);

// 5. 两个都不传：完全等价于点击页面的「批量触发」按钮
//    （页面当前参数 + 页面勾选的行 + 页面已保存的每 Job 专属参数）
await vscode.commands.executeCommand("jenkins-batch-trigger.batchTrigger");

// 6. 也可在 keybindings / 任务里引用（见下节）
//    命令 ID: jenkins-batch-trigger.batchTrigger（命令面板中名称为 "Jenkins: Batch Trigger"）

注意：jobPaths 中的路径必须与 Pipeline 树中添加的 job 路径一致（即 Jenkins 的 fullName，如 infra/k8s/releaseproject1/release19/testjob1）。传入树中不存在的路径会记入 errors，不会静默忽略。

在 keybindings.json 中绑定快捷键

模板名与分类无关（分类只是 UI 分组），直接写模板的完整名称即可，首尾空格会被自动容忍。命令兼容以下三种 args 写法：

[
  // 写法①：数组（推荐）—— args: [模板名, job列表]，元素可混用字符串和 { path, params } 对象
  {
    "key": "ctrl+shift+alt+j",
    "command": "jenkins-batch-trigger.batchTrigger",
    "args": [
      "111111",
      [
        "infra/k8s/releaseproject1/release20/testjob1",
        {
          "path": "infra/k8s/releaseproject1/release20/testjob2",
          "params": { "testparam1": "pr-2", "extraParam": "abc" }
        }
      ]
    ]
  },
  // 写法②：对象 —— args: { "tplName": ..., "jobPaths": [...] }
  {
    "key": "ctrl+shift+alt+k",
    "command": "jenkins-batch-trigger.batchTrigger",
    "args": {
      "tplName": "111111",
      "jobPaths": [
        "infra/k8s/releaseproject1/release20/testjob1",
        { "path": "infra/k8s/releaseproject1/release20/testjob2", "params": { "testparam1": "pr-2" } }
      ]
    }
  },
  // 写法③：不带 args —— 等价于点击页面「批量触发」按钮
  {
    "key": "ctrl+shift+alt+l",
    "command": "jenkins-batch-trigger.batchTrigger"
  }
]

如果使用的扩展版本较旧（不支持数组/对象 args 写法），可用 VSCode 内置的 runCommands 包装，它会把 args 数组展开为位置参数：{ "key": "...", "command": "runCommands", "args": { "commands": [{ "command": "jenkins-batch-trigger.batchTrigger", "args": ["111111", ["...job路径..."]] }] } }。

Pre/Post Action 系统

概念

Action 系统实现跨运行的参数闭环：

触发前 (Pre-Actions)          触发后 (Post-Actions)
┌─────────────────────┐      ┌─────────────────────┐
│ 从状态文件读取参数    │      │ 从构建日志提取参数    │
│ 注入到触发参数中      │ ──→  │ 写回状态文件         │
└─────────────────────┘      └─────────────────────┘
         ↑                            │
         └────────────────────────────┘
              下次触发自动使用

启用

右键 Job 节点 → Toggle Pre/Post Actions（节点出现 ⚡ 图标）
右键 → Configure Actions 打开配置面板

配置面板（4 个 Tab）

前置动作：配置触发前执行的 Action 列表
后置动作：配置构建完成后执行的 Action 列表
状态：查看/编辑/重置每个 Pipeline 的状态文件
试运行：输入模拟参数， dry-run Pre-Actions 查看渲染结果（不真正触发）

6 种 Action 类型

类型	用途	关键字段
`state_read`	从状态文件读取值注入参数	`key`（模板）, `target`, `on_missing`
`regex_extract`	从构建日志正则提取值	`pattern`, `target`（模板）, `strategy`
`template_render`	渲染模板字符串	`template`, `target`
`http_request`	调用外部 API	`url`（模板）, `method`, `target`
`env_read`	读取环境变量	`var`, `target`, `on_missing`
`script`	沙箱 JS 脚本（5s 超时）	`code`, `on_error`

模板变量

所有字符串字段支持 ${...} 模板语法：

表达式	说明
${trigger.params.X}	触发时传入的参数
${state.a.b}	state 存储的值
${pipeline_params.X}	pre-action 注入的参数（post-action 中为空）
${env.VAR}	环境变量
${pipeline.name}	pipeline 名称
${pipeline.jobPath}	pipeline 路径
${run.prev.id}	上次构建 ID

配置示例：滚动部署

场景：每次触发时自动传入上次构建的变更 ID，构建完成后从日志提取新的变更 ID 存回。

Pre-Action（state_read）：

{
  "type": "state_read",
  "key": "chg_id.${trigger.params.param1}",
  "target": "pipeline_params.CHANGE_ID",
  "on_missing": "skip"
}

Post-Action（regex_extract）：

{
  "type": "regex_extract",
  "source": "pipeline_logs",
  "pattern": "CHANGE_ID=(\\w+)",
  "target": "state.chg_id.${trigger.params.param1}",
  "strategy": "last",
  "on_no_match": "warn"
}

效果：

第 1 次触发：状态为空，on_missing: skip 跳过注入，正常触发
构建完成：从日志提取 CHANGE_ID=abc123，写入 states/team-a__deploy.json
第 2 次触发：自动读取 chg_id.pr1 → 注入 CHANGE_ID=abc123 到触发参数

状态文件

存储在 globalStorageUri/states/<pipelineId>.json，格式：

{
  "version": 1,
  "updated_at": "2025-01-15T10:30:00.000Z",
  "last_run_id": "team-a/deploy#142",
  "chg_id": {
    "pr1": "abc123",
    "pr2": "def456"
  }
}

错误处理

Pre-Action 失败：跳过该 Pipeline 的触发，不影响其他 Pipeline
Post-Action 失败：所有变更缓冲，全部成功才写入状态文件（原子提交）
轮询超时：30 分钟未完成标记为 stale，停止监控
Script 超时：5 秒强制终止

状态栏

底部状态栏显示两个指示器：

连接状态：$(server) Jenkins: jenkins.example.com — 点击打开设置
运行状态：
- 空闲：$(rocket) Pipeline: 就绪
- 运行中：$(sync~spin) Pipeline: 2 运行 / 1 队列
- 有失败：$(error) Pipeline: 1 失败
- 点击打开 Output Channel 查看详细日志

Output Channel

所有 Action 执行日志和构建轮询日志输出到 Pipeline Actions Output Channel：

状态栏点击 → 自动打开
或 View → Output → 选择 "Pipeline Actions"

配置项

配置	类型	默认值	说明
`jenkinsBatchTrigger.jenkinsUrl`	string	`""`	Jenkins 根 URL
`jenkinsBatchTrigger.username`	string	`""`	Jenkins 用户名
`jenkinsBatchTrigger.trustSelfSignedCert`	boolean	`false`	信任自签名证书
`jenkinsBatchTrigger.actionsEnabled`	boolean	`true`	Action 系统总开关
`jenkinsBatchTrigger.language`	string	`zh`	界面语言（`zh` / `en`）

自动刷新不是配置项：由面板工具栏的「自动刷新」复选框和间隔下拉框控制，默认开启、间隔 1 分钟。

数据存储

数据	位置	说明
树结构 + 选择	VSCode globalState	跨 workspace 共享
页面 UI 状态（参数 / 勾选行 / 每 Job 参数）	VSCode globalState	供 batchTrigger 命令与按钮保持一致
参数模板 + 模板分类	VSCode globalState	跨 workspace 共享
日志提取规则	VSCode globalState	跨 workspace 共享
Action 配置	`globalStorageUri/default-config.json`	所有 Pipeline 共用
Pipeline 状态	`globalStorageUri/states/<id>.json`	按 Pipeline 隔离
API Token	VSCode SecretStorage	加密存储

项目结构

src/
├── extension.ts          # 入口：命令注册、状态栏、OutputChannel
├── state.ts              # 核心状态管理：树、选择、触发、Action 集成
├── treeProvider.ts       # 侧边栏 TreeDataProvider
├── webviewProvider.ts    # 中央面板 Webview 消息桥接
├── webviewHtml.ts        # 中央面板 HTML 模板
├── jenkinsClient.ts      # Jenkins REST API 客户端
├── jobPickerPanel.ts     # Job 选择面板
├── globalStore.ts        # globalState 读写
├── types.ts              # 共享类型定义
├── actionTypes.ts        # Action 系统类型
├── actionStore.ts        # Action 文件存储（原子写）
├── actionEngine.ts       # Action 执行引擎（6 种动作）
├── actionsConfigPanel.ts # Action 配置 Webview 面板
└── buildPoller.ts        # 构建轮询器（单定时器 + 退避）
media/
└── webview-script.js     # 中央面板前端逻辑

常见问题

Q: 触发后状态一直显示 Running？ A: 检查 Jenkins 连接是否正常。自动刷新默认开启（1 分钟一次），也可在工具栏调整间隔或手动点刷新按钮。

Q: Pre-Action 读取状态为空？ A: 首次触发时状态文件不存在，设置 on_missing: "skip" 或 "fallback" 提供默认值。

Q: 如何查看 Action 执行详情？ A: 点击底部状态栏的 Pipeline 状态，或 View → Output → "Pipeline Actions"。

Q: 配置面板中试运行不触发？ A: 试运行（Dry Run）只执行 Pre-Actions 的模板渲染，不会真正触发 Jenkins 构建。

Q: 如何重置某个 Pipeline 的状态？ A: Configure Actions → 状态 Tab → 选择 Pipeline → 重置。

Q: 日志提取的 JS 脚本报错或超时怎么办？ A: 结果表格对应单元格会显示错误信息。检查脚本语法（沙箱无 require/网络/文件访问），单次执行限时 5 秒。注意：返回空值/undefined 显示「未匹配」而非报错。

Q: 日志提取和 Post-Action 的 regex_extract 有什么区别？ A: 日志提取是手动、即时的查看/导出工具，可随时对任意已有构建执行并回写触发参数；Post-Action 在构建完成后自动执行，把结果写入 Action 状态文件供下次触发注入。两者互补：临时排查用日志提取，固定流程用 Post-Action。

License

MIT

Jenkins Pipeline Batch Trigger

ghemail

Jenkins Pipeline Batch Trigger

功能概览

安装

从 VSIX 安装

从源码构建

快速开始

第一步：配置 Jenkins 连接

第二步：组织 Pipeline 树

第三步：批量触发

使用详解

侧边栏树操作

中央面板操作技巧

参数系统

触发预览

日志内容提取

完整案例：发版后收集部署版本与失败摘要

扩展间调用：batchTrigger 命令

命令签名

使用示例

在 keybindings.json 中绑定快捷键

Pre/Post Action 系统

概念

启用

配置面板（4 个 Tab）

6 种 Action 类型

模板变量

配置示例：滚动部署

状态文件

错误处理

状态栏

Output Channel

配置项

数据存储

项目结构

常见问题

License