speccore 8.3.295 → 8.3.296

package/templates/deploy-docker/backend-node.Dockerfile

@@ -0,0 +1,52 @@
+# ═══════════════════════════════════════════════════════════
+# Node.js 后端 Docker 多阶段构建示例（Express / NestJS / Koa）
+# ═══════════════════════════════════════════════════════════
+#
+# 用法：
+#   1. 将本文件复制到后端工程根目录，重命名为 Dockerfile
+#   2. 在 PROJECT.yaml 中配置 docker 类型部署：
+#        type: docker
+#        dockerfile: ./Dockerfile
+#        registry: <镜像仓库>
+#        image: <镜像名>
+#        tag: staging
+#   3. 执行: speccore deploy --env staging --platform <后端端名>
+#
+# 多阶段构建：Node 编译 → 精简运行镜像
+# ═══════════════════════════════════════════════════════════
+
+# ── 阶段 1：依赖安装 + 构建 ──
+FROM node:20-alpine AS builder
+WORKDIR /app
+
+# 先复制依赖文件（利用 Docker 缓存层）
+COPY package*.json ./
+RUN npm ci
+
+# 复制源码并构建
+COPY . .
+RUN npm run build
+
+# ── 阶段 2：运行（只装生产依赖，镜像更小）──
+FROM node:20-alpine
+WORKDIR /app
+
+ENV NODE_ENV=production
+
+# 复制依赖与构建产物
+COPY --from=builder /app/package*.json ./
+RUN npm ci --omit=dev
+COPY --from=builder /app/dist ./dist
+
+# 非 root 用户运行（安全最佳实践）
+RUN addgroup -S app && adduser -S app -G app
+USER app
+
+# 健康检查（按实际端口调整，Express 项目可用 /healthz 路由）
+HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/healthz || exit 1
+
+EXPOSE 3000
+
+# 启动命令（按实际入口调整，如 dist/main.js、dist/server.js）
+CMD ["node", "dist/main.js"]

package/templates/deploy-examples.yaml

@@ -297,6 +297,70 @@ java_docker_example:
   image: my-project/order-service
   tag: staging
 
+# ═══════════════════════════════════════════════════════════
+# 13. Nginx 站点配置（纯服务器托管前端，ssh 类型配套）
+# ═══════════════════════════════════════════════════════════
+#
+# 适用场景：前端 ssh 类型部署到服务器后，由服务器 Nginx 托管。
+# 服务器端完整站点配置模板见 templates/deploy-nginx/nginx-site.conf
+# （含 SPA 回退、gzip、静态缓存、API 反代到本地后端、HTTPS/WebSocket）。
+#
+# 服务器端准备（只需一次）：
+#   sudo cp templates/deploy-nginx/nginx-site.conf /etc/nginx/conf.d/<站点>.conf
+#   # 替换 {{DOMAIN}} / {{APP_DIR}} / {{BACKEND_HOST}} 后：
+#   sudo nginx -t && sudo nginx -s reload
+#
+nginx_site_example:
+  type: ssh
+  build_cmd: npm run build:staging
+  output_dir: dist
+  host: deployer@staging-server.example.com:22
+  key: ~/.ssh/id_rsa
+  remote_dir: /var/www/html/admin-web     # 与站点配置的 {{APP_DIR}} 一致
+  script: sudo nginx -s reload            # 部署完成后重载 Nginx
+
+# ═══════════════════════════════════════════════════════════
+# 14. Go 后端部署（systemd 管理，方式同 Java）
+# ═══════════════════════════════════════════════════════════
+#
+# 适用场景：Go 服务编译为单个二进制，上传服务器由 systemd 管理。
+# systemd service 模板参考 templates/deploy-java/spring-boot.service
+# （将 ExecStart 改为二进制路径即可）。
+#
+go_systemd_example:
+  type: ssh
+  build_cmd: CGO_ENABLED=0 go build -o bin/gateway ./cmd/gateway
+  output_dir: bin
+  host: deployer@staging-server.example.com:22
+  key: ~/.ssh/id_rsa
+  remote_dir: /opt/services/gateway
+  script: sudo systemctl restart gateway
+
+# Go 服务容器化部署
+# Dockerfile 要点：多阶段（golang:1.22-alpine 编译 → alpine 运行），
+# 运行阶段仅复制二进制，参考 deploy-java/Dockerfile 结构。
+go_docker_example:
+  type: docker
+  dockerfile: ./Dockerfile
+  registry: registry.example.com
+  image: my-project/gateway
+  tag: staging
+
+# ═══════════════════════════════════════════════════════════
+# 15. Python 后端部署（gunicorn + systemd）
+# ═══════════════════════════════════════════════════════════
+#
+# 适用场景：Django / Flask / FastAPI 服务，服务器上用 gunicorn 运行。
+# 建议直接使用 ssh 类型 + 自定义脚本完成：构建（打包依赖）→ 上传 → 重启。
+#
+python_gunicorn_example:
+  type: script
+  build_cmd: pip install -r requirements.txt -t dist/
+  script: ./scripts/deploy-python.sh
+  # deploy-python.sh 内容示例（上传 + 重启 gunicorn）：
+  #   rsync -az --delete dist/ deployer@server:/opt/services/api/app/
+  #   ssh deployer@server "sudo systemctl restart api-gunicorn"
+
 # ═══════════════════════════════════════════════════════════
 # 完整 PROJECT.yaml 示例（含部署配置）
 # ═══════════════════════════════════════════════════════════
@@ -357,16 +421,27 @@ deploy:
   remote_dir: /var/www/html/sr-web-operation
 
 # ═══════════════════════════════════════════════════════════
-# 常用脚本示例
+# 常用脚本示例（实体文件见 templates/deploy-scripts/）
 # ═══════════════════════════════════════════════════════════
+#
+# 脚本实体与说明：
+#   templates/deploy-scripts/trigger-jenkins.sh       Jenkins 构建触发
+#   templates/deploy-scripts/deploy-ftp.sh            lftp FTP 上传
+#   templates/deploy-scripts/deploy-password-ssh.sh   sshpass 密码 SSH
+#   templates/deploy-scripts/deploy-compose.sh        docker-compose 编排
+#   templates/deploy-scripts/deploy-python.sh         Python gunicorn 部署
+#   templates/deploy-java/deploy.sh                   服务器端 Java 部署（备份→替换→重启）
+#   templates/deploy-docker/deploy-remote.sh          服务器端 Docker 容器管理
+#
+# 以下为脚本要点摘录（完整版以实体文件为准）：
 
-# --- scripts/trigger-jenkins.sh ---
+# --- trigger-jenkins.sh（要点）---
 # #!/bin/bash
 # curl -X POST \
 #   -u "$JENKINS_USER:$JENKINS_TOKEN" \
 #   "http://jenkins.example.com/job/my-project-$1/build"
 
-# --- scripts/deploy-ftp.sh ---
+# --- deploy-ftp.sh（要点，完整版含环境变量校验）---
 # #!/bin/bash
 # # 使用 lftp 进行 FTP 上传（支持密码）
 # lftp -u "$FTP_USER,$FTP_PASS" "$FTP_HOST" <<EOF
