diff --git a/docs/test-migration-analysis.md b/docs/test-migration-analysis.md
new file mode 100644
index 0000000..096d05c
--- /dev/null
+++ b/docs/test-migration-analysis.md
@@ -0,0 +1,311 @@
+# Python测试用例迁移分析报告
+
+**创建时间**: 2026-02-28  
+**分析范围**: `e2e-tests/tests/` 目录下的所有Python测试文件
+
+---
+
+## 一、测试用例统计
+
+### 1.1 总体统计
+
+| 测试文件 | 测试用例数 | 主要标签 | 优先级 |
+|---------|-----------|---------|--------|
+| test_contact_form.py | 20 | smoke, regression, form, performance, responsive | 高 |
+| test_home_page.py | 30 | smoke, regression, navigation, performance, responsive | 高 |
+| test_navigation.py | 20 | navigation, smoke, interactive, responsive | 高 |
+| test_performance.py | 20 | performance, smoke, responsive | 中 |
+| test_responsive.py | 25 | responsive, smoke | 中 |
+| **总计** | **115** | - | - |
+
+### 1.2 测试类型分布
+
+```
+Smoke测试:        15个 (13%)
+Regression测试:   35个 (30%)
+Performance测试:  25个 (22%)
+Responsive测试:   30个 (26%)
+Interactive测试:  10个 (9%)
+```
+
+---
+
+## 二、核心测试场景识别
+
+### 2.1 高优先级测试场景（必须迁移）
+
+#### 联系表单测试 (test_contact_form.py)
+
+**Smoke测试**:
+- ✅ `test_contact_page_loads` - 页面加载验证
+- ✅ `test_contact_page_title` - 页面标题验证
+
+**Regression测试**:
+- ✅ `test_contact_page_structure` - 页面结构验证
+- ✅ `test_contact_page_company_info` - 公司信息显示
+- ✅ `test_contact_page_form_fields` - 表单字段验证
+- ✅ `test_form_validation_required_fields` - 必填字段验证
+- ✅ `test_form_submission_success` - 表单提交成功
+- ✅ `test_form_with_empty_name` - 姓名为空验证
+- ✅ `test_form_with_invalid_email` - 无效邮箱验证
+- ✅ `test_form_with_special_characters` - 特殊字符处理
+- ✅ `test_form_with_long_content` - 长内容处理
+
+**Playwright对应文件**: `e2e/src/tests/regression/contact-page.spec.ts`
+
+---
+
+#### 首页测试 (test_home_page.py)
+
+**Smoke测试**:
+- ✅ `test_home_page_loads_successfully` - 页面加载验证
+- ✅ `test_home_page_title` - 页面标题验证
+- ✅ `test_home_page_url` - URL验证
+
+**Regression测试**:
+- ✅ `test_home_page_header` - 页头验证
+- ✅ `test_home_page_hero_section` - Hero区域验证
+- ✅ `test_home_page_services_section` - 服务区域验证
+- ✅ `test_home_page_products_section` - 产品区域验证
+- ✅ `test_home_page_news_section` - 新闻区域验证
+- ✅ `test_home_page_contact_section` - 联系区域验证
+- ✅ `test_home_page_footer` - 页脚验证
+- ✅ `test_home_page_all_sections` - 所有区域验证
+
+**Playwright对应文件**: `e2e/src/tests/smoke/home-page.smoke.spec.ts`
+
+---
+
+#### 导航测试 (test_navigation.py)
+
+**Smoke测试**:
+- ✅ `test_navigate_to_home` - 导航到首页
+- ✅ `test_navigate_to_contact_page` - 导航到联系页面
+
+**Regression测试**:
+- ✅ `test_click_navigation_to_about` - 点击导航到关于区域
+- ✅ `test_click_navigation_to_services` - 点击导航到服务区域
+- ✅ `test_click_navigation_to_products` - 点击导航到产品区域
+- ✅ `test_click_navigation_to_news` - 点击导航到新闻区域
+- ✅ `test_click_navigation_to_contact` - 点击导航到联系区域
+- ✅ `test_smooth_scroll_to_section` - 平滑滚动
+- ✅ `test_page_back` - 返回上一页
+- ✅ `test_page_forward` - 前进到下一页
+- ✅ `test_page_reload` - 页面刷新
+- ✅ `test_navigation_mobile` - 移动端导航
+
+**Playwright对应文件**: `e2e/src/tests/regression/navigation.spec.ts`
+
+---
+
+### 2.2 中优先级测试场景（建议迁移）
+
+#### 性能测试 (test_performance.py)
+
+**核心性能指标**:
+- ✅ `test_home_page_load_time` - 首页加载时间
+- ✅ `test_contact_page_load_time` - 联系页面加载时间
+- ✅ `test_dom_content_loaded_time` - DOM内容加载时间
+- ✅ `test_first_paint_time` - 首次绘制时间
+- ✅ `test_first_contentful_paint` - 首次内容绘制(FCP)
+- ✅ `test_largest_contentful_paint` - 最大内容绘制(LCP)
+- ✅ `test_time_to_interactive` - 可交互时间(TTI)
+- ✅ `test_network_timing` - 网络时序
+- ✅ `test_resource_timing` - 资源时序
+- ✅ `test_form_submission_time` - 表单提交时间
+- ✅ `test_scroll_performance` - 滚动性能
+
+**Playwright对应文件**: `e2e/src/tests/performance/core-web-vitals.spec.ts`
+
+---
+
+#### 响应式测试 (test_responsive.py)
+
+**核心响应式场景**:
+- ✅ `test_homepage_mobile_375` - 移动端375px
+- ✅ `test_homepage_mobile_414` - 移动端414px
+- ✅ `test_homepage_tablet_768` - 平板端768px
+- ✅ `test_homepage_desktop_1920` - 桌面端1920px
+- ✅ `test_contact_page_mobile_375` - 联系页面移动端
+- ✅ `test_contact_page_tablet_768` - 联系页面平板端
+- ✅ `test_contact_page_desktop_1920` - 联系页面桌面端
+- ✅ `test_header_responsive_mobile` - 页头移动端响应式
+- ✅ `test_header_responsive_desktop` - 页头桌面端响应式
+- ✅ `test_navigation_responsive_mobile` - 导航移动端响应式
+- ✅ `test_hero_section_responsive` - Hero区域响应式
+- ✅ `test_services_grid_responsive` - 服务网格响应式
+- ✅ `test_products_grid_responsive` - 产品网格响应式
+- ✅ `test_news_list_responsive` - 新闻列表响应式
+- ✅ `test_contact_form_responsive` - 联系表单响应式
+- ✅ `test_footer_responsive` - 页脚响应式
+
+**Playwright对应文件**: `e2e/src/tests/responsive/responsive.spec.ts`
+
+---
+
+### 2.3 低优先级测试场景（可选迁移）
+
+#### 交互测试
+
+- `test_extract_contact_details` - 提取联系详情
+- `test_get_working_hours` - 获取工作时间
+- `test_get_company_info` - 获取公司信息
+- `test_get_statistics` - 获取统计数据
+- `test_get_featured_services` - 获取服务列表
+- `test_get_latest_news` - 获取最新新闻
+- `test_cta_button_navigation` - CTA按钮导航
+
+**说明**: 这些测试主要是数据提取和交互测试，可以在Playwright中实现，但优先级较低。
+
+---
+
+## 三、迁移映射表
+
+### 3.1 测试文件映射
+
+| Python测试文件 | Playwright测试文件 | 迁移状态 | 优先级 |
+|---------------|-------------------|---------|--------|
+| test_contact_form.py | e2e/src/tests/regression/contact-page.spec.ts | 部分完成 | 高 |
+| test_home_page.py | e2e/src/tests/smoke/home-page.smoke.spec.ts | 部分完成 | 高 |
+| test_navigation.py | e2e/src/tests/regression/navigation.spec.ts | 部分完成 | 高 |
+| test_performance.py | e2e/src/tests/performance/core-web-vitals.spec.ts | 需迁移 | 中 |
+| test_responsive.py | e2e/src/tests/responsive/responsive.spec.ts | 部分完成 | 中 |
+
+### 3.2 页面对象映射
+
+| Python页面对象 | Playwright页面对象 | 迁移状态 | 完整度 |
+|---------------|-------------------|---------|--------|
+| pages/contact_page.py | e2e/src/pages/ContactPage.ts | 部分完成 | 70% |
+| pages/home_page.py | e2e/src/pages/HomePage.ts | 部分完成 | 60% |
+| pages/base_page.py | e2e/src/pages/BasePage.ts | 部分完成 | 50% |
+
+---
+
+## 四、需要新增的测试
+
+### 4.1 安全测试（Python中缺失）
+
+**需要新增**:
+- XSS防护测试
+- CSRF保护测试
+- 安全头验证测试
+- HTTPS强制跳转测试
+
+**Playwright文件**: `e2e/src/tests/security/`
+
+### 4.2 可访问性测试（Python中缺失）
+
+**需要新增**:
+- WCAG 2.1 AA合规测试
+- 键盘导航测试
+- 屏幕阅读器兼容性测试
+- 颜色对比度测试
+- 表单标签完整性测试
+
+**Playwright文件**: `e2e/src/tests/accessibility/`
+
+### 4.3 视觉回归测试（Python中缺失）
+
+**需要新增**:
+- 关键页面截图对比
+- 组件视觉测试
+
+**Playwright文件**: `e2e/src/tests/visual/`
+
+---
+
+## 五、风险评估
+
+### 5.1 高风险项
+
+1. **页面对象不完整** - BasePage功能缺失，需要补充通用方法
+2. **测试数据管理缺失** - Python使用test_data_generator，Playwright需要建立类似机制
+3. **性能测试方法差异** - Python使用performance.timing API，Playwright需要适配
+
+### 5.2 中风险项
+
+1. **响应式测试覆盖不全** - 部分响应式场景未覆盖
+2. **移动端测试不足** - 移动端交互测试较少
+3. **断言方法差异** - Python和Playwright的断言方式不同
+
+### 5.3 低风险项
+
+1. **测试用例命名** - 可以保持原有命名风格
+2. **测试标签** - 可以复用现有的标签系统
+3. **测试报告** - Playwright自带完善的报告系统
+
+---
+
+## 六、迁移建议
+
+### 6.1 迁移顺序
+
+**阶段1（高优先级）**:
+1. 完善BasePage页面对象
+2. 完善ContactPage页面对象
+3. 完善HomePage页面对象
+4. 迁移联系表单测试
+5. 迁移首页测试
+6. 迁移导航测试
+
+**阶段2（中优先级）**:
+1. 建立性能测试框架
+2. 迁移性能测试
+3. 迁移响应式测试
+4. 补充移动端测试
+
+**阶段3（新增测试）**:
+1. 实施安全测试
+2. 实施可访问性测试
+3. 实施视觉回归测试
+
+### 6.2 技术债务处理
+
+**需要重构的部分**:
+- BasePage通用方法提取
+- 测试数据管理统一
+- 性能监控工具封装
+- 断言方法标准化
+
+**需要优化的部分**:
+- 测试执行时间优化
+- 测试稳定性提升
+- 测试覆盖率提高
+
+---
+
+## 七、总结
+
+### 7.1 迁移工作量评估
+
+| 工作项 | 预计工作量 | 优先级 |
+|-------|-----------|--------|
+| 页面对象完善 | 2-3天 | 高 |
+| 核心测试迁移 | 3-4天 | 高 |
+| 性能测试迁移 | 1-2天 | 中 |
+| 响应式测试迁移 | 1-2天 | 中 |
+| 安全测试新增 | 1-2天 | 中 |
+| 可访问性测试新增 | 1-2天 | 中 |
+| CI/CD集成 | 1-2天 | 高 |
+| **总计** | **10-18天** | - |
+
+### 7.2 关键成功因素
+
+1. **保持测试覆盖完整** - 确保所有核心场景都有对应测试
+2. **提高测试质量** - 利用Playwright优势提升测试稳定性
+3. **建立完善的测试体系** - 补充安全、可访问性等专项测试
+4. **优化测试执行效率** - 利用并行执行缩短测试时间
+
+### 7.3 下一步行动
+
+1. ✅ 完成Python测试分析（当前任务）
+2. ⏭️ 评估现有Playwright测试覆盖
+3. ⏭️ 准备测试数据管理
+4. ⏭️ 配置多环境支持
+5. ⏭️ 开始核心测试迁移
+
+---
+
+**文档版本**: v1.0  
+**最后更新**: 2026-02-28  
+**维护者**: 张翔