xiaozhi/jk-rag-platform_old/VITE_7_TEST_PLAN.md

Vite 7 升级测试计划

测试时间: 2024-01-19
当前版本: Vite 6.3.4
目标版本: Vite 7.1.11
项目: jkec-xiaozhi-v2/jk-rag-platform

---

📋 测试策略

测试环境

建议: 在测试分支或本地环境测试

# 1. 创建测试分支（可选）
git checkout -b test/vite-upgrade

# 2. 备份当前配置
cp package.json package.json.backup

---

🧪 测试步骤

阶段 1：安装 Vite 7

# 1. 安装 Vite 7.1.11
npm install vite@7.1.11 --save-dev

# 2. 验证安装
npm list vite

# 预期输出：
# vite@7.1.11

检查项:

• 安装成功
• 无依赖冲突警告
• node_modules 正常

---

阶段 2：开发服务器测试

# 1. 清理 Vite 缓存
rm -rf node_modules/.vite

# 2. 启动开发服务器
npm run start:demo

检查项:

• 服务器正常启动
• 无启动错误
• 控制台无警告
• HMR 正常工作

预期:

  VITE v7.1.11  ready in 500 ms

  ➜  Local:   http://localhost:3100/
  ➜  Network: use --host to expose

---

阶段 3：页面加载测试

核心页面（必须测试）

页面	URL	检查项	状态
登录页	/login	页面加载、自动登录	⏳
应用广场	/appCenter	列表加载、筛选功能	⏳
首页	/overview	图表显示、统计卡片	⏳
创建应用	/appCenter/questionAnswer/create	表单加载	⏳
知识库列表	/knowledge/knowledgeLib	列表加载、CRUD	⏳
API 管理	/system/apiKey	列表加载	⏳
应用审核	/system/audit	列表加载	⏳

功能测试

每个页面需要测试:

• 页面正常渲染
• 样式正常显示
• 交互功能正常
• 无控制台错误
• 无网络请求失败

---

阶段 4：构建测试

# 1. 运行构建
npm run build:demo

# 2. 检查构建输出
ls -la dist/

# 3. 预览构建结果（可选）
npm run preview

检查项:

• 构建成功
• 无构建错误
• 无构建警告
• dist 目录正常生成
• 资源文件完整

预期输出:

✓ built in 5.00s

---

阶段 5：自动化测试

# 运行自动化测试
node test-migration.js

检查项:

• 所有测试通过
• 成功率 100%
• 无警告

---

阶段 6：性能对比

开发服务器性能

指标	Vite 6	Vite 7	改进
冷启动时间	___ ms	___ ms	___%
HMR 响应时间	___ ms	___ ms	___%
内存占用	___ MB	___ MB	___%

测试方法:

# 记录启动时间
time npm run start:demo

# 记录 HMR 响应（修改文件后观察控制台）

构建性能

指标	Vite 6	Vite 7	改进
构建时间	___ s	___ s	___%
输出大小	___ KB	___ KB	___%

测试方法:

# 记录构建时间
time npm run build:demo

# 检查输出大小
du -sh dist/

---

📊 测试结果记录

安装测试

检查项	预期	实际	状态
安装成功	✅	⏳	⏳
无依赖冲突	✅	⏳	⏳
版本正确	7.1.11	⏳	⏳

开发服务器测试

检查项	预期	实际	状态
启动成功	✅	⏳	⏳
无错误	✅	⏳	⏳
HMR 正常	✅	⏳	⏳
版本显示	v7.1.11	⏳	⏳

页面加载测试

页面	加载正常	样式正常	功能正常	状态
登录页	⏳	⏳	⏳	⏳
应用广场	⏳	⏳	⏳	⏳
首页	⏳	⏳	⏳	⏳
创建应用	⏳	⏳	⏳	⏳
知识库列表	⏳	⏳	⏳	⏳
API 管理	⏳	⏳	⏳	⏳
应用审核	⏳	⏳	⏳	⏳

构建测试

检查项	预期	实际	状态
构建成功	✅	⏳	⏳
无错误	✅	⏳	⏳
构建时间	<10s	⏳	⏳
输出完整	✅	⏳	⏳

自动化测试

检查项	预期	实际	状态
总测试数	8	⏳	⏳
通过数	8	⏳	⏳
成功率	100%	⏳	⏳

性能对比

指标	Vite 6	Vite 7	改进	状态
冷启动	___ ms	___ ms	___%	⏳
HMR	___ ms	___ ms	___%	⏳
构建时间	___ s	___ s	___%	⏳

---

🎯 通过标准

必须通过（P0）

• 开发服务器正常启动
• 所有核心页面正常加载
• 构建成功
• 自动化测试 100% 通过

建议通过（P1）

• HMR 正常工作
• 样式正常显示
• 无控制台错误
• 性能有提升

可选验证（P2）

• 性能提升达到预期
• 包体积减小
• 新功能可用

---

📝 测试报告模板

测试完成后，填写以下报告：

# Vite 7 升级测试报告

**测试时间**: _________
**测试人**: _________

## 测试结果

### 安装测试
状态：✅ 通过 / ❌ 失败

### 开发服务器测试
状态：✅ 通过 / ❌ 失败

### 页面加载测试
状态：✅ 通过 / ❌ 失败

### 构建测试
状态：✅ 通过 / ❌ 失败

### 自动化测试
状态：✅ 通过 / ❌ 失败

### 性能对比
- 冷启动：___ ms → ___ ms (___%)
- HMR：___ ms → ___ ms (___%)
- 构建：___ s → ___ s (___%)

## 问题记录

### 问题 1
**描述**: _________
**影响**: _________
**解决方案**: _________

## 结论

**建议**: ✅ 可以升级 / ❌ 暂缓升级

**理由**: _________

---

🚀 执行测试

快速测试（15 分钟）

# 1. 安装 Vite 7
npm install vite@7.1.11 --save-dev

# 2. 清理缓存
rm -rf node_modules/.vite

# 3. 启动开发服务器
npm run start:demo

# 4. 访问关键页面
# - http://localhost:3100/login
# - http://localhost:3100/appCenter
# - http://localhost:3100/knowledge/knowledgeLib

# 5. 运行构建
npm run build:demo

# 6. 运行自动化测试
node test-migration.js

完整测试（30 分钟）

按照上述完整测试计划执行所有测试。

---

📄 相关文档

1. VITE_UPGRADE_ASSESSMENT.md - 升级评估报告
2. VITE_7_TEST_PLAN.md - 本测试计划
3. VITE_7_TEST_REPORT.md - 测试报告（测试后生成）

---

测试准备完成！请按照上述步骤执行测试。 🚀

测试完成后，填写测试报告并告诉我结果！