novalon-website/docs/plans/PARALLEL_EXECUTION_GUIDE.md

独立会话执行指导

📋 工作环境已准备就绪

Worktree路径: /Users/zhangxiang/Codes/Gitee/home-page/novalon-website-fix-critical-issues 分支名称: fix/critical-issues 基础分支: feat-init

---

🚀 执行步骤

步骤1: 打开新的IDE会话

在新的IDE窗口或终端中打开worktree目录:

cd /Users/zhangxiang/Codes/Gitee/home-page/novalon-website-fix-critical-issues

步骤2: 验证环境

# 检查当前分支
git branch

# 应该显示: * fix/critical-issues

# 检查git状态
git status

# 应该显示: clean working directory

步骤3: 安装依赖(如果需要)

# 如果node_modules不存在,安装依赖
npm install

# 如果e2e目录需要依赖
cd e2e && npm install

步骤4: 启动开发服务器

# 在worktree根目录启动开发服务器
npm run dev

# 服务器将在 http://localhost:3000 启动

步骤5: 在新会话中调用executing-plans技能

在新的Trae IDE会话中,执行以下操作:

1. 打开新会话

   • 在新的IDE窗口中打开worktree目录
   • 确保工作目录是: /Users/zhangxiang/Codes/Gitee/home-page/novalon-website-fix-critical-issues

2. 调用executing-plans技能

   @executing-plans
   

3. 指定修复计划文件

   请执行修复计划: docs/plans/2026-03-07-critical-issues-fix.md
   

---

📝 修复计划概览

修复计划包含8个任务:

1. Task 1: 修复移动端导航菜单功能 (P0, 2-3小时)
2. Task 2: 修复主导航菜单显示 (P0, 1-2小时)
3. Task 3: 修复页面区块显示问题 (P0, 2-3小时)
4. Task 4: 修复工作时间信息获取 (P1, 30分钟)
5. Task 5: 修复页面滚动功能 (P1, 1-2小时)
6. Task 6: 修复联系页面标题 (P2, 10分钟)
7. Task 7: 运行完整测试套件验证 (P0, 45分钟)
8. Task 8: 创建修复完成报告 (P0, 30分钟)

预计总时间: 1-2个工作日

---

🔍 执行检查点

检查点1: P0问题修复完成

时间: 第1天下午 验证:

• 移动端导航菜单功能正常
• 主导航菜单显示正常
• 页面区块显示完整

测试命令:

cd e2e
npm run test:smoke -- --grep "导航冒烟测试"
npm run test:smoke -- --grep "首页冒烟测试"

检查点2: 所有问题修复完成

时间: 第2天上午 验证:

• P0问题全部修复
• P1问题全部修复
• P2问题全部修复

测试命令:

cd e2e
npm run test:smoke

检查点3: 测试通过率达到标

时间: 第2天下午 验证:

• 测试通过率 >95%
• 无P0或P1问题
• 准备上线

测试命令:

cd e2e
npm run test:smoke
node analyze-results.js

---

📊 成功标准

修复完成后,应该达到以下标准:

• ✅ 测试通过率 >95%
• ✅ 导航测试 100%通过
• ✅ 首页测试 100%通过
• ✅ 联系页面测试 100%通过
• ✅ 零个P0或P1问题
• ✅ 准备上线

---

🔄 回滚计划

如果修复过程中出现问题:

回滚单个提交

# 查看提交历史
git log --oneline

# 回滚到指定提交
git revert <commit-hash>

# 重新测试
cd e2e && npm run test:smoke

回滚到初始状态

# 重置到worktree创建时的状态
git reset --hard b7d400e

# 清理未跟踪的文件
git clean -fd

---

📞 技术支持

遇到问题时:

1. 检查修复计划文件: docs/plans/2026-03-07-critical-issues-fix.md
2. 查看测试报告: e2e/test-results/results.json
3. 运行测试分析: e2e/analyze-results.js

常见问题:

• 问题: 测试超时

  • 解决: 增加测试超时时间或检查网络连接

• 问题: 选择器找不到元素

  • 解决: 检查页面结构,更新选择器

• 问题: 移动端菜单无法打开

  • 解决: 检查mobile-menu组件的ARIA属性

---

✅ 完成后的操作

修复完成后,执行以下操作:

1. 生成最终测试报告

cd e2e
npm run test:smoke
node analyze-results.js

2. 创建修复完成报告

修复计划中的Task 8会自动生成报告

3. 合并到主分支

# 切换到主分支
cd /Users/zhangxiang/Codes/Gitee/home-page/novalon-website
git checkout feat-init

# 合并修复分支
git merge fix/critical-issues

# 推送到远程
git push

4. 清理worktree

# 删除worktree
git worktree remove /Users/zhangxiang/Codes/Gitee/home-page/novalon-website-fix-critical-issues

---

📋 执行清单

在开始执行前,确认:

• 已打开新的IDE会话
• 工作目录是worktree路径
• 开发服务器已启动
• 已调用executing-plans技能
• 已指定修复计划文件

---

🎯 下一步

现在请执行以下操作:

1. 在新的IDE窗口中打开: /Users/zhangxiang/Codes/Gitee/home-page/novalon-website-fix-critical-issues

2. 在新会话中调用:

   @executing-plans
   

3. 指定修复计划:

   请执行修复计划: docs/plans/2026-03-07-critical-issues-fix.md
   

4. 按照计划逐个任务执行

---

祝您修复顺利! 🚀

如有任何问题,请参考修复计划文件或联系技术支持。