# 内容监控 2.0 (v7.6.0)：Twitter (X) 监控支持 需求规格 (Spec v1)

## 1. 功能目标
在内容监控模块中实现对 Twitter (X) 平台的全面适配，确保图文贴文的解析准确、指标完整，并与现有监控体系无缝融合。

## 2. 核心功能需求

### 2.1 链接识别与内容解析 (Parsing)
*   **支持域名**: `twitter.com`, `x.com`。
*   **解析能力**:
    *   **发布者信息**: 头像、显示名、Twitter Handle (@username)。
    *   **多媒体内容**: 解析首张图片、视频封面或 GIF 动图。
    *   **文字内容**: 解析完整推文文本（支持换行与链接）。

### 2.2 监控指标映射 (Metrics Mapping)
Twitter 的数据维度需与系统现有的指标列进行映射展示：
| 系统通用指标 | Twitter (X) 对应指标 | 备注 |
| :--- | :--- | :--- |
| 播放量 | **阅读量 (Views)** | 映射展示，表头动态切换 |
| 点赞量 | 点赞 (Likes) | 直接对应 |
| 评论量 | 回复 (Replies) | 直接对应 |
| 分享量 | **转推 (Retweets)** | 包含直接转发，映射展示 |
| 收藏量 | **书签 (Bookmarks)** | **新增特有列**，衡量深度互动 |

### 2.3 列表动态视图逻辑
*   **平台 Tab 联动**:
    *   当选择“全部”或“非 Twitter”平台时，仅展示通用指标。
    *   当切换至 **“Twitter” 平台 Tab** 时：
        *   列表表头“播放量”文字更名为“阅读量”。
        *   列表表头“分享量”文字更名为“转推”。
        *   **新增展示“书签”列**（默认隐藏，用户可自定义开启，或在 Twitter 视图下默认展示）。

### 2.4 内容预览策略 (Content Preview)
...
    *   **目的**: 解决列表页缺失封面导致的视觉空洞问题。

### 2.5 特殊内容类型适配 (Special Content Types)
*   **推文串 (Threads)**:
    *   **列表表现**: 内容标题前增加 `[串 (Thread)]` 文本标签或图标。
    *   **数据范围**: 以 Thread 的首推 (Primary Tweet) 数据为准。
*   **投票 (Polls)**:
    *   **详情页增强**: 增加“投票结果”组件，展示各个选项的文案及当前得票百分比。
    *   **指标**: 新增“投票总数 (Poll Votes)”统计。
*   **引用推文 (Quotes)**:
    *   **内容展示**: 详情页采用“叠加卡片”样式，上方显示本推文，下方嵌入显示被引用推文的预览（头像、姓名、正文摘要）。

### 2.5 数据汇总面板适配
*   **汇总逻辑**:
    *   Twitter 的阅读量累加进“总播放量”。
    *   Twitter 的点赞+回复+转推+书签累加进“总互动量”。

## 3. 字段定义表
| 字段名称 | UI 标签 | 数据类型 | 说明 |
| :--- | :--- | :--- | :--- |
| x_views | 阅读量 | Integer | 映射至 views 字段 |
| x_retweets | 转推 | Integer | 映射至 shares 字段 |
| x_bookmarks | 书签 | Integer | Twitter 专用新增字段 |
| x_replies | 回复 | Integer | 映射至 comments 字段 |