@@ -375,7 +450,7 @@ deploy:
 # bye
 # EOF
 
-# --- scripts/deploy-password-ssh.sh ---
+# --- deploy-password-ssh.sh（要点，完整版含环境变量校验）---
 # #!/bin/bash
 # # 使用 sshpass 进行密码认证的 SSH 部署（需安装 sshpass）
 # # macOS: brew install sshpass
@@ -383,7 +458,7 @@ deploy:
 # sshpass -p "$SSH_PASSWORD" scp -r dist/* "$SSH_USER@$SSH_HOST:$REMOTE_DIR/"
 # sshpass -p "$SSH_PASSWORD" ssh "$SSH_USER@$SSH_HOST" "sudo nginx -s reload"
 
-# --- scripts/deploy-java.sh（服务器端执行） ---
+# --- deploy-java.sh（实体：templates/deploy-java/deploy.sh，服务器端执行）---
 # #!/bin/bash
 # # Java 后端部署脚本（放在服务器上，由 SSH 调用或手动执行）
 # APP_NAME="${1:-order-service}"

package/templates/deploy-nginx/README.md

@@ -0,0 +1,59 @@
+# Nginx 服务器部署指南（纯服务器，非 Docker）
+
+> 本目录提供 **ssh 类型部署**场景下前端站点的 Nginx 服务器端配置模板。
+> Docker 场景（Nginx 容器托管前端）请使用 `templates/deploy-docker/nginx.conf`。
+
+---
+
+## 两种 Nginx 场景怎么选
+
+| 场景 | 部署类型 | 配置文件 | Nginx 位置 |
+|:---|:---|:---|:---|
+| **纯服务器**：构建产物上传到服务器 Nginx 静态目录，后端跑进程/systemd | `ssh`（推荐）/ `sftp` | 本目录 `nginx-site.conf` | 服务器 `/etc/nginx/conf.d/` |
+| **容器化**：前端打成镜像由 Nginx 容器托管 | `docker` | `deploy-docker/nginx.conf` | 镜像内 `/etc/nginx/conf.d/` |
+
+## 快速开始（前端 ssh 部署 + 服务器 Nginx 托管）
+
+```bash
+# 1. 服务器端（只需一次）：复制站点配置并替换占位符
+sudo cp nginx-site.conf /etc/nginx/conf.d/admin-web.conf
+sudo sed -i 's/{{DOMAIN}}/admin.example.com/; s|{{APP_DIR}}|/var/www/html/admin-web|; s|{{BACKEND_HOST}}|127.0.0.1:8080|' /etc/nginx/conf.d/admin-web.conf
+sudo nginx -t && sudo nginx -s reload
+
+# 2. PROJECT.yaml 配置 ssh 类型部署
+#    remote_dir: /var/www/html/admin-web
+#    script: sudo nginx -s reload
+
+# 3. 部署（构建 → 上传 → 重载 Nginx）
+speccore deploy --env staging --platform admin-web
+```
+
+## 模板包含内容
+
+- SPA 路由回退（`try_files` → `/index.html`）
+- gzip 压缩
+- 静态资源长期缓存（`immutable`）
+- `/api/` 反向代理到后端（同机 `127.0.0.1:8080` 或跨机内网地址）
+- WebSocket 升级（注释备用）
+- 健康检查端点透传（`/healthz` → 后端 `/actuator/health`，注释备用）
+- HTTPS server 块（证书就绪后启用）
+- 隐藏文件访问拦截
+
+## 占位符
+
+| 占位符 | 说明 | 示例 |
+|:---|:---|:---|
+| `{{DOMAIN}}` | 站点域名或 IP | `admin.example.com` |
+| `{{APP_DIR}}` | 静态资源目录（= `remote_dir`） | `/var/www/html/admin-web` |
+| `{{BACKEND_HOST}}` | 后端地址 | `127.0.0.1:8080` |
+
+## 与冒烟测试联动
+
+部署完成后可在 `.speccore/environments/{env}.yaml` 的 `tests.base_urls` 配置站点地址，
+`speccore verify` 的部署后冒烟将自动访问验证：
+
+```yaml
+tests:
+  base_urls:
+    admin-web: https://admin.example.com
+```

package/templates/deploy-nginx/nginx-site.conf

@@ -0,0 +1,103 @@
+# ═══════════════════════════════════════════════════════════
+# Nginx 服务器站点配置模板（纯服务器部署，非 Docker 场景）
+# ═══════════════════════════════════════════════════════════
+#
+# 适用场景：speccore deploy 的 ssh 类型部署，前端构建产物
+#   上传到 Nginx 服务器静态目录，后端以进程/服务方式跑在
+#   同一台（或另一台）服务器上。
+#
+# 用法：
+#   1. 复制本文件到服务器: /etc/nginx/conf.d/<your-site>.conf
+#      （或 /etc/nginx/sites-available/ + sites-enabled 软链）
+#   2. 替换 {{占位符}}
+#   3. 校验并重载: sudo nginx -t && sudo nginx -s reload
+#
+# 与 PROJECT.yaml 的对应关系（ssh 类型部署）：
+#   remote_dir  → 下方 root 指向的目录
+#   script      → sudo nginx -s reload（部署完成后重载配置）
+#
+# 占位符说明：
+#   {{DOMAIN}}        站点域名（或服务器 IP）
+#   {{APP_DIR}}       静态资源目录（= remote_dir，如 /var/www/html/admin-web）
+#   {{BACKEND_HOST}}  后端地址（同机为 127.0.0.1:8080，跨机为内网 IP:端口）
+# ═══════════════════════════════════════════════════════════
+
+# ── HTTP（开发/测试环境，或 HTTPS 前的重定向入口）──
+server {
+    listen 80;
+    server_name {{DOMAIN}};
+
+    # 有证书后启用 HTTPS，取消注释并将整块 HTTP 改为重定向：
+    # return 301 https://$host$request_uri;
+
+    include /etc/nginx/conf.d/_site-common.conf;
+}
+
+# ── HTTPS（生产环境，证书就绪后启用）──
+# server {
+#     listen 443 ssl http2;
+#     server_name {{DOMAIN}};
+#
+#     ssl_certificate     /etc/nginx/ssl/{{DOMAIN}}.pem;
+#     ssl_certificate_key /etc/nginx/ssl/{{DOMAIN}}.key;
+#     ssl_protocols       TLSv1.2 TLSv1.3;
+#     ssl_session_cache   shared:SSL:10m;
+#
+#     include /etc/nginx/conf.d/_site-common.conf;
+# }
+
+# ── 站点公共配置（HTTP/HTTPS 共用，独立成文件避免重复）──
+# 保存为 /etc/nginx/conf.d/_site-common.conf 后 include，
+# 或直接展开合并进上方 server 块。
+
+# 静态资源根目录（= PROJECT.yaml 中 ssh 类型的 remote_dir）
+root {{APP_DIR}};
+index index.html;
+
+# gzip 压缩（减少传输体积）
+gzip on;
+gzip_min_length 1k;
+gzip_comp_level 5;
+gzip_types text/plain text/css application/javascript application/json image/svg+xml;
+
+# ── 前端路由（SPA 应用）──
+location / {
+    try_files $uri $uri/ /index.html;
+}
+
+# ── 静态资源长期缓存 ──
+location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2)$ {
+    expires 1y;
+    add_header Cache-Control "public, immutable";
+}
+
+# ── API 反向代理到后端（同机后端）──
+location /api/ {
+    proxy_pass http://{{BACKEND_HOST}}/api/;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    proxy_connect_timeout 10s;
+    proxy_read_timeout 60s;
+}
+
+# ── WebSocket 升级（后端含长连接/推送时启用）──
+# location /ws {
+#     proxy_pass http://{{BACKEND_HOST}};
+#     proxy_http_version 1.1;
+#     proxy_set_header Upgrade $http_upgrade;
+#     proxy_set_header Connection "upgrade";
+#     proxy_read_timeout 3600s;
+# }
+
+# ── 后端健康检查端点透传（部署后验证用）──
+# location = /healthz {
+#     proxy_pass http://{{BACKEND_HOST}}/actuator/health;
+#     access_log off;
+# }
+
+# ── 禁止访问隐藏文件 ──
+location ~ /\. {
+    deny all;
+}

