# v7.4.0 背景文档

> **状态**：✅ 已完成（基于交互讨论和历史记录整理）
>
> 本文档沉淀 v7.4.0（其他社媒搜索初版）的历史决策，作为 v7.4.1 的前置背景。

---

## 一、需求背景

**业务动机**：
- 用户真实需求：销售/客户成功团队收集的反馈表明，用户需要跨平台搜索网红的能力
- 竞品因素：部分竞品已支持 Facebook/Twitter 搜索功能

**核心思路**：
同一网红的多个社媒平台账号大概率调性一致，可以通过 YouTube/Instagram/TikTok 等已有平台按条件搜索，再筛选拥有对应社媒账号的频道，实现"其他社媒搜索"。

---

## 二、方案选型

**决策时间**：2025.11.10-11.16

**最终决策**：采用 **方案1（平行分离）+ 方案3（内嵌筛选）**

### 方案1：平行分离

- Facebook/Twitter 在搜索中**平行于已有平台**（YouTube/Instagram/TikTok），每个平台独立，单选切换
- **数据源**：已有平台的关联社媒
- **搜索逻辑**：搜索条件先应用于三个已有平台 → 筛选【拥有对应社媒账号】的频道 → 合并结果
- **结果形式**：左侧展示 Facebook/Twitter 账号占位样式，右侧展示原始三平台（YouTube/TikTok/Instagram）的召回数据

### 方案3：内嵌筛选

- 在已有平台的搜索结果中，增加【拥有其他社媒账号】的多选筛选项
- 作为方案1的补充，让用户在搜索 YouTube/Instagram/TikTok 时也能快速过滤出有 Facebook/Twitter 账号的网红

### 被否决的方案

**方案2：平行聚合**
- 所有其他平台合并在一个独立选项中，在内部细分
- 被否决原因：不同平台的账号数据结构、展示形式差异较大，合并会导致体验不一致

---

## 三、功能范围（v7.4.0 实际上线内容）

**上线时间**：2025.12

**上线范围**：Facebook 搜索 + Twitter 搜索 **同时上线**

### 共同特点（"伪装搜索"）

两者都使用**桥接逻辑**：
- 实际搜索的是 YouTube 数据
- 取"关联了 Facebook/Twitter 的频道"作为过滤条件
- 展示时左侧为 Facebook/Twitter 样式占位，右侧为原始三平台（YouTube/TikTok/Instagram）的召回数据

### 数据缺口

| 平台 | 上线状态 | 缺失数据 |
|------|----------|----------|
| Facebook | ✅ 功能上线 | 头像、粉丝量等真实数据 |
| Twitter/X | ✅ 功能上线 | 头像、粉丝量等真实数据 |

---

## 四、上线结论

**开发周期**：
- 设计阶段：2025.11.17 开始，约 3 周
- 开发阶段：2025.12.8 左右开始，约 2 周
- 上线时间：2025.12 中下旬

**功能状态**：
- Facebook 搜索：2025.12 中提测，月底上线
- Twitter 搜索：与 Facebook 同时上线，使用相同桥接逻辑

**已知问题**（2025.12 临时记录）：
- 详情页左上的"其他社媒"，部分 Twitter 的图标显示成了 Pinterest（已修复）

---

## 五、遗留问题 / 技术债

这些问题直接影响 v7.4.1 的范围界定：

| 问题 | 影响 | v7.4.1 处理方式 |
|------|------|----------------|
| Twitter 搜索数据不完整 | 缺少头像、粉丝量等展示 | **核心目标**：补齐已收集的关联 Twitter 账号数据展示 |
| 搜索条件受限 | 无法按 Twitter 粉丝量/观看量筛选 | **扩展目标**：增加粉丝量、观看量等筛选条件 |
| Facebook 数据缺口 | 与 Twitter 相同问题 | **不处理**：v7.4.1 仅迭代 Twitter，Facebook 留置不动 |
| 真实数据收集 | 需要直接抓取 Twitter 公开数据 | **不处理**：留给 v7.4.2+，v7.4.1 仍使用 YouTube 桥接逻辑 |

**v7.4.1 目标**：
- 补齐已收集的【与 YouTube 关联的 Twitter 账号】数据展示（头像、粉丝量等）
- 扩展 Twitter 搜索的筛选条件（粉丝量、观看量等）
- **限制前提**：仅迭代 Twitter，Facebook 部分留置不动

---

## 六、关键决策记录

1. **平台优先级**：Facebook 优先于 Twitter（开发顺序）
   - 原因：Facebook 网红营销需求当时更被重视，但两者同时上线

2. **数据架构决策（v7.4.0）**：复用已有平台的关联社媒数据
   - 不直接抓取 Facebook/Twitter 全量数据，而是通过 YouTube/Instagram/TikTok 频道的"关联社媒"字段实现桥接
   - 利弊：上线快，但数据覆盖度依赖原平台的关联数据完整性

3. **三平台关联规则**（相关但非 v7.4.0 重点）
   - 含义：YouTube/TikTok/Instagram 三平台之间的同一实体账号关联（如 Mr. Beast 在这三个平台的账号建立弱关联）
   - 状态：2025.11-12 持续迭代，遗留部分边界场景
   - 注意：这是独立的数据层议题，不是 v7.4.0/v7.4.1 的核心目标

---

## 七、参考资料

- 原始方案记录：`__main__.md` 2025.11 章节 "其他社媒平台搜索"
- 开发排期记录：`__main__.md` 2025.11.17-12 各周记录
- 版本速查表：`__main__.md` 版本速查表（v7.4.0 / v7.4.1）