@wdyy/skills 0.1.13 → 0.1.15

package/.well-known/skills/wdyy-deployment-standard/templates/docker-compose.yml

@@ -1,14 +1,22 @@
 services:
   frontend:
     image: "${PROJECT_NAME:?PROJECT_NAME is required}_frontend:latest"
+    container_name: "${PROJECT_NAME:?PROJECT_NAME is required}_frontend"
+    platform: "${DOCKER_PLATFORM:?DOCKER_PLATFORM is required}"
     env_file: ./.env
     environment:
-      NGINX_ENVSUBST_FILTER: "^(FRONTEND_URL|FRONTEND_PORT)$"
+      NGINX_ENVSUBST_FILTER: "^(FRONTEND_URL|FRONTEND_PORT|VITE_API_BASE_URL|BACKEND_PORT)$"
+      VITE_API_BASE_URL: "${VITE_API_BASE_URL:?VITE_API_BASE_URL is required}"
+      BACKEND_PORT: "${BACKEND_PORT:?BACKEND_PORT is required}"
+      TZ: "${TZ:?TZ is required}"
     ports:
       - "${DOCKER_BIND_IP}:${FRONTEND_PORT}:${FRONTEND_PORT}"
     volumes:
       - ./logs:/app/logs
     restart: unless-stopped
+    depends_on:
+      backend:
+        condition: service_healthy
     healthcheck:
       test: ["CMD", "nginx", "-t"]
       interval: 10s
@@ -17,10 +25,13 @@ services:
 
   backend:
     image: "${PROJECT_NAME:?PROJECT_NAME is required}_backend:latest"
+    container_name: "${PROJECT_NAME:?PROJECT_NAME is required}_backend"
+    platform: "${DOCKER_PLATFORM:?DOCKER_PLATFORM is required}"
     env_file: ./.env
     environment:
       HOST: "${BACKEND_URL}"
       PORT: "${BACKEND_PORT}"
+      TZ: "${TZ:?TZ is required}"
     ports:
       - "${DOCKER_BIND_IP}:${BACKEND_PORT}:${BACKEND_PORT}"
     volumes:

package/.well-known/skills/wdyy-deployment-standard/templates/env.example.template

@@ -1,4 +1,8 @@
+API_PREFIX=api
+VITE_API_BASE_URL=/api
 PROJECT_NAME=
 DOCKER_BIND_IP=
+DOCKER_PLATFORM=linux/amd64
 FRONTEND_BASE_IMAGE=nginx:stable
-BACKEND_BASE_IMAGE=node:24-alpine3.24
+BACKEND_BASE_IMAGE=node:24-bookworm-slim
+TZ=Asia/Shanghai

package/.well-known/skills/wdyy-deployment-standard/templates/frontend-container.conf.template

@@ -12,6 +12,15 @@ server {
     return 200 'ok';
   }
 
+  location ${VITE_API_BASE_URL}/ {
+    proxy_pass http://backend:${BACKEND_PORT};
+    proxy_http_version 1.1;
+    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;
+  }
+
   location / {
     try_files $uri $uri/ /index.html;
   }

package/.well-known/skills/wdyy-deployment-standard/templates/frontend.Dockerfile.template

@@ -2,8 +2,11 @@ ARG BACKEND_BASE_IMAGE
 ARG FRONTEND_BASE_IMAGE
 FROM ${BACKEND_BASE_IMAGE} AS build
 WORKDIR /app
+ARG VITE_API_BASE_URL
+ENV VITE_API_BASE_URL=${VITE_API_BASE_URL}
 COPY . .
 RUN corepack enable && pnpm install --frozen-lockfile
+RUN test -n "$VITE_API_BASE_URL"
 RUN pnpm --dir src/frontend build
 
 FROM ${FRONTEND_BASE_IMAGE}

package/README.md

@@ -18,7 +18,7 @@ OpenSpec                           单项变更的需求、设计、任务、实
 | `wdyy-api-standard` | 根据“获取XX数据”“使用XX接口”等需求定位接口 reference，并按已确认契约写入调用方式。 |
 | `wdyy-bug-record` | 手动汇总当前任务已解决的问题，并按模板追加至 `docs/bug_record.md`。 |
 | `wdyy-logging-standard` | 结构化日志、敏感字段移除、traceId、前端异常上报与日志轮转。 |
-| `wdyy-deployment-standard` | 使用本地基础镜像构建前后端独立镜像，分别导出并统一压缩交付，远程数据库直连，服务器一键部署整个项目栈。 |
+| `wdyy-deployment-standard` | 在 Linux、macOS Docker Desktop 或 Windows Docker Desktop + WSL2/Linux 容器模式中，使用本地基础镜像构建前后端独立镜像，分别导出并统一压缩交付，远程数据库直连并一键部署整个项目栈。 |
 
 ## 使用方式
 