package/templates/deploy-scripts/README.md

@@ -0,0 +1,61 @@
+# 通用部署脚本模板
+
+> 本目录提供 `script` 类型部署的**开箱即用脚本实体**，覆盖 Jenkins 触发、FTP 上传、密码 SSH、Compose 编排、Python 服务五类场景。
+> 对应 `templates/deploy-examples.yaml` 中 script 类型各节的注释示例。
+
+---
+
+## 脚本清单
+
+| 脚本 | 场景 | 依赖 | 关键环境变量 |
+|:---|:---|:---|:---|
+| `trigger-jenkins.sh <job>` | 触发 Jenkins 构建发布 | `curl` | `JENKINS_URL` `JENKINS_USER` `JENKINS_TOKEN` |
+| `deploy-ftp.sh [dir]` | 虚拟主机 FTP 上传（无 SSH 权限） | `lftp` | `FTP_USER` `FTP_PASS` `FTP_HOST` `FTP_REMOTE_DIR` |
+| `deploy-password-ssh.sh [dir]` | 密码认证 SSH 部署（无密钥） | `sshpass` | `SSH_USER` `SSH_PASSWORD` `SSH_HOST` `SSH_REMOTE_DIR` |
+| `deploy-compose.sh [file]` | 服务器端 Compose 编排部署 | `docker-compose` | — |
+| `deploy-python.sh [dir]` | Python gunicorn + systemd 部署 | `rsync` | `DEPLOY_HOST` `DEPLOY_DIR` `SERVICE_NAME` |
+
+## 目录组织约定
+
+部署脚本按「执行位置」分三处存放，各司其职：
+
+```
+① 包内模板 templates/deploy-*/
+   ├── deploy-scripts/        ← 通用脚本实体（本目录，script 类型直接引用）
+   ├── deploy-docker/         ← Docker 构建素材 + 服务器端容器管理脚本（deploy-remote.sh）
+   ├── deploy-java/           ← Java systemd/Docker 素材 + 服务器端脚本（deploy.sh）
+   └── deploy-nginx/          ← 纯服务器 Nginx 站点配置
+         ↓（npm 安装后用户手动 cp 到工程）
+
+② 用户项目 .speccore/environments/scripts/（init 自动生成）
+   ├── deploy.sh              ← 通用 script 类型骨架（TODO 待填）
+   ├── ecosystem.config.js    ← pm2 类型
+   ├── k8s-deployment.yaml    ← k8s 类型
+   ├── java-systemd.service / java-restart.sh ← ssh 类型 Java
+   └── values-{env}.yaml      ← helm 类型（按环境生成）
+         ↓（speccore deploy 按 script/pm2_config/output_dir 字段引用）
+
+③ 端工程内 scripts/（用户自维护）
+   ← 端专属脚本，config.script 用 ./scripts/xxx.sh 相对路径引用
+```
+
+> **路径解析（v8.3.296+）**：引擎对 `script` / `pm2_config` / k8s manifest / helm values 做双基准解析——先在端目录（code_path）找，回退项目根。`./scripts/xxx.sh` 与 `.speccore/environments/scripts/xxx` 两种写法都通。
+
+## 使用方式
+
+```yaml
+# PROJECT.yaml（script 类型）
+deploy:
+  staging:
+    type: script
+    build_cmd: npm run build
+    script: ./scripts/deploy-password-ssh.sh   # 端工程内脚本（推荐）
+    # 或引用项目根资产：
+    # script: .speccore/environments/scripts/deploy.sh
+```
+
+敏感信息（密码/token）一律通过环境变量注入，勿写入配置文件或 git：
+
+```bash
+SSH_USER=deployer SSH_PASSWORD=xxx SSH_HOST=server ./scripts/deploy-password-ssh.sh dist
+```

package/templates/deploy-scripts/deploy-compose.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# Docker Compose 部署脚本（服务器端执行）
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，服务器端统一拉取并启动前后端编排
+# 用法：./deploy-compose.sh [compose-file]
+# 示例：./deploy-compose.sh /opt/deploy/docker-compose.yml
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+COMPOSE_FILE="${1:-/opt/deploy/docker-compose.yml}"
+
+echo "🚀 Compose 部署: $COMPOSE_FILE"
+docker-compose -f "$COMPOSE_FILE" pull
+docker-compose -f "$COMPOSE_FILE" up -d
+
+echo "📋 运行状态:"
+docker-compose -f "$COMPOSE_FILE" ps
+echo "✅ 部署完成"

package/templates/deploy-scripts/deploy-ftp.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# FTP 上传部署脚本（lftp）
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，无 SSH 权限只有 FTP 的虚拟主机场景
+# 环境变量（由用户 shell 环境注入，勿写入 git）：
+#   FTP_USER / FTP_PASS / FTP_HOST / FTP_REMOTE_DIR
+# 用法：FTP_USER=u FTP_PASS=p FTP_HOST=h ./deploy-ftp.sh [本地目录]
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+LOCAL_DIR="${1:-dist}"
+FTP_REMOTE_DIR="${FTP_REMOTE_DIR:-/public_html}"
+
+if [ -z "${FTP_USER:-}" ] || [ -z "${FTP_PASS:-}" ] || [ -z "${FTP_HOST:-}" ]; then
+  echo "❌ 缺少环境变量: FTP_USER / FTP_PASS / FTP_HOST"
+  exit 1
+fi
+
+echo "🚀 FTP 上传: $LOCAL_DIR → $FTP_HOST:$FTP_REMOTE_DIR"
+
+lftp -u "$FTP_USER,$FTP_PASS" "$FTP_HOST" <<INNER_EOF
+set ssl:verify-certificate no
+mirror -R "$LOCAL_DIR" "$FTP_REMOTE_DIR"
+bye
+INNER_EOF
+
+echo "✅ 上传完成"

