# 白牌项目一个月改造计划

## 项目背景
- **目标**：基于现有 YuMi 项目创建白牌版本，规避 App Store 审查
- **时间**：1个月
- **约束**：保留大部分基建代码和 SDK，功能可适当裁剪
- **核心策略**：三层剥离法（标识层 100% + 视觉层 80% + 代码结构层 30%）

---

## Week 1: 标识层改造（100%）- 不可逆的关键改动

### Day 1-2: 项目基础标识
- [ ] 创建新的 Xcode Project（新 Bundle ID、新证书）
- [ ] 全局替换类名前缀（5个前缀）
  - `YM` → `新前缀1`（如 `LK`）
  - `XP` → `新前缀2`（如 `SL`）
  - `PI` → `新前缀3`（如 `MT`）
  - `Moli` → `新前缀4`（如 `Nova`）
  - `MS` → `新前缀5`（如 `AS`）
- [ ] 替换所有宏定义前缀
  - `YUMI` → `新宏前缀`
- [ ] 修改全局常量文件
  - `YUMIConstant.h/m` → 重命名 + 内容修改
  - `YUMIHtmlUrl.h/m` → 重命名 + 内容修改

### Day 3: 文件和模块重命名
- [ ] 重命名核心模块文件夹
  - `YMLogin` → `新名字`
  - `YMMessage` → `新名字`
  - `YMMine` → `新名字`
  - `YMMonents` → `新名字`
  - `YMNewHome` → `新名字`
  - `YMRoom` → `新名字`
  - `YMTabbar` → `新名字`
- [ ] 重命名 Pod 项目名
  - `YuMi.podspec` → 新名字
- [ ] 修改 Podfile 引用

### Day 4-5: 字符串常量清理
- [ ] 扫描所有硬编码字符串（grep "YuMi|Moli|YUMI"）
- [ ] 替换 UserDefaults/Keychain 的 key 前缀
- [ ] 替换所有中文文案为新的品牌名（可选保留，用新马甲名）
- [ ] 修改多语言文件（.strings）

---

## Week 2: 视觉层改造（80%）- UI/UX 大改

### Day 6-7: 资源文件全量替换
- [ ] **图片资源批量处理**（2971个文件）
  - 编写脚本批量重命名所有图片
  - 更换核心 icon（登录、TabBar、导航栏按钮等）
  - 调整配色方案（主题色、渐变色）
  - 工具：使用 Python/Shell 脚本 + ImageMagick
- [ ] **SVGA 动画资源**
  - 重命名所有 .svga 文件
  - 替换关键动画（登录动画、礼物动画）
- [ ] **App Icon 和启动图**
  - 全新设计 AppIcon
  - 替换 LaunchScreen

### Day 8-9: UI 组件库改造
- [ ] 颜色系统重构
  - 修改 `DJDKMIMOMColor.h/m` 为新的色值
  - 建立新的 UIColor 扩展类（不要用原类名）
- [ ] 通用 UI 组件重写
  - `MoliAvatar` → 新的头像组件（改渲染逻辑）
  - `SexAgeLabel` → 新样式
  - `MoliMoneyLabel` → 新样式
  - 所有渐变效果改变方向或色值
- [ ] 字体系统（可选）
  - 替换默认字体为另一种商业字体

### Day 10-12: TabBar 和导航栏重构
- [ ] **TabBar 结构调整**
  - 更改 Tab 数量（5个→4个？或6个？）
  - 更改 Tab 顺序（如：首页/消息/我的 → 消息/首页/我的）
  - 完全重写 `XPTabBar.h/m` 布局逻辑
  - 新的选中/未选中动画效果
- [ ] **导航栏样式**
  - `BaseViewController` 的导航栏改为新样式
  - 所有返回按钮、右侧按钮图标更换
  - 导航栏背景色/透明度调整

---

## Week 3: 代码结构层改造（30%）- 关键差异化