@@ -43,7 +43,7 @@ wdyy update-skill --all
 
 `wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换系统用户目录 `.agents/skills/` 中的指定目录；`--all` 替换全部 5 个受管理 Skill。两种方式都不会写入调用项目的 `AGENTS.md`、`AGENTS_new.md`、`docs/bug_record.md` 或 `.agents/skills/`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
 
-部署 Skill 生成的标准流程为：在本地项目根目录执行 `./deploy.sh build`，只使用本地已有的 Node、Nginx 基础镜像构建 `<项目名>_frontend:latest` 与 `<项目名>_backend:latest`，分别导出两个镜像 tar，并统一封装为 `deploy/<项目名>-docker.tar.gz`。工程师人工上传并解压该压缩包，服务器无参数执行 `./deploy.sh` 即校验、加载并整体部署前后端；另可执行 `./deploy.sh stop` 和 `./deploy.sh status`。数据库通过 `.env` 直连远程 PostgreSQL，不生成数据库容器；前后端直接暴露 `.env` 中的宿主机端口，日志直接保存在服务器部署根 `logs/`。
+部署 Skill 生成的标准流程为：在 Linux、macOS Docker Desktop，或 Windows Docker Desktop + WSL2/Linux 文件系统的项目根目录执行 `./deploy.sh build`，只使用本地已有的 Node、Nginx 基础镜像构建 `<项目名>_frontend:latest` 与 `<项目名>_backend:latest`，分别导出两个镜像 tar，并统一封装为 `deploy/<项目名>-docker.tar.gz`。工程师人工复制并解压该压缩包，在平台匹配的 Linux engine 上无参数执行 `./deploy.sh` 即校验、加载并整体部署前后端；另可执行 `./deploy.sh stop` 和 `./deploy.sh status`。数据库通过 `.env` 直连远程 PostgreSQL，不生成数据库容器；前后端的宿主机与容器端口都来自 `.env`，容器名与镜像 repository 相同，使用 `unless-stopped`，并验证 24 小时制 CST（UTC+8）；日志直接保存在部署根 `logs/`。不支持原生 PowerShell 或 Windows 容器模式。
 
 中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。所有 URL、端口和 IP 地址从 `.env` 读取，不得硬编码；所有项目管理的日志直接写入项目根目录 `logs/`；生产部署不使用蓝绿发布。不得提交秘密或生产环境 `.env`。项目完成后创建 `README.md`，说明技术栈、目录结构和安装部署。
 

package/lib/wdyy-cli.js

@@ -82,7 +82,7 @@ const generatedAgentsContent = `# 企业开发规则
 | 获取已登记接口数据、使用已登记接口 | \`wdyy-api-standard\` |
 | 汇总当前任务已解决的 BUG、漏洞或运行异常 | 手动调用 \`wdyy-bug-record\`，追加写入 \`docs/bug_record.md\` |
 | 结构化日志、traceId、完整原始入参、前端异常上报 | \`wdyy-logging-standard\` |
-| 统一 Docker 交付、本地双镜像、远程数据库与整栈一键部署 | \`wdyy-deployment-standard\` |
+| 统一 Docker 交付、Linux/Mac/Windows WSL2 双镜像、远程数据库与整栈一键部署 | \`wdyy-deployment-standard\` |
 
 ## 通用边界
 
@@ -90,7 +90,7 @@ const generatedAgentsContent = `# 企业开发规则
 - 代码、配置、迁移、测试与部署文件必须以实际实现为准；不得用模板虚构已实现能力。
 - 所有需求（如数据库变更、流程变更、功能变更、从零开发项目等），必须先使用\`openspec-explore\`技能确认需求，再根据实际情况，使用\`openspec\`的其它技能。
 - 所有项目管理的日志必须直接写入项目根目录 \`logs/\`，不得通过环境变量改写目录或创建服务、实例、日期等日志子目录。
-- 生产部署必须使用 \`wdyy-deployment-standard\`：本地只使用已有基础镜像构建前后端两个独立镜像，分别导出后封装为一个压缩包；数据库直连远程实例且不得使用数据库容器；服务器解压后无参数执行 \`./deploy.sh\`，一次性部署整个前后端项目栈。禁止自动拉取镜像、交互菜单和单独操作一个服务。
+- 生产部署必须使用 \`wdyy-deployment-standard\`：在 Linux、macOS Docker Desktop 或 Windows Docker Desktop + WSL2/Linux 容器模式中，只使用已有基础镜像构建前后端两个独立 Linux 镜像，分别导出后封装为一个压缩包；数据库直连远程实例且不得使用数据库容器；解压后无参数执行 \`./deploy.sh\`，一次性部署整个前后端项目栈。禁止原生 PowerShell、Windows 容器模式、自动拉取镜像、交互菜单和单独操作一个服务。
 - 不得静默吞错、跳过验证、以兜底逻辑掩盖未决问题。
 `;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdyy/skills",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "企业内部开发 Skill 与项目初始化命令",
   "type": "module",
   "bin": {