Files
wwjcloud-nest-v1/tools-v1/QUICK-START.md
wanwujie b5826ee469 feat: 发布 v1 智能框架 0.1.0 版本
🚀 新增功能:
- wwjcloud-nest-v1: 完整的 NestJS 智能框架
- AI 自愈机制: @wwjcloud/auto-healing 模块
- 智能代码生成: tools-v1/php-tools 迁移工具链
- AI 能力规划: v1/docs/AI-CAPABILITY-ROADMAP.md

📦 核心模块:
- libs/wwjcloud-ai: AI 策略和恢复服务
- libs/wwjcloud-boot: 启动和配置管理
- libs/wwjcloud-core: 核心基础设施
- libs/wwjcloud-addon: 插件系统

🏗️ 架构特性:
- 分层渐进式 AI 策略
- 微服务导向的模块化设计
- 与 PHP 项目 100% 业务一致性
- Docker 容器化部署支持

📋 版本信息:
- 版本: v0.1.0
- 发布日期: 2025-01-25
- 分支: v1
2025-10-19 19:55:52 +08:00

1.8 KiB
Raw Blame History

🚀 AI 恢复模块快速启动(针对 wwjcloud-nest-v1/apps/api

目标

  • 在开发环境以最简配置验证 AI 恢复队列的闭环(事件→入队→处理→收敛)

预备条件

  • Node.js 18+
  • wwjcloud-nest-v1 中的 apps/api 可运行

环境变量(开发最简闭环)

NODE_ENV=development
PORT=3001
AI_ENABLED=true
GLOBAL_PREFIX=api
QUEUE_DRIVER=memory     # 免 Redis/Kafka 干扰
TELEMETRY_ENABLED=false
REDIS_ENABLED=false
KAFKA_ENABLED=false
JWT_SECRET=dev-secret    # 若开启守卫需配置
AUTH_ENABLED=true
RBAC_ENABLED=false

启动示例

推荐在 wwjcloud-nest-v1 目录下执行:

# 以 apps/api 方式启动(端口 3001
NODE_ENV=development JWT_SECRET=dev-secret AI_ENABLED=true AUTH_ENABLED=true RBAC_ENABLED=false GLOBAL_PREFIX=api QUEUE_ENABLED=false PORT=3001 npm run start -- api

本地验证命令

# 1) 初始队列大小(应为 0
curl -s http://localhost:3001/api/ai/recovery/status

# 2) 模拟失败(入队增长)
curl -s "http://localhost:3001/api/ai/recovery/simulate-failure?taskId=T1&severity=high&reason=quick-start"

# 3) 再次查看队列(应增长)
curl -s http://localhost:3001/api/ai/recovery/status

# 4) 处理一个(队列收敛)
curl -s -X POST http://localhost:3001/api/ai/recovery/process-one

# 5) 清空队列(可选)
curl -s -X POST http://localhost:3001/api/ai/recovery/drain

常见问题

  • Kafka 报错但驱动为 memory:可忽略,不影响路由与内存队列
  • 路由前缀:GLOBAL_PREFIX=api 下基础设施路由保留原始状态码(已在异常过滤器处理)
  • 根应用与 apps/api两端可挂载 AI 模块;开发推荐统一在 apps/api3001验证

参考文档

  • docs/AI-RECOVERY-DEV.md
  • docs/CONFIG_SETUP.md
  • docs/DEVELOPMENT-GUIDE.md
  • docs/PRODUCTION-DEPLOYMENT.md