### Day 13-15: 核心页面 UI 重构
- [ ] **登录页面**（`YMLogin` 模块）
  - 完全重写 UI 布局（从竖向改横向？）
  - 登录方式顺序调整
  - 新的视觉风格
- [ ] **首页**（`YMNewHome` 模块）
  - 房间列表布局改变（瀑布流→网格？）
  - 筛选器位置和样式调整
  - Banner 尺寸和位置变化
- [ ] **房间页**（`YMRoom` 模块）
  - ⚠️ 这是最大的模块（1059个文件）
  - **策略**：只改 UI 层，不动业务逻辑
  - 拆分 `XPRoomViewController.m`（4605行）
    - 提取礼物模块为独立 ViewController
    - 提取 PK 模块为独立 ViewController
    - 提取底部控制栏为独立 View

### Day 16-17: 消息和动态模块
- [ ] **消息列表**（`YMMessage` 模块）
  - Cell 样式完全重写
  - 时间显示格式改变
  - 头像位置调整
- [ ] **动态/朋友圈**（`YMMonents` 模块）
  - 布局方式改变（卡片式→列表式？）
  - 交互手势调整（点赞动画、评论入口）

### Day 18-19: 个人中心模块
- [ ] **我的页面**（`YMMine` 模块）
  - 顶部个人信息卡片重新设计
  - 设置项图标和顺序调整
  - 等级/财富展示方式改变

---

## Week 4: 功能裁剪和测试

### Day 20-21: 功能裁剪（可选）
根据实际情况，可以移除以下模块以降低相似度：
- [ ] 移除小游戏模块（如果有独特的游戏）
- [ ] 移除特定的礼物动画
- [ ] 简化某些复杂的 H5 页面
- [ ] 移除品牌相关的活动页面

### Day 22-23: 网络层包装
- [ ] 在 `HttpRequestHelper` 外包一层新 API
- [ ] 更改请求头字段名（User-Agent, Custom-Headers）
- [ ] 参数加密方式微调（如果可以服务端配合）

### Day 24-28: 全面测试
- [ ] 核心功能冒烟测试
  - 登录/注册
  - 首页浏览
  - 进入房间
  - 发送消息
  - 充值流程（测试环境）
- [ ] UI 自动化测试（截图对比）
- [ ] 崩溃率监控（集成 Bugly/Firebase）
- [ ] 内存泄漏检测

### Day 29-30: 提审准备
- [ ] 准备新的 App Store 截图（5-10张）
- [ ] 撰写新的应用描述（完全不同的文案）
- [ ] 准备审核说明（强调差异化功能）
- [ ] 最终检查清单

---

## 关键技术方案

### 1. 批量类名替换脚本
```bash
#!/bin/bash
# rename_classes.sh

OLD_PREFIX="YM"
NEW_PREFIX="LK"

# 查找所有 .h 和 .m 文件
find ./YuMi -type f \( -name "*.h" -o -name "*.m" \) -exec sed -i '' "s/${OLD_PREFIX}/${NEW_PREFIX}/g" {} +

# 重命名文件
find ./YuMi -type f -name "${OLD_PREFIX}*" | while read file; do
    newname=$(echo "$file" | sed "s/${OLD_PREFIX}/${NEW_PREFIX}/g")
    mv "$file" "$newname"
done
```

### 2. 图片资源批量处理
```python
#!/usr/bin/env python3
# rename_images.py

import os
import hashlib
from PIL import Image

def rename_images(root_dir):
    for dirpath, dirnames, filenames in os.walk(root_dir):
        for filename in filenames:
            if filename.endswith(('.png', '.jpg', '.jpeg')):
                old_path = os.path.join(dirpath, filename)
                # 生成新的随机名称（基于内容hash）
                new_name = hashlib.md5(open(old_path,'rb').read()).hexdigest()[:16]
                new_path = os.path.join(dirpath, new_name + os.path.splitext(filename)[1])
                os.rename(old_path, new_path)
                print(f"Renamed: {filename} -> {new_name}")

if __name__ == "__main__":
    rename_images("./YuMi/Assets.xcassets")
```

