create-dwy 0.8.0 → 0.9.1

package/templates/claude-global/rules/dwy-server-security.md

@@ -1,518 +0,0 @@
----
-description: 服务器/容器/Nginx/SSH/CORS/部署安全规范
-paths:
-  - "**/docker-compose*.yml"
-  - "**/Dockerfile*"
-  - "**/nginx*.conf"
-  - "**/deploy*.sh"
-  - "**/.env.example"
----
-
-# 服务器安全部署规则
-
-所有项目部署到云服务器时必须遵循以下规则。如果任何操作违反这些规则，必须**立即提示用户并获得明确确认**后才能继续。
-
-## 一、端口与网络隔离
-
-### 强制规则
-- 数据库（PostgreSQL/MySQL/Redis 等）**禁止暴露到宿主机端口**，仅通过 Docker 内部网络访问
-- 后端应用端口绑定 `127.0.0.1`，不允许 `0.0.0.0`
-- 仅 Nginx/反向代理的 80/443 端口绑定 `0.0.0.0`
-
-### docker-compose 示例
-```yaml
-# ✅ 正确
-backend:
-  ports:
-    - "127.0.0.1:{port}:{port}"
-
-db:
-  # 不写 ports，仅内部网络
-
-# ❌ 违规 — 需要提示用户
-db:
-  ports:
-    - "{db_port}:{db_port}"
-backend:
-  ports:
-    - "{port}:{port}"
-```
-
-## 二、防火墙
-
-### 强制规则
-- 生产服务器**必须启用防火墙**（ufw 或 iptables）
-- **只开放业务必需端口**，其余全部关闭
-
-### 最小端口策略
-
-| 端口 | 用途 | 开放方式 |
-|------|------|---------|
-| 80 | HTTP（Nginx） | `ufw allow 80/tcp` |
-| 443 | HTTPS（Nginx） | `ufw allow 443/tcp` |
-| SSH 非标端口 | SSH 远程管理 | `ufw allow {ssh_port}/tcp` |
-
-**禁止开放的端口：**
-- 5432（PostgreSQL）
-- 6379（Redis）
-- 9000（MinIO）
-- 8000-9999（后端应用）
-
-### 配置示例
-```bash
-ufw default deny incoming
-ufw default allow outgoing
-ufw allow 80/tcp
-ufw allow 443/tcp
-ufw allow {ssh_port}/tcp
-ufw enable
-```
-
-### 违规检测
-如果在部署脚本或命令中发现 `ufw allow 5432` 等数据库端口开放命令，必须立即提示用户。
-
-## 三、凭证与密钥管理
-
-### 强制规则
-- **禁止在代码中硬编码**数据库密码、API Key、Secret 等凭证
-- 所有凭证通过 `.env` 文件或环境变量注入
-- `.env` 文件必须在 `.gitignore` 中排除
-- 数据库密码最少 24 位，包含大小写字母和数字
-- 提供 `.env.example` 模板文件（仅含占位符，不含真实值）
-
-### 违规检测
-如果在代码中发现以下内容，必须提示用户：
-- 硬编码的数据库连接字符串含真实密码
-- API Key 出现在非 `.env` 文件中
-- SSH 密码、私钥路径出现在代码或文档中
-
-## 四、Nginx 安全配置
-
-### 核心原则
-**只开放业务必需的路径和方法，其余一律拒绝。**
-
-### 强制规则
-
-每个项目的 Nginx 配置必须包含以下安全基线（具体路径、端口、超时时间根据项目在项目级 CLAUDE.md 中配置）：
-
-**1. 频率限制（http 块）**
-```nginx
-limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;
-limit_req_zone $binary_remote_addr zone=login_limit:10m rate=3r/m;
-limit_req_zone $binary_remote_addr zone=page_limit:10m rate=30r/s;
-limit_conn_zone $binary_remote_addr zone=conn_limit:10m;
-```
-
-注意：`limit_req_zone` 和 `limit_conn_zone` **必须放在 `http` 块**，不能放在 `server` 块。
-
-**2. 安全响应头（server 块）**
-```nginx
-add_header X-Frame-Options "SAMEORIGIN" always;
-add_header X-Content-Type-Options "nosniff" always;
-add_header X-XSS-Protection "1; mode=block" always;
-add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'" always;
-add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
-```
-
-**3. HTTPS 强制（server 块）**
-```nginx
-# HTTP → HTTPS 重定向
-server {
-    listen 80;
-    server_name example.com;
-    return 301 https://$server_name$request_uri;
-}
-```
-
-生产环境**必须启用 HTTPS**，使用 certbot 自动续期：
-```bash
-certbot --nginx -d example.com
-```
-
-**4. 全局限制（server 块）**
-```nginx
-client_body_timeout 10s;
-client_header_timeout 10s;
-limit_conn conn_limit 20;
-```
-
-**5. 敏感文件屏蔽（最高优先级）**
-```nginx
-location ~ /\. {
-    deny all;
-    return 404;
-}
-
-location ~* \.(env|git|xlsx|sql|log|bak|dump|tar|gz|zip|csv)$ {
-    deny all;
-    return 404;
-}
-```
-
-**6. API 路径最小化**
-```nginx
-location /api {
-    limit_except GET POST {
-        deny all;
-    }
-    limit_req zone=api_limit burst=20 nodelay;
-    # proxy_pass 等具体配置由项目决定
-}
-```
-
-**7. 登录接口专用限流**
-```nginx
-location /api/auth/login {
-    limit_req zone=login_limit burst=5 nodelay;
-    proxy_pass http://127.0.0.1:{backend_port};
-    proxy_set_header Host $host;
-    proxy_set_header X-Real-IP $remote_addr;
-}
-```
-
-**8. 攻击路径屏蔽**
-```nginx
-location ~ ^/(admin|phpmyadmin|wp-admin|cgi-bin|actuator|console|debug|\.well-known/security\.txt) {
-    deny all;
-    return 404;
-}
-```
-
-**9. 扫描器 User-Agent 屏蔽（http 块）**
-```nginx
-map $http_user_agent $is_scanner {
-    default 0;
-    ~*sqlmap 1;
-    ~*nmap 1;
-    ~*nikto 1;
-    ~*dirbuster 1;
-    ~*gobuster 1;
-    ~*masscan 1;
-    ~*zgrab 1;
-    ~*python-requests 1;
-}
-
-# 在 server 块中
-if ($is_scanner) {
-    return 403;
-}
-```
-
-### 违规检测
-如果 Nginx 配置中出现以下情况，必须提示用户：
-- 缺少 `limit_req` 频率限制
-- API 路径允许 PUT/DELETE 但业务不需要
-- 缺少 `location ~ /\.` 敏感文件屏蔽
-- 使用 `proxy_pass` 但未设置 `proxy_connect_timeout`
-- 生产环境未启用 HTTPS
-- 缺少登录接口专用限流
-
-### 部署后必须验证
-```bash
-# 1. 敏感文件返回 404
-curl -s -o /dev/null -w "%{http_code}" http://{server}/.git/config
-curl -s -o /dev/null -w "%{http_code}" http://{server}/.env
-
-# 2. 安全头存在
-curl -sI https://{server}/ | grep -i "x-frame-options"
-curl -sI https://{server}/ | grep -i "x-content-type-options"
-curl -sI https://{server}/ | grep -i "strict-transport-security"
-
-# 3. 非法方法被拒绝
-curl -s -o /dev/null -w "%{http_code}" -X DELETE http://{server}/api/health
-
-# 4. 攻击路径被屏蔽
-curl -s -o /dev/null -w "%{http_code}" http://{server}/phpmyadmin
-
-# 5. 扫描器 UA 被拒绝
-curl -s -o /dev/null -w "%{http_code}" -A "sqlmap/1.0" http://{server}/
-
-# 6. 登录限流生效
-for i in {1..10}; do curl -s -o /dev/null -w "%{http_code}\n" -X POST http://{server}/api/auth/login; done
-
-# 7. 正常服务可用
-curl -s http://{server}/api/health
-```
-
-## 五、Docker 容器安全
-
-### 强制规则
-- Dockerfile **必须使用非 root 用户**运行应用
-- 必须创建 `.dockerignore` 排除 `.env`、`.git`、`cache/`、`__pycache__`
-- Python 项目设置 `ENV PYTHONUNBUFFERED=1`
-- Node.js 项目设置 `ENV NODE_ENV=production`
-- **使用最小化基础镜像**（`python:3.11-slim`，不用 `python:3.11`）
-- **禁止在镜像中安装不必要的工具**（ssh、telnet、curl 等调试工具生产不需要）
-- 容器文件系统**建议只读挂载**（`read_only: true`），需要写入的目录用 `tmpfs` 或 volume
-
-### Dockerfile 安全示例
-```dockerfile
-FROM python:3.11-slim
-
-# 只安装必要的编译依赖，安装后清理
-RUN apt-get update && apt-get install -y --no-install-recommends gcc \
-    && rm -rf /var/lib/apt/lists/*
-
-WORKDIR /app
-COPY pyproject.toml .
-RUN pip install --no-cache-dir .
-
-COPY src/ src/
-
-# 创建非 root 用户
-RUN useradd -m appuser
-USER appuser
-
-CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
-```
-
-## 六、CORS 配置
-
-### 强制规则
-- **禁止生产环境使用 `*` 通配符**
-- 必须明确列出允许的域名/IP
-- 通过环境变量配置，便于不同环境切换
-
-```
-# ✅ 正确 — 明确列出
-ALLOWED_ORIGINS=["https://example.com","https://www.example.com"]
-
-# ❌ 违规
-ALLOWED_ORIGINS=*
-```
-
-## 七、数据安全
-
-### 强制规则
-- 手机号在返回前必须脱敏（如 `138****5678`）
-- 身份证号在返回前必须脱敏（如 `420***********1234`）
-- 查询日志中的 PII（姓名、手机号等）建议加密存储
-- 数据源文件（Excel/CSV 等）不可通过 Web 直接访问
-- 数据库数据仅通过应用层访问，不暴露数据库管理端口
-
-## 八、Git 仓库安全
-
-### 强制规则
-`.gitignore` 必须包含：
-```
-.env
-*.env
-__pycache__/
-*.pyc
-node_modules/
-dist/
-*.log
-```
-
-### 违规检测
-如果发现以下文件被 `git add`，必须立即阻止并提示用户：
-- `.env` 文件
-- 含真实密码/密钥的配置文件
-- SSH 私钥文件
-- 数据库备份文件（`.sql`、`.dump`）
-- 含敏感数据的原始数据文件（`.xlsx`、`.csv`）
-
-## 九、SSH 安全
-
-### 强制规则
-- **禁止密码登录**，仅允许密钥认证
-- **禁止 root 密码登录**（`PermitRootLogin prohibit-password` 或 `without-password`）
-- **禁止使用默认 22 端口**，改为非标端口（如 66）
-- SSH 私钥文件（`id_rsa`、`id_ed25519` 等）**禁止出现在代码仓库、文档、聊天记录中**
-- 服务器 IP、SSH 端口、用户名**禁止写入代码仓库**（包括 README、部署文档）
-
-### 违规检测
-如果在任何文件中发现以下内容，必须立即提示用户：
-- SSH 连接命令含完整 IP + 端口 + 用户名
-- 服务器凭证信息（IP、端口、密码、密钥路径）
-- `sshd_config` 中 `PasswordAuthentication yes`
-
-### 安全基线配置（`/etc/ssh/sshd_config`）
-```
-Port 66                              # 非标端口
-PermitRootLogin prohibit-password    # 禁止 root 密码登录
-PasswordAuthentication no            # 禁止所有密码登录
-PubkeyAuthentication yes             # 启用密钥认证
-MaxAuthTries 3                       # 最大尝试次数
-LoginGraceTime 30                    # 登录超时 30 秒
-```
-
-### 配合 fail2ban
-服务器**必须配置** fail2ban 防暴力破解：
-```
-# /etc/fail2ban/jail.local
-[sshd]
-enabled = true
-port = 66
-maxretry = 5
-bantime = 3600
-
-# Nginx 暴力请求封禁
-[nginx-limit-req]
-enabled = true
-filter = nginx-limit-req
-logpath = /var/log/nginx/error.log
-maxretry = 10
-bantime = 600
-```
-
-### 部署操作规范
-- 通过 SSH 连接服务器时，连接信息从本地 `~/.ssh/config` 读取，不在命令行暴露
-- 推荐在 `~/.ssh/config` 中配置 Host 别名：
-```
-Host myserver
-    HostName <ip>
-    Port <port>
-    User root
-    IdentityFile ~/.ssh/id_rsa
-```
-- 部署脚本中使用 `ssh myserver` 而非完整连接命令
-
-## 十、系统安全加固
-
-### 自动安全更新
-生产服务器**必须启用自动安全更新**：
-```bash
-apt install -y unattended-upgrades
-dpkg-reconfigure -plow unattended-upgrades
-```
-
-### 文件权限
-| 文件 | 权限 | 命令 |
-|------|------|------|
-| `.env` | 600（仅所有者读写） | `chmod 600 .env` |
-| SSH 私钥 | 600 | `chmod 600 ~/.ssh/id_*` |
-| `authorized_keys` | 644 | `chmod 644 ~/.ssh/authorized_keys` |
-| 应用目录 | 755 | `chmod 755 /opt/myapp` |
-
-**禁止出现 777 权限。** 如果在部署脚本中发现 `chmod 777`，必须立即提示用户。
-
-### 日志监控
-生产服务器必须定期检查以下日志：
-```bash
-# SSH 登录记录
-journalctl -u sshd --since "1 hour ago"
-
-# Nginx 错误日志
-tail -100 /var/log/nginx/error.log
-
-# 被 fail2ban 封禁的 IP
-fail2ban-client status sshd
-
-# Docker 容器日志
-docker compose logs --tail 100 backend
-```
-
-## 十一、数据持久化与防删除
-
-### 核心原则
-**所有业务数据必须通过 Docker Named Volume 持久化。任何可能导致数据丢失的操作，必须提前说明原因并获得用户确认。**
-
-### 强制规则 — Docker Volume
-
-- 数据库容器**必须挂载 Named Volume**到数据目录
-- **禁止使用匿名卷或仅容器内存储**
-- 重启策略必须设为 `unless-stopped` 或 `always`
-
-```yaml
-# ✅ 正确 — Named Volume 持久化
-db:
-  volumes:
-    - dbdata:/var/lib/postgresql/data
-  restart: unless-stopped
-
-volumes:
-  dbdata:
-
-# ❌ 违规 — 数据在容器内，删除即丢失
-db:
-  # 没有 volumes 配置
-```
-
-### 危险操作清单
-
-以下命令**执行前必须停止、说明原因、说明影响、等待用户确认**：
-
-| 命令 | 风险等级 | 后果 |
-|---|---|---|
-| `docker compose down -v` | **致命** | 删除所有 Volume，数据永久丢失 |
-| `docker volume rm <name>` | **致命** | 删除指定 Volume，数据永久丢失 |
-| `docker volume prune` | **致命** | 删除所有未使用的 Volume |
-| `docker system prune -a --volumes` | **致命** | 清除所有镜像、容器、Volume |
-| `rm -rf /var/lib/docker/volumes/` | **致命** | 删除所有 Docker 数据 |
-| `DROP TABLE` / `DROP DATABASE` | **致命** | 删除数据库表或整个数据库 |
-| `DELETE FROM <table>` 无 WHERE | **高危** | 清空整张表数据 |
-| `TRUNCATE TABLE` | **高危** | 清空表数据且无法回滚 |
-| `rm -rf` 含数据目录 | **高危** | 删除文件系统数据 |
-| `git clean -fdx` | **高危** | 删除所有未跟踪文件（含数据文件） |
-
-### 违规处理
-当 AI 需要执行以上任何操作时，必须：
-
-1. **立即停止**，不执行该命令
-2. **说明原因**：为什么需要执行这个操作
-3. **说明影响**：会删除哪些数据、多少条记录
-4. **提供替代方案**（如有）：是否有不删除数据的方式达到目的
-5. **等待用户明确回复"确认"**后才能执行
-
-### 备份
-生产环境**必须配置定期备份**：
-```bash
-# PostgreSQL 每日备份（建议 cron 每天凌晨执行）
-docker exec <db_container> pg_dump -U <user> <database> > backup_$(date +%Y%m%d).sql
-
-# 备份文件不得放在 Web 可访问目录
-# 建议放在 /var/backups/ 下，定期清理超过 30 天的备份
-find /var/backups/ -name "backup_*.sql" -mtime +30 -delete
-```
-
-## 十二、部署后检查清单
-
-每次部署完成后，必须执行以下验证：
-
-```bash
-# 1. 防火墙状态
-ufw status | grep -E "80|443|{ssh_port}"
-
-# 2. 数据库端口不可外部访问
-timeout 3 nc -z {server_ip} 5432 && echo "FAIL" || echo "PASS"
-timeout 3 nc -z {server_ip} 6379 && echo "FAIL" || echo "PASS"
-
-# 3. 后端端口不可外部直连
-timeout 3 nc -z {server_ip} {backend_port} && echo "FAIL" || echo "PASS"
-
-# 4. 敏感文件不可下载
-curl -s -o /dev/null -w "%{http_code}" https://{server}/.git/config  # 必须 404
-curl -s -o /dev/null -w "%{http_code}" https://{server}/.env          # 必须 404
-
-# 5. HTTPS 工作正常
-curl -sI https://{server}/ | grep "strict-transport-security"  # 必须有输出
-
-# 6. 安全头完整
-curl -sI https://{server}/ | grep -i "x-frame-options"
-curl -sI https://{server}/ | grep -i "x-content-type-options"
-curl -sI https://{server}/ | grep -i "content-security-policy"
-
-# 7. 非法方法被拒绝
-curl -s -o /dev/null -w "%{http_code}" -X DELETE https://{server}/api/health  # 必须 403/405
-
-# 8. Volume 存在且数据完整
-docker volume ls | grep {volume_name}  # 必须存在
-
-# 9. fail2ban 运行中
-fail2ban-client status sshd
-
-# 10. 正常服务可用
-curl -s https://{server}/api/health  # 必须返回 200
-```
-
-## 十三、违规处理流程
-
-当 AI 检测到操作违反以上任何规则时：
-
-1. **立即停止**当前操作
-2. **明确告知**用户违反了哪条规则
-3. **说明风险**（可能导致的安全后果）
-4. **等待用户确认**后才能继续执行
-5. 如果用户坚持违规操作，在代码中添加 `# SECURITY WARNING: 用户已确认此操作` 注释

