jenkins pipeline必须启用declarative语法支持，即jenkinsfile以pipeline {开头、包含agent和stages结构；否则stage将被静默跳过。需检查首行为pipeline {而非node {或stage('xxx') {，并修正盘古提示词中stage嵌套错误，拆分为原子stage或添加step级echo日志，最后通过“查看流水线语法”生成规范代码验证stage可见性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认Jenkins Pipeline是否启用Declarative语法支持
盘古大模型生成的Jenkins提示词常默认套用Scripted Pipeline写法，但实际运行环境若为Jenkins 2.289+且启用了Declarative Pipeline插件，必须确保Jenkinsfile以pipeline块开头、包含agent和stages结构。否则Jenkins会静默跳过stage定义，只执行顶层脚本逻辑，造成“步骤缺失”的假象。
打开Jenkinsfile，检查首行是否为pipeline {而非node {或stage('xxx') {——【前者是Declarative必需语法，后者属于Scripted，混用将导致stage不被识别】。
修复盘古提示词中常见的stage嵌套错误
盘古大模型倾向将多个操作压缩进单个stage内，例如把代码拉取、依赖安装、单元测试全塞进stage('Build')，这本身合法，但容易掩盖真实执行路径。当某步失败时，Jenkins日志里只显示“Build stage failed”，无法定位到具体是npm install还是jest --ci出错。
方法一：拆分为原子stage
将原提示词中的复合stage按职责切分：Checkout → Install → Test → Build → Deploy。每个stage只做一件事，名称直指动作，如stage('Run unit tests')而非stage('Build')。
将小说章节转换为电影分镜剧本。用户上传txt/md/docx文本，AI分析场景、角色、情绪、镜头语言，输出专业分镜脚本。适用于用户提及“分镜”“storyboard”“小说转分镜”“影视改编”“镜头脚本”或需要将小说改编为分镜的场景。
方法二：启用stage内step级日志标记
在每个关键命令前加echo 'Starting npm install...'，确保即使stage未显式报错，控制台输出也能暴露中断点。
强制Jenkins重载并验证stage可见性
第一步：进入Jenkins任务页→左侧菜单点击“配置”→滚动到底部找到“Pipeline”区域→点击右下角“查看流水线语法”链接；
第二步：在新页面的“Sample Step”下拉框中选择stage→输入stage名称（如Build）→点击“生成流水线脚本”→复制生成的代码片段；
第三步：粘贴回Jenkinsfile对应位置，替换原有不规范写法；
第四步：保存后立即点击“立即构建”，观察构建页面左侧stage面板是否出现可点击的stage节点。
若仍不显示，说明Jenkinsfile存在语法硬伤：检查是否漏掉}闭合符号、stages是否被误写为stage（少s）、steps是否拼成step（少s）。【这些拼写错误会导致Jenkins解析失败，直接忽略整个stages块】。
