yith-brand-migrator/使用说明.md

# YITH 品牌迁移脚本工具包

## 📁 文件结构

```
yith/
├── migrate-script.php            # 迁移执行脚本
├── verify-data.php               # 数据验证脚本
├── rollback-script.php           # 回滚脚本
├── test-plugin.php               # 状态检查脚本
├── 品牌迁移指南.md               # 详细迁移指南
└── 使用说明.md                   # 本文件
```

## 🚀 使用方法

### 1. 检查当前状态
```bash
php test-plugin.php
```

### 2. 执行迁移
```bash
php migrate-script.php
```

### 3. 验证数据
```bash
php verify-data.php
```

### 4. 回滚（如需要）
```bash
php rollback-script.php
```

## 📊 脚本功能说明

### test-plugin.php
- 显示当前品牌数据统计
- 检查数据库连接状态
- 快速状态检查

### migrate-script.php
- 执行完整的迁移流程
- 显示迁移前后数据对比
- 包含事务安全保护
- 自动清理缓存

### verify-data.php
- 验证迁移后的数据完整性
- 显示品牌列表和统计信息
- 检查产品关联和元数据

### rollback-script.php
- 将原生品牌回滚为 YITH 品牌
- 完全逆向操作
- 包含安全检查

## ⚠️ 注意事项

1. **备份数据**：执行迁移前请备份数据库
2. **测试环境**：建议先在测试环境中验证
3. **插件冲突**：确保 YITH 品牌插件已停用
4. **权限检查**：确保有足够的数据库操作权限

## 🔧 技术细节

- **数据库操作**：使用 WordPress 原生 `$wpdb` 类
- **事务安全**：所有操作都包含在数据库事务中
- **缓存处理**：自动清理 WordPress 和 WooCommerce 缓存
- **错误处理**：完整的错误捕获和回滚机制

## 📞 技术支持

如遇到问题，请检查：
1. WordPress 和 WooCommerce 版本兼容性
2. 数据库权限设置
3. PHP 错误日志
4. 插件冲突情况