package/templates/claude-global/rules/dwy-vue-api.md

@@ -1,146 +0,0 @@
----
-description: Vue 前端网络层(ekit createRequest + 拦截器插件)
-paths:
-  - "**/api/**/*.ts"
-  - "**/api/**/*.vue"
-  - "**/api/client.ts"
----
-
-# Vue 前端网络层规范
-
-## 六、API 请求规范
-
-### 强制规则
-
-- API 文件按**业务域拆分**（`api/user.ts`、`api/exam.ts`）
-- 每个 API 函数**独立导出**，不使用 default export
-- 请求参数和响应使用**类型标注**
-- **禁止**在组件中直接创建 axios 实例或调用 `fetch`
-
-### API 文件结构
-
-```typescript
-// api/user.ts
-import request from '@/utils/request'
-import type { UserInfo, UserCreate, UserUpdate } from '@/types/user'
-
-export function getUsers(params?: { page?: number; page_size?: number }) {
-  return request.get<{ items: UserInfo[]; total: number }>('/users', { params })
-}
-
-export function getUser(id: number) {
-  return request.get<UserInfo>(`/users/${id}`)
-}
-
-export function createUser(data: UserCreate) {
-  return request.post<UserInfo>('/users', data)
-}
-
-export function updateUser(id: number, data: UserUpdate) {
-  return request.put<UserInfo>(`/users/${id}`, data)
-}
-
-export function deleteUser(id: number) {
-  return request.delete(`/users/${id}`)
-}
-```
-
-### 请求实例配置
-
-```typescript
-// utils/request.ts
-import axios from 'axios'
-
-const request = axios.create({
-  baseURL: '/api',
-  timeout: 30000,
-})
-
-// Token 注入
-request.interceptors.request.use((config) => {
-  const token = localStorage.getItem('token')
-  if (token) {
-    config.headers.Authorization = `Bearer ${token}`
-  }
-  return config
-})
-
-// 401 处理
-request.interceptors.response.use(
-  (response) => response,
-  (error) => {
-    if (error.response?.status === 401) {
-      localStorage.removeItem('token')
-      window.location.href = '/login'
-    }
-    return Promise.reject(error)
-  },
-)
-
-export default request
-```
-
-### 禁止的写法
-
-```typescript
-// ❌ 在组件中直接调用
-const res = await axios.get('/api/users')
-
-// ✅ 通过 API 模块调用
-import { getUsers } from '@/api/user'
-const res = await getUsers()
-
-// ❌ API 函数使用 default export
-export default { getUsers, createUser }
-
-// ✅ 每个函数独立导出
-export function getUsers() { ... }
-export function createUser() { ... }
-```
-
----
-
-## 网络层规范（ekit 统一方案）
-
-### Vue 前端
-
-**唯一方式：** ekit `createRequest()` + 插件。
-
-```typescript
-// api/client.ts
-import { createRequest } from '@dwydev/ekit'
-
-export const request = createRequest({
-  baseURL: import.meta.env.VITE_API_BASE_URL,
-  plugins: [
-    tokenPlugin(),         // 注入 Authorization header
-    refreshTokenPlugin(),  // 401 自动刷新
-    unwrapPlugin(),        // 解包响应 → data
-  ],
-})
-
-// api/user.ts — 按业务域拆分
-export function getUsers(params: { page: number; page_size: number }) {
-  return request.get('/users', { params })
-}
-
-export function createUser(data: UserCreate) {
-  return request.post('/users', data)
-}
-```
-
-**禁止：** `axios.create()`、`fetch()`、`new XMLHttpRequest()`
-
-### 响应解包
-
-前端的解包逻辑必须与后端 eapi response 格式对齐：
-
-```
-后端返回: { code: "SUCCESS", message: "success", data: {...}, timestamp: ... }
-                                                      ↓ unwrap
-前端拿到: {...}  (直接是 data 的内容)
-```
-
-分页响应解包后拿到 `{ items, total, page, page_size }`（保持 snake_case 对齐后端 JSON）。
-
-业务失败时（`code !== "SUCCESS"`），unwrapPlugin 抛出的 HttpError 携带 `businessCode` 和 `apiResponse`。业务 catch 中用 `isApiBusinessError(err)` 做类型守卫后按 `err.businessCode` 分支（如 `NOT_FOUND` / `VALIDATION_ERROR` / `PERMISSION_DENIED`）；`VALIDATION_ERROR` 场景可用 `extractValidationErrors(err)` 直接给 vee-validate 的 `setErrors` 回填。