张翔
feb646efe5
feat: 为主导航菜单和页面区块添加ARIA属性 fix: 解决工作时间信息获取问题 perf: 优化页面滚动功能实现 fix: 修正联系页面标题显示问题 test: 运行完整测试套件验证修复效果 docs: 添加修复完成报告
267 lines
5.1 KiB
Markdown
267 lines
5.1 KiB
Markdown
# 独立会话执行指导
|
|
|
|
## 📋 工作环境已准备就绪
|
|
|
|
**Worktree路径**: `/Users/zhangxiang/Codes/Gitee/home-page/novalon-website-fix-critical-issues`
|
|
**分支名称**: `fix/critical-issues`
|
|
**基础分支**: `feat-init`
|
|
|
|
---
|
|
|
|
## 🚀 执行步骤
|
|
|
|
### 步骤1: 打开新的IDE会话
|
|
|
|
在新的IDE窗口或终端中打开worktree目录:
|
|
|
|
```bash
|
|
cd /Users/zhangxiang/Codes/Gitee/home-page/novalon-website-fix-critical-issues
|
|
```
|
|
|
|
### 步骤2: 验证环境
|
|
|
|
```bash
|
|
# 检查当前分支
|
|
git branch
|
|
|
|
# 应该显示: * fix/critical-issues
|
|
|
|
# 检查git状态
|
|
git status
|
|
|
|
# 应该显示: clean working directory
|
|
```
|
|
|
|
### 步骤3: 安装依赖(如果需要)
|
|
|
|
```bash
|
|
# 如果node_modules不存在,安装依赖
|
|
npm install
|
|
|
|
# 如果e2e目录需要依赖
|
|
cd e2e && npm install
|
|
```
|
|
|
|
### 步骤4: 启动开发服务器
|
|
|
|
```bash
|
|
# 在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天下午
|
|
**验证**:
|
|
- [ ] 移动端导航菜单功能正常
|
|
- [ ] 主导航菜单显示正常
|
|
- [ ] 页面区块显示完整
|
|
|
|
**测试命令**:
|
|
```bash
|
|
cd e2e
|
|
npm run test:smoke -- --grep "导航冒烟测试"
|
|
npm run test:smoke -- --grep "首页冒烟测试"
|
|
```
|
|
|
|
### 检查点2: 所有问题修复完成
|
|
|
|
**时间**: 第2天上午
|
|
**验证**:
|
|
- [ ] P0问题全部修复
|
|
- [ ] P1问题全部修复
|
|
- [ ] P2问题全部修复
|
|
|
|
**测试命令**:
|
|
```bash
|
|
cd e2e
|
|
npm run test:smoke
|
|
```
|
|
|
|
### 检查点3: 测试通过率达到标
|
|
|
|
**时间**: 第2天下午
|
|
**验证**:
|
|
- [ ] 测试通过率 >95%
|
|
- [ ] 无P0或P1问题
|
|
- [ ] 准备上线
|
|
|
|
**测试命令**:
|
|
```bash
|
|
cd e2e
|
|
npm run test:smoke
|
|
node analyze-results.js
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 成功标准
|
|
|
|
修复完成后,应该达到以下标准:
|
|
|
|
- ✅ 测试通过率 >95%
|
|
- ✅ 导航测试 100%通过
|
|
- ✅ 首页测试 100%通过
|
|
- ✅ 联系页面测试 100%通过
|
|
- ✅ 零个P0或P1问题
|
|
- ✅ 准备上线
|
|
|
|
---
|
|
|
|
## 🔄 回滚计划
|
|
|
|
如果修复过程中出现问题:
|
|
|
|
### 回滚单个提交
|
|
```bash
|
|
# 查看提交历史
|
|
git log --oneline
|
|
|
|
# 回滚到指定提交
|
|
git revert <commit-hash>
|
|
|
|
# 重新测试
|
|
cd e2e && npm run test:smoke
|
|
```
|
|
|
|
### 回滚到初始状态
|
|
```bash
|
|
# 重置到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. 生成最终测试报告
|
|
```bash
|
|
cd e2e
|
|
npm run test:smoke
|
|
node analyze-results.js
|
|
```
|
|
|
|
### 2. 创建修复完成报告
|
|
修复计划中的Task 8会自动生成报告
|
|
|
|
### 3. 合并到主分支
|
|
```bash
|
|
# 切换到主分支
|
|
cd /Users/zhangxiang/Codes/Gitee/home-page/novalon-website
|
|
git checkout feat-init
|
|
|
|
# 合并修复分支
|
|
git merge fix/critical-issues
|
|
|
|
# 推送到远程
|
|
git push
|
|
```
|
|
|
|
### 4. 清理worktree
|
|
```bash
|
|
# 删除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. 按照计划逐个任务执行
|
|
|
|
---
|
|
|
|
**祝您修复顺利!** 🚀
|
|
|
|
如有任何问题,请参考修复计划文件或联系技术支持。 |