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
This commit is contained in:
wanwujie
2025-10-19 19:55:52 +08:00
parent e7a1d6b4d6
commit b5826ee469
1103 changed files with 179805 additions and 1672 deletions

59
tools-v1/QUICK-START.md Normal file
View File

@@ -0,0 +1,59 @@
# 🚀 AI 恢复模块快速启动(针对 wwjcloud-nest-v1/apps/api
## 目标
- 在开发环境以最简配置验证 AI 恢复队列的闭环(事件→入队→处理→收敛)
## 预备条件
- Node.js 18+
- `wwjcloud-nest-v1` 中的 `apps/api` 可运行
## 环境变量(开发最简闭环)
```bash
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` 目录下执行:
```bash
# 以 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
```
## 本地验证命令
```bash
# 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/api`3001验证
## 参考文档
- `docs/AI-RECOVERY-DEV.md`
- `docs/CONFIG_SETUP.md`
- `docs/DEVELOPMENT-GUIDE.md`
- `docs/PRODUCTION-DEPLOYMENT.md`