### 3. 拆分超大类工具（XPRoomViewController）
使用 Category 方式拆分，不改变主类：
```objc
// XPRoomViewController+Gift.h
@interface XPRoomViewController (Gift)
- (void)setupGiftUI;
- (void)handleGiftAction;
@end

// XPRoomViewController+PK.h
@interface XPRoomViewController (PK)
- (void)setupPKUI;
- (void)handlePKAction;
@end
```

### 4. 颜色系统替换
```objc
// 新建 AppTheme.h
@interface AppTheme : NSObject
+ (UIColor *)primaryColor;    // 主色调
+ (UIColor *)secondaryColor;  // 辅助色
+ (UIColor *)accentColor;     // 强调色
@end

// 全局替换所有硬编码颜色
// 旧: [UIColor colorWithHex:0xFF6B9D]
// 新: [AppTheme primaryColor]
```

---

## 风险控制

### 高风险点
1. **类名替换可能误伤字符串**
   - 解决：先 grep 找出所有字符串常量，手动检查
   - 工具：`grep -r "\".*YM.*\"" ./YuMi`

2. **图片批量重命名导致找不到资源**
   - 解决：先做映射表，然后用脚本全局替换代码中的引用
   - 保留原图副本，出错可回滚

3. **第三方 SDK 回调失败**
   - 原因：某些 SDK 使用类名字符串反射
   - 解决：保留涉及 SDK 的类名不变，或在映射表中特殊处理

4. **TabBar 结构改变导致通知/跳转失败**
   - 原因：很多业务逻辑硬编码了 Tab index
   - 解决：全局搜索 `selectedIndex` 和 TabBar 相关跳转

### 测试检查清单
- [ ] 所有第三方登录（Facebook/Google/Apple）
- [ ] 支付流程（内购/第三方支付）
- [ ] IM 消息收发
- [ ] 直播推流和拉流
- [ ] 深度链接（Deep Link）
- [ ] 推送通知
- [ ] 分享功能

---

## 成功标准

### App Store 审查通过标准
1. ✅ 二进制代码相似度 < 30%（类名、方法名完全不同）
2. ✅ 所有截图视觉差异明显（配色、布局、icon）
3. ✅ Bundle ID 和签名完全不同
4. ✅ 应用描述和关键词无重叠
5. ✅ 核心功能可正常使用

### 技术债务评估
- 预计技术债务：中等
- 后续维护：需要同步维护两套代码（建议用 Git 分支管理）
- 代码质量：不会比原项目更差（因为会顺便重构）

---

## 备选方案

如果 30 天时间不够，可以采用 **最小可行方案**（MVP）：

### 最小改造清单（15天）
1. 类名全局替换（2天）
2. 核心图片替换（50个关键icon）（2天）
3. 主题色全局替换（1天）
4. TabBar 重新设计（2天）
5. 登录页重写（2天）
6. 首页重写（3天）
7. 测试和提审（3天）

这个方案可以达到约 50-60% 的差异化，适合时间极度紧张的情况。

---

## 附录：工具清单

### 开发工具
- Xcode Refactor 功能（批量重命名）
- AppCode（IntelliJ 的 OC IDE，重构能力更强）
- Shell 脚本（批量文件操作）
- Python 脚本（图片处理、文本替换）

### 设计工具
- Sketch/Figma（重新设计 UI）
- ImageMagick（批量图片处理）
- Lottie/SVGA Player（动画资源处理）

### 测试工具
- Charles/Proxyman（抓包测试网络）
- Instruments（性能和内存测试）
- Xcode UI Testing（自动化测试）

---

**制定人**: Linus Mode AI  
**创建时间**: 2025-10-09  
**预计完成时间**: 2025-11-09（30天）