package/templates/deploy-scripts/deploy-password-ssh.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# 密码认证 SSH 部署脚本（sshpass）
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，无密钥只有密码的 SSH 场景
+# 前置：安装 sshpass（macOS: brew install sshpass；Ubuntu: apt-get install sshpass）
+# 环境变量（由用户 shell 环境注入，勿写入 git）：
+#   SSH_USER / SSH_PASSWORD / SSH_HOST / SSH_REMOTE_DIR
+# 用法：SSH_USER=u SSH_PASSWORD=p ./deploy-password-ssh.sh [本地目录]
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+LOCAL_DIR="${1:-dist}"
+SSH_REMOTE_DIR="${SSH_REMOTE_DIR:-/var/www/html}"
+
+if [ -z "${SSH_USER:-}" ] || [ -z "${SSH_PASSWORD:-}" ] || [ -z "${SSH_HOST:-}" ]; then
+  echo "❌ 缺少环境变量: SSH_USER / SSH_PASSWORD / SSH_HOST"
+  exit 1
+fi
+
+echo "🚀 SSH 上传: $LOCAL_DIR → $SSH_USER@$SSH_HOST:$SSH_REMOTE_DIR"
+
+sshpass -p "$SSH_PASSWORD" scp -r "$LOCAL_DIR"/* "$SSH_USER@$SSH_HOST:$SSH_REMOTE_DIR/"
+sshpass -p "$SSH_PASSWORD" ssh "$SSH_USER@$SSH_HOST" "sudo nginx -s reload"
+
+echo "✅ 部署完成"

package/templates/deploy-scripts/deploy-python.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# Python 服务部署脚本（gunicorn + systemd）
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，上传打包产物并重启 gunicorn 服务
+# 环境变量：
+#   DEPLOY_HOST    服务器地址（user@host）
+#   DEPLOY_DIR     服务器部署目录（默认 /opt/services/api）
+#   SERVICE_NAME   systemd 服务名（默认 api-gunicorn）
+# 用法：./deploy-python.sh [本地产物目录]
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+LOCAL_DIR="${1:-dist}"
+DEPLOY_HOST="${DEPLOY_HOST:-}"
+DEPLOY_DIR="${DEPLOY_DIR:-/opt/services/api}"
+SERVICE_NAME="${SERVICE_NAME:-api-gunicorn}"
+
+if [ -z "$DEPLOY_HOST" ]; then
+  echo "❌ 缺少环境变量: DEPLOY_HOST（格式 user@host）"
+  exit 1
+fi
+
+echo "🚀 Python 部署: $LOCAL_DIR → $DEPLOY_HOST:$DEPLOY_DIR"
+
+rsync -az --delete "$LOCAL_DIR"/ "$DEPLOY_HOST:$DEPLOY_DIR/app/"
+ssh "$DEPLOY_HOST" "sudo systemctl restart $SERVICE_NAME"
+ssh "$DEPLOY_HOST" "sudo systemctl status $SERVICE_NAME --no-pager"
+
+echo "✅ 部署完成"

package/templates/deploy-scripts/trigger-jenkins.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════
+# Jenkins 构建触发脚本
+# ═══════════════════════════════════════════════════════════
+# 用途：script 类型部署，触发 Jenkins 任务完成后续构建/发布
+# 环境变量：JENKINS_URL / JENKINS_USER / JENKINS_TOKEN
+# 用法：./trigger-jenkins.sh <job-name>
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+JOB_NAME="${1:-}"
+
+if [ -z "$JOB_NAME" ]; then
+  echo "用法: $0 <job-name>"
+  exit 1
+fi
+
+JENKINS_URL="${JENKINS_URL:-http://jenkins.example.com}"
+JENKINS_USER="${JENKINS_USER:-}"
+JENKINS_TOKEN="${JENKINS_TOKEN:-}"
+
+echo "🚀 触发 Jenkins: $JOB_NAME"
+
+if [ -n "$JENKINS_USER" ] && [ -n "$JENKINS_TOKEN" ]; then
+  curl -X POST -u "$JENKINS_USER:$JENKINS_TOKEN" "$JENKINS_URL/job/$JOB_NAME/build"
+else
+  curl -X POST "$JENKINS_URL/job/$JOB_NAME/build"
+fi
+
+echo "✅ 已触发（结果请到 Jenkins 控制台查看）"

package/templates/html/speccore-ask-guide.html

@@ -7,4 +7,4 @@
 .match-result{padding:10px 0}.match-summary{font-weight:600;font-size:14px;margin-bottom:12px}.match-detail{color:var(--muted);font-size:12px;line-height:1.6}
 /* Pipeline */
 .pipeline-title{font-weight:600;margin-bottom:16px}.pipeline-steps{display:flex;flex-direction:column;gap:10px}.pipe-step{display:flex;gap:14px;padding:12px 14px;background:rgba(99,102,241,.04);border-left:2px solid var(--purple);border-radius:0 8px 8px 0}.pipe-step .pipe-num{font-family:Orbitron;font-size:20px;font-weight:900;color:var(--purple);min-width:36px}.pipe-step .pipe-cmd{font-weight:600;color:var(--green)}.pipe-step .pipe-args{color:var(--muted);font-size:11px}.pipe-step .pipe-desc{color:var(--muted);font-size:10px;margin-top:4px}.pipe-step .pipe-dep{font-size:9px;color:var(--orange);margin-top:4px}.confirm-bar{text-align:center;padding:14px;margin-top:16px;background:rgba(99,102,241,.08);border:1px dashed rgba(99,102,241,.2);border-radius:8px;color:var(--purple);font-size:12px}
