diff --git a/jenkins/preview-deployer-job-config.xml b/jenkins/preview-deployer-job-config.xml
index a2317950f..a0cbd4247 100644
--- a/jenkins/preview-deployer-job-config.xml
+++ b/jenkins/preview-deployer-job-config.xml
@@ -5,7 +5,37 @@
false
-
+
+
+ ACTION
+ 部署、查询状态或卸载分支预览容器
+
+
+ DEPLOY
+ STATUS
+ UNINSTALL
+
+
+
+
+ SOURCE_BRANCH
+ 源码分支;DEPLOY 和 UNINSTALL 必填
+
+ true
+
+
+ COMMIT_HASH
+ 可选;必须是 SOURCE_BRANCH 历史中的 commit
+
+ true
+
+
+ DEPLOYMENT_ID
+ 预览实例稳定 ID
+
+ true
+
+
diff --git a/scripts/check-preview-deployer.mjs b/scripts/check-preview-deployer.mjs
index 230052052..32d1b0497 100644
--- a/scripts/check-preview-deployer.mjs
+++ b/scripts/check-preview-deployer.mjs
@@ -132,6 +132,11 @@ assertIncludes(
'jenkins/Jenkinsfile.preview-deployer',
'Jenkins Job 必须从受保护 master 读取固定流水线。',
);
+assertIncludes(
+ jobConfig,
+ '',
+ 'Jenkins Job 首次触发前必须已经声明 buildWithParameters 参数。',
+);
assertIncludes(
nginx,
'location ^~ /api/preview-deployer/',