-.footer{text-align:center;color:var(--muted);font-size:10px;margin-top:24px;padding-top:16px;border-top:1px solid rgba(255,255,255,.04)}h1{text-shadow:0 0 20px rgba(14,165,233,.35),0 0 60px rgba(14,165,233,.12)!important}@keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}.card-bg{position:absolute;inset:0;pointer-events:none;z-index:0;background:radial-gradient(ellipse at 25% 10%,rgba(14,165,233,.25) 0%,transparent 70%);animation:cardGlow 3s ease-in-out infinite;transform-origin:top center}@keyframes titleGlow{0%,100%{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15)}50%{text-shadow:0 0 30px rgba(14,165,233,.7),0 0 80px rgba(14,165,233,.3)}}h1,h2{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15);animation:titleGlow 3s ease-in-out infinite}</style></head><body><div class="scanlines"></div><div class="card"><div class="card-bg"></div><div class="vline l"></div><div class="vline r"></div><h1>SPECCORE ASK</h1><div class="query">"我想做一个登录功能"</div><div class="badge">🗺️ 任务指引</div><div class="guide-title">已为你规划「新功能开发全流程」（9 步）</div><div class="guide-steps"><div class="guide-step"><div class="step-num">1</div><div class="step-body"><div class="step-cmd">speccore init</div><div class="step-desc">初始化项目（如果还没有）</div></div></div><div class="guide-step"><div class="step-num">2</div><div class="step-body"><div class="step-cmd">speccore doc2spec -f PRD.docx --iter {iteration}</div><div class="step-desc">导入 PRD 文档，AI 分析生成需求规格</div></div></div><div class="guide-step"><div class="step-num">3</div><div class="step-body"><div class="step-cmd">speccore analyze --iteration {iteration} --audit</div><div class="step-desc">AI 分析需求，生成审计报告</div></div></div><div class="guide-step"><div class="step-num">4</div><div class="step-body"><div class="step-cmd">speccore iteration taskify -f REQUIREMENT.md</div><div class="step-desc">将需求拆分为独立开发任务</div></div></div><div class="guide-step"><div class="step-num">5</div><div class="step-body"><div class="step-cmd">speccore plan --all</div><div class="step-desc">生成任务执行计划，确定优先级和依赖</div></div></div><div class="guide-step"><div class="step-num">6</div><div class="step-body"><div class="step-cmd">speccore execute --auto</div><div class="step-desc">按计划依次执行开发任务</div></div></div><div class="guide-step"><div class="step-num">7</div><div class="step-body"><div class="step-cmd">speccore verify --ui</div><div class="step-desc">本地冒烟测试（自动登录 + 页面冒烟，默认 module 范围）</div></div></div><div class="guide-step"><div class="step-num">8</div><div class="step-body"><div class="step-cmd">speccore pr --auto</div><div class="step-desc">代码提交后创建 Pull Request</div></div></div><div class="guide-step"><div class="step-num">9</div><div class="step-body"><div class="step-cmd">speccore done --all</div><div class="step-desc">全部完成后归档收尾</div></div></div></div><div style="text-align:center;margin-top:16px"><a href="speccore-welcome.html" style="color:var(--cyan);font-size:11px;text-decoration:none">← 返回 ask 引导页</a></div><div class="footer">由 SpecCore 驱动 · v8.3.295 · 2026-08-31</div></div></body></html>
+.footer{text-align:center;color:var(--muted);font-size:10px;margin-top:24px;padding-top:16px;border-top:1px solid rgba(255,255,255,.04)}h1{text-shadow:0 0 20px rgba(14,165,233,.35),0 0 60px rgba(14,165,233,.12)!important}@keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}.card-bg{position:absolute;inset:0;pointer-events:none;z-index:0;background:radial-gradient(ellipse at 25% 10%,rgba(14,165,233,.25) 0%,transparent 70%);animation:cardGlow 3s ease-in-out infinite;transform-origin:top center}@keyframes titleGlow{0%,100%{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15)}50%{text-shadow:0 0 30px rgba(14,165,233,.7),0 0 80px rgba(14,165,233,.3)}}h1,h2{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15);animation:titleGlow 3s ease-in-out infinite}</style></head><body><div class="scanlines"></div><div class="card"><div class="card-bg"></div><div class="vline l"></div><div class="vline r"></div><h1>SPECCORE ASK</h1><div class="query">"我想做一个登录功能"</div><div class="badge">🗺️ 任务指引</div><div class="guide-title">已为你规划「新功能开发全流程」（9 步）</div><div class="guide-steps"><div class="guide-step"><div class="step-num">1</div><div class="step-body"><div class="step-cmd">speccore init</div><div class="step-desc">初始化项目（如果还没有）</div></div></div><div class="guide-step"><div class="step-num">2</div><div class="step-body"><div class="step-cmd">speccore doc2spec -f PRD.docx --iter {iteration}</div><div class="step-desc">导入 PRD 文档，AI 分析生成需求规格</div></div></div><div class="guide-step"><div class="step-num">3</div><div class="step-body"><div class="step-cmd">speccore analyze --iteration {iteration} --audit</div><div class="step-desc">AI 分析需求，生成审计报告</div></div></div><div class="guide-step"><div class="step-num">4</div><div class="step-body"><div class="step-cmd">speccore iteration taskify -f REQUIREMENT.md</div><div class="step-desc">将需求拆分为独立开发任务</div></div></div><div class="guide-step"><div class="step-num">5</div><div class="step-body"><div class="step-cmd">speccore plan --all</div><div class="step-desc">生成任务执行计划，确定优先级和依赖</div></div></div><div class="guide-step"><div class="step-num">6</div><div class="step-body"><div class="step-cmd">speccore execute --auto</div><div class="step-desc">按计划依次执行开发任务</div></div></div><div class="guide-step"><div class="step-num">7</div><div class="step-body"><div class="step-cmd">speccore verify --ui</div><div class="step-desc">本地冒烟测试（自动登录 + 页面冒烟，默认 module 范围）</div></div></div><div class="guide-step"><div class="step-num">8</div><div class="step-body"><div class="step-cmd">speccore pr --auto</div><div class="step-desc">代码提交后创建 Pull Request</div></div></div><div class="guide-step"><div class="step-num">9</div><div class="step-body"><div class="step-cmd">speccore done --all</div><div class="step-desc">全部完成后归档收尾</div></div></div></div><div style="text-align:center;margin-top:16px"><a href="speccore-welcome.html" style="color:var(--cyan);font-size:11px;text-decoration:none">← 返回 ask 引导页</a></div><div class="footer">由 SpecCore 驱动 · v8.3.296 · 2026-08-31</div></div></body></html>

package/templates/html/speccore-ask-pipeline.html

@@ -1 +1 @@
-<!DOCTYPE html><html lang="zh-CN" data-theme="ocean"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"><title>SpecCore · ask --pipeline</title><style>@import url('https://fonts.googleapis.com/css2?family=Orbitron:wght@500;700;900&family=JetBrains+Mono:wght@400;600;700&display=swap');[data-theme="ocean"]{--cyan:#0ea5e9;--bg:#0b1929;--card:rgba(13,31,56,.95);--border:rgba(14,165,233,.15);--text:#bae6fd;--muted:#5b7fa5;--green:#14b8a6;--orange:#f97316;--purple:#6366f1}*{margin:0;padding:0;box-sizing:border-box}body{font-family:'JetBrains Mono',monospace;background:var(--bg);color:var(--text);min-height:100vh;display:flex;align-items:center;justify-content:center;padding:20px}.scanlines{position:fixed;inset:0;pointer-events:none;z-index:99;background:repeating-linear-gradient(0deg,transparent,transparent 2px,rgba(0,240,255,.01) 2px,rgba(0,240,255,.01) 4px)}.card{max-width:900px;width:100%;margin:0 auto;background:var(--card);border:1px solid var(--border);border-radius:16px;padding:32px;position:relative;overflow:hidden;z-index:1}.card::before{content:'';position:absolute;top:0;left:0;right:0;height:1px;background:linear-gradient(90deg,transparent,var(--cyan),transparent);animation:scanX 3s linear infinite}.card::after{content:'';position:absolute;bottom:0;left:0;right:0;height:1px;background:linear-gradient(90deg,transparent,var(--cyan),transparent);animation:scanX-rev 3s linear infinite}@keyframes scanX{0%{transform:translateX(-100%)}100%{transform:translateX(100%)}}@keyframes scanX-rev{0%{transform:translateX(100%)}100%{transform:translateX(-100%)}}@keyframes scanY{0%{transform:translateY(-100%)}100%{transform:translateY(100%)}}@keyframes scanY-rev{0%{transform:translateY(100%)}100%{transform:translateY(-100%)}}.vline{position:absolute;top:0;width:1px;bottom:0;pointer-events:none}.vline.l{left:0;background:linear-gradient(180deg,transparent,var(--cyan),transparent);animation:scanY-rev 3s linear infinite}.vline.r{right:0;background:linear-gradient(180deg,transparent,var(--cyan),transparent);animation:scanY 3s linear infinite}.card-bg{position:absolute;inset:0;pointer-events:none;z-index:0;background:radial-gradient(ellipse at 25% 10%,rgba(14,165,233,.25) 0%,transparent 70%);animation:cardGlow 3s ease-in-out infinite;transform-origin:top center}@keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}.page-title{font-family:'Orbitron',sans-serif;font-size:22px;font-weight:700;text-align:center;color:var(--cyan);margin-bottom:32px;letter-spacing:1px;text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15);animation:titleGlow 3s ease-in-out infinite}@keyframes titleGlow{0%,100%{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15)}50%{text-shadow:0 0 30px rgba(14,165,233,.7),0 0 80px rgba(14,165,233,.3)}}.page-title span{color:var(--text);font-weight:500}.flow-chart{display:flex;align-items:stretch;gap:0;margin-bottom:28px}.flow-node{flex:1;background:rgba(13,31,56,.7);border:1px solid;border-radius:10px;padding:14px 8px;text-align:center;position:relative}.flow-node .icon{font-size:18px;margin-bottom:6px}.flow-node .name{font-size:12px;font-weight:600;margin-bottom:4px}.flow-node .desc{font-size:10px;color:var(--muted)}.flow-node.n1{border-color:rgba(14,165,233,.4);color:var(--cyan)}.flow-node.n2{border-color:rgba(99,102,241,.4);color:var(--purple)}.flow-node.n3{border-color:rgba(14,165,233,.4);color:var(--cyan)}.flow-node.n4{border-color:rgba(20,184,166,.4);color:var(--green)}.flow-connector{width:24px;display:flex;align-items:center;justify-content:center}.flow-connector::after{content:'';width:100%;height:1px;background:linear-gradient(90deg,var(--border),var(--cyan),var(--border))}.example-box{border:1px dashed rgba(14,165,233,.3);border-radius:12px;padding:16px 20px;margin-bottom:24px;background:rgba(14,165,233,.03)}.example-label{font-size:13px;font-weight:600;color:var(--cyan);margin-bottom:8px}.example-query{font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--text)}.example-query code{color:var(--green);font-weight:600}.steps{display:flex;flex-direction:column;gap:12px;margin-bottom:24px}.step{background:rgba(13,31,56,.8);border:1px solid rgba(14,165,233,.12);border-radius:10px;padding:14px 18px}.step-num{font-family:'Orbitron',sans-serif;font-size:14px;font-weight:700;color:var(--green);margin-bottom:6px}.step-cmd{font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--text);margin-bottom:6px}.step-cmd .cmd-name{color:var(--green)}.step-cmd .cmd-args{color:var(--muted)}.step-parse{font-size:12px;color:var(--muted);line-height:1.5}.step-parse::before{content:'→ 解析：';color:var(--cyan)}.confirm-btn{display:block;width:100%;max-width:420px;margin:0 auto 16px;text-align:center;padding:16px;background:linear-gradient(135deg,var(--cyan),#0284c7);border:none;border-radius:40px;color:#fff;font-size:15px;font-weight:600;cursor:pointer;box-shadow:0 0 30px rgba(14,165,233,.3)}.legend{display:flex;justify-content:center;gap:20px;font-size:11px;color:var(--muted);margin-bottom:16px;flex-wrap:wrap}.legend-item{display:flex;align-items:center;gap:4px}.legend-dot{width:8px;height:8px;border-radius:50%;display:inline-block}.legend-dot.required{background:var(--cyan)}.legend-dot.generated{background:var(--green)}.legend-dot.pending{background:rgba(255,255,255,.3)}.back-link{text-align:center;margin-top:12px}.back-link a{color:var(--cyan);font-size:11px;text-decoration:none}.footer{text-align:center;color:var(--muted);font-size:10px;margin-top:20px}</style></head><body><div class="scanlines"></div><div class="card"><div class="card-bg"></div><div class="vline l"></div><div class="vline r"></div><div class="page-title">ask --pipeline <span>多步骤编排引擎</span></div><div class="flow-chart"><div class="flow-node n1"><div class="icon">🧠</div><div class="name">AI 意图分解</div><div class="desc">LLM 分解多步骤</div></div><div class="flow-connector"></div><div class="flow-node n2"><div class="icon">📐</div><div class="name">命令匹配</div><div class="desc">意图→命令图</div></div><div class="flow-connector"></div><div class="flow-node n3"><div class="icon">🔗</div><div class="name">依赖解析</div><div class="desc">顺序/并行/参数</div></div><div class="flow-connector"></div><div class="flow-node n4"><div class="icon">✅</div><div class="name">预览</div><div class="desc">展示给用户</div></div></div><div class="example-box"><div class="example-label">📋 示例：<span class="example-query"><code>/spec-ask "本期迭代：从 PRD 导入到代码提交，跑完整开发流程"</code></span></div></div><div class="steps"><div class="step"><div class="step-num">1.</div><div class="step-cmd"><span class="cmd-name">speccore doc2spec</span> <span class="cmd-args">-f PRD.docx --iter {iteration}</span></div><div class="step-parse">导入 PRD 文档，AI 分析生成需求规格说明书</div></div><div class="step"><div class="step-num">2.</div><div class="step-cmd"><span class="cmd-name">speccore analyze</span> <span class="cmd-args">--iteration {iteration} --audit</span></div><div class="step-parse">AI 深度分析需求，生成审计报告和可行性评估</div></div><div class="step"><div class="step-num">3.</div><div class="step-cmd"><span class="cmd-name">speccore iteration taskify</span> <span class="cmd-args">-f REQUIREMENT.md</span></div><div class="step-parse">将需求拆分为独立开发任务，确定优先级和依赖关系</div></div><div class="step"><div class="step-num">4.</div><div class="step-cmd"><span class="cmd-name">speccore execute</span> <span class="cmd-args">--auto</span></div><div class="step-parse">按任务计划依次自动执行开发、测试和代码生成</div></div><div class="step"><div class="step-num">5.</div><div class="step-cmd"><span class="cmd-name">speccore verify</span> <span class="cmd-args">--ui</span></div><div class="step-parse">本地冒烟测试：自动登录 + 页面冒烟（默认 module 范围）</div></div><div class="step"><div class="step-num">6.</div><div class="step-cmd"><span class="cmd-name">speccore pr</span> <span class="cmd-args">--auto</span></div><div class="step-parse">代码提交后自动创建 Pull Request，完成交付</div></div></div><div class="confirm-btn">确认执行? (y/N) 或修改参数</div><div class="legend"><div class="legend-item"><span class="legend-dot required"></span> = 必选步骤</div><div class="legend-item"><span class="legend-dot generated"></span> = 已生成</div><div class="legend-item"><span class="legend-dot pending"></span> = 待执行</div><div class="legend-item">→ = 依赖传递</div></div><div class="back-link"><a href="speccore-welcome.html">← 返回 ask 引导页</a></div><div class="footer">由 SpecCore 驱动 · v8.3.295 · 2026-08-31</div></div></body></html>
+<!DOCTYPE html><html lang="zh-CN" data-theme="ocean"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1.0"><title>SpecCore · ask --pipeline</title><style>@import url('https://fonts.googleapis.com/css2?family=Orbitron:wght@500;700;900&family=JetBrains+Mono:wght@400;600;700&display=swap');[data-theme="ocean"]{--cyan:#0ea5e9;--bg:#0b1929;--card:rgba(13,31,56,.95);--border:rgba(14,165,233,.15);--text:#bae6fd;--muted:#5b7fa5;--green:#14b8a6;--orange:#f97316;--purple:#6366f1}*{margin:0;padding:0;box-sizing:border-box}body{font-family:'JetBrains Mono',monospace;background:var(--bg);color:var(--text);min-height:100vh;display:flex;align-items:center;justify-content:center;padding:20px}.scanlines{position:fixed;inset:0;pointer-events:none;z-index:99;background:repeating-linear-gradient(0deg,transparent,transparent 2px,rgba(0,240,255,.01) 2px,rgba(0,240,255,.01) 4px)}.card{max-width:900px;width:100%;margin:0 auto;background:var(--card);border:1px solid var(--border);border-radius:16px;padding:32px;position:relative;overflow:hidden;z-index:1}.card::before{content:'';position:absolute;top:0;left:0;right:0;height:1px;background:linear-gradient(90deg,transparent,var(--cyan),transparent);animation:scanX 3s linear infinite}.card::after{content:'';position:absolute;bottom:0;left:0;right:0;height:1px;background:linear-gradient(90deg,transparent,var(--cyan),transparent);animation:scanX-rev 3s linear infinite}@keyframes scanX{0%{transform:translateX(-100%)}100%{transform:translateX(100%)}}@keyframes scanX-rev{0%{transform:translateX(100%)}100%{transform:translateX(-100%)}}@keyframes scanY{0%{transform:translateY(-100%)}100%{transform:translateY(100%)}}@keyframes scanY-rev{0%{transform:translateY(100%)}100%{transform:translateY(-100%)}}.vline{position:absolute;top:0;width:1px;bottom:0;pointer-events:none}.vline.l{left:0;background:linear-gradient(180deg,transparent,var(--cyan),transparent);animation:scanY-rev 3s linear infinite}.vline.r{right:0;background:linear-gradient(180deg,transparent,var(--cyan),transparent);animation:scanY 3s linear infinite}.card-bg{position:absolute;inset:0;pointer-events:none;z-index:0;background:radial-gradient(ellipse at 25% 10%,rgba(14,165,233,.25) 0%,transparent 70%);animation:cardGlow 3s ease-in-out infinite;transform-origin:top center}@keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}.page-title{font-family:'Orbitron',sans-serif;font-size:22px;font-weight:700;text-align:center;color:var(--cyan);margin-bottom:32px;letter-spacing:1px;text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15);animation:titleGlow 3s ease-in-out infinite}@keyframes titleGlow{0%,100%{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15)}50%{text-shadow:0 0 30px rgba(14,165,233,.7),0 0 80px rgba(14,165,233,.3)}}.page-title span{color:var(--text);font-weight:500}.flow-chart{display:flex;align-items:stretch;gap:0;margin-bottom:28px}.flow-node{flex:1;background:rgba(13,31,56,.7);border:1px solid;border-radius:10px;padding:14px 8px;text-align:center;position:relative}.flow-node .icon{font-size:18px;margin-bottom:6px}.flow-node .name{font-size:12px;font-weight:600;margin-bottom:4px}.flow-node .desc{font-size:10px;color:var(--muted)}.flow-node.n1{border-color:rgba(14,165,233,.4);color:var(--cyan)}.flow-node.n2{border-color:rgba(99,102,241,.4);color:var(--purple)}.flow-node.n3{border-color:rgba(14,165,233,.4);color:var(--cyan)}.flow-node.n4{border-color:rgba(20,184,166,.4);color:var(--green)}.flow-connector{width:24px;display:flex;align-items:center;justify-content:center}.flow-connector::after{content:'';width:100%;height:1px;background:linear-gradient(90deg,var(--border),var(--cyan),var(--border))}.example-box{border:1px dashed rgba(14,165,233,.3);border-radius:12px;padding:16px 20px;margin-bottom:24px;background:rgba(14,165,233,.03)}.example-label{font-size:13px;font-weight:600;color:var(--cyan);margin-bottom:8px}.example-query{font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--text)}.example-query code{color:var(--green);font-weight:600}.steps{display:flex;flex-direction:column;gap:12px;margin-bottom:24px}.step{background:rgba(13,31,56,.8);border:1px solid rgba(14,165,233,.12);border-radius:10px;padding:14px 18px}.step-num{font-family:'Orbitron',sans-serif;font-size:14px;font-weight:700;color:var(--green);margin-bottom:6px}.step-cmd{font-family:'JetBrains Mono',monospace;font-size:14px;color:var(--text);margin-bottom:6px}.step-cmd .cmd-name{color:var(--green)}.step-cmd .cmd-args{color:var(--muted)}.step-parse{font-size:12px;color:var(--muted);line-height:1.5}.step-parse::before{content:'→ 解析：';color:var(--cyan)}.confirm-btn{display:block;width:100%;max-width:420px;margin:0 auto 16px;text-align:center;padding:16px;background:linear-gradient(135deg,var(--cyan),#0284c7);border:none;border-radius:40px;color:#fff;font-size:15px;font-weight:600;cursor:pointer;box-shadow:0 0 30px rgba(14,165,233,.3)}.legend{display:flex;justify-content:center;gap:20px;font-size:11px;color:var(--muted);margin-bottom:16px;flex-wrap:wrap}.legend-item{display:flex;align-items:center;gap:4px}.legend-dot{width:8px;height:8px;border-radius:50%;display:inline-block}.legend-dot.required{background:var(--cyan)}.legend-dot.generated{background:var(--green)}.legend-dot.pending{background:rgba(255,255,255,.3)}.back-link{text-align:center;margin-top:12px}.back-link a{color:var(--cyan);font-size:11px;text-decoration:none}.footer{text-align:center;color:var(--muted);font-size:10px;margin-top:20px}</style></head><body><div class="scanlines"></div><div class="card"><div class="card-bg"></div><div class="vline l"></div><div class="vline r"></div><div class="page-title">ask --pipeline <span>多步骤编排引擎</span></div><div class="flow-chart"><div class="flow-node n1"><div class="icon">🧠</div><div class="name">AI 意图分解</div><div class="desc">LLM 分解多步骤</div></div><div class="flow-connector"></div><div class="flow-node n2"><div class="icon">📐</div><div class="name">命令匹配</div><div class="desc">意图→命令图</div></div><div class="flow-connector"></div><div class="flow-node n3"><div class="icon">🔗</div><div class="name">依赖解析</div><div class="desc">顺序/并行/参数</div></div><div class="flow-connector"></div><div class="flow-node n4"><div class="icon">✅</div><div class="name">预览</div><div class="desc">展示给用户</div></div></div><div class="example-box"><div class="example-label">📋 示例：<span class="example-query"><code>/spec-ask "本期迭代：从 PRD 导入到代码提交，跑完整开发流程"</code></span></div></div><div class="steps"><div class="step"><div class="step-num">1.</div><div class="step-cmd"><span class="cmd-name">speccore doc2spec</span> <span class="cmd-args">-f PRD.docx --iter {iteration}</span></div><div class="step-parse">导入 PRD 文档，AI 分析生成需求规格说明书</div></div><div class="step"><div class="step-num">2.</div><div class="step-cmd"><span class="cmd-name">speccore analyze</span> <span class="cmd-args">--iteration {iteration} --audit</span></div><div class="step-parse">AI 深度分析需求，生成审计报告和可行性评估</div></div><div class="step"><div class="step-num">3.</div><div class="step-cmd"><span class="cmd-name">speccore iteration taskify</span> <span class="cmd-args">-f REQUIREMENT.md</span></div><div class="step-parse">将需求拆分为独立开发任务，确定优先级和依赖关系</div></div><div class="step"><div class="step-num">4.</div><div class="step-cmd"><span class="cmd-name">speccore execute</span> <span class="cmd-args">--auto</span></div><div class="step-parse">按任务计划依次自动执行开发、测试和代码生成</div></div><div class="step"><div class="step-num">5.</div><div class="step-cmd"><span class="cmd-name">speccore verify</span> <span class="cmd-args">--ui</span></div><div class="step-parse">本地冒烟测试：自动登录 + 页面冒烟（默认 module 范围）</div></div><div class="step"><div class="step-num">6.</div><div class="step-cmd"><span class="cmd-name">speccore pr</span> <span class="cmd-args">--auto</span></div><div class="step-parse">代码提交后自动创建 Pull Request，完成交付</div></div></div><div class="confirm-btn">确认执行? (y/N) 或修改参数</div><div class="legend"><div class="legend-item"><span class="legend-dot required"></span> = 必选步骤</div><div class="legend-item"><span class="legend-dot generated"></span> = 已生成</div><div class="legend-item"><span class="legend-dot pending"></span> = 待执行</div><div class="legend-item">→ = 依赖传递</div></div><div class="back-link"><a href="speccore-welcome.html">← 返回 ask 引导页</a></div><div class="footer">由 SpecCore 驱动 · v8.3.296 · 2026-08-31</div></div></body></html>

package/templates/html/speccore-ask-result.html

@@ -7,4 +7,4 @@
 .match-result{padding:10px 0}.match-summary{font-weight:600;font-size:14px;margin-bottom:12px}.match-detail{color:var(--muted);font-size:12px;line-height:1.6}
 /* Pipeline */
 .pipeline-title{font-weight:600;margin-bottom:16px}.pipeline-steps{display:flex;flex-direction:column;gap:10px}.pipe-step{display:flex;gap:14px;padding:12px 14px;background:rgba(99,102,241,.04);border-left:2px solid var(--purple);border-radius:0 8px 8px 0}.pipe-step .pipe-num{font-family:Orbitron;font-size:20px;font-weight:900;color:var(--purple);min-width:36px}.pipe-step .pipe-cmd{font-weight:600;color:var(--green)}.pipe-step .pipe-args{color:var(--muted);font-size:11px}.pipe-step .pipe-desc{color:var(--muted);font-size:10px;margin-top:4px}.pipe-step .pipe-dep{font-size:9px;color:var(--orange);margin-top:4px}.confirm-bar{text-align:center;padding:14px;margin-top:16px;background:rgba(99,102,241,.08);border:1px dashed rgba(99,102,241,.2);border-radius:8px;color:var(--purple);font-size:12px}
-.footer{text-align:center;color:var(--muted);font-size:10px;margin-top:24px;padding-top:16px;border-top:1px solid rgba(255,255,255,.04)}@keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}.card-bg{position:absolute;inset:0;pointer-events:none;z-index:0;background:radial-gradient(ellipse at 25% 10%,rgba(14,165,233,.25) 0%,transparent 70%);animation:cardGlow 3s ease-in-out infinite;transform-origin:top center}@keyframes titleGlow{0%,100%{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15)}50%{text-shadow:0 0 30px rgba(14,165,233,.7),0 0 80px rgba(14,165,233,.3)}}h1,h2{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15);animation:titleGlow 3s ease-in-out infinite}</style></head><body><div class="scanlines"></div><div class="card"><div class="card-bg"></div><div class="vline l"></div><div class="vline r"></div><h1>SPECCORE ASK</h1><div class="query">"dashboard"</div><div class="badge">🎯 意图匹配</div><div class="match-result"><div class="match-summary">✅ 推荐: dashboard</div><div class="match-detail">🎯 推荐命令: <code>speccore dashboard<br>项目仪表盘：期次状态/进度/健康度，--scope</code> global 全量视图<br><br>用法: <code>speccore dashboard</code> [--scope global|iteration] [--export html] [--health] [--lifecycle]<br><br>示例:<br>  $ <code>speccore dashboard<br></code>  $ <code>speccore dashboard</code> --scope global --export html</div></div><div class="footer">由 SpecCore 驱动 v8.3.295 · 2026-08-31</div></div></body></html>
+.footer{text-align:center;color:var(--muted);font-size:10px;margin-top:24px;padding-top:16px;border-top:1px solid rgba(255,255,255,.04)}@keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}.card-bg{position:absolute;inset:0;pointer-events:none;z-index:0;background:radial-gradient(ellipse at 25% 10%,rgba(14,165,233,.25) 0%,transparent 70%);animation:cardGlow 3s ease-in-out infinite;transform-origin:top center}@keyframes titleGlow{0%,100%{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15)}50%{text-shadow:0 0 30px rgba(14,165,233,.7),0 0 80px rgba(14,165,233,.3)}}h1,h2{text-shadow:0 0 20px rgba(14,165,233,.4),0 0 60px rgba(14,165,233,.15);animation:titleGlow 3s ease-in-out infinite}</style></head><body><div class="scanlines"></div><div class="card"><div class="card-bg"></div><div class="vline l"></div><div class="vline r"></div><h1>SPECCORE ASK</h1><div class="query">"dashboard"</div><div class="badge">🎯 意图匹配</div><div class="match-result"><div class="match-summary">✅ 推荐: dashboard</div><div class="match-detail">🎯 推荐命令: <code>speccore dashboard<br>项目仪表盘：期次状态/进度/健康度，--scope</code> global 全量视图<br><br>用法: <code>speccore dashboard</code> [--scope global|iteration] [--export html] [--health] [--lifecycle]<br><br>示例:<br>  $ <code>speccore dashboard<br></code>  $ <code>speccore dashboard</code> --scope global --export html</div></div><div class="footer">由 SpecCore 驱动 v8.3.296 · 2026-08-31</div></div></body></html>