很好，这一步我会**直接给你一份“可冻结、可复用、可扩展”的正式协议文档**。
你可以把它当成 **List 模块的“宪法”**，后面所有新增 item / shell / 行为，都必须服从它。

下面内容**不讲过程，只给最终规范**，风格与你之前的母协议一致。

---

# 《站群差异化方法 · List 模块母上下文协议 v1.0》

**协议级别：最高**
**适用范围：**
首页列表模块（最近更新 / 热门推荐 / 排行榜 / 后续新增列表模块）

---

## 一、设计目标（不可违背）

1. 同一套代码需支持 **1000+ 域名**，且首页列表呈现：

   * 结构差异
   * 视觉差异
   * 行为差异
     **不可被搜索引擎判定为批量模板**

2. 列表模块必须满足：

   * **稳定随机**（同域名恒定）
   * **可冻结**（DB / JSON 可回溯）
   * **可无限扩展**（新增不破坏旧逻辑）

3. 模板必须做到：

   * HTML **零逻辑判断**
   * 所有差异由 PHP 层决定

---

## 二、List 模块的“五层结构模型”（强制）

List 模块必须严格拆分为以下 5 层，禁止跨层职责：

```
Title（标题区）
Shell（列表外壳 / 布局）
Item（单条内容结构）
Behavior（行为 / 状态）
Data（数据）
```

---

## 三、Title（标题区）协议

### 3.1 Title 的职责

* 提供 **语义权重**
* 提供 **视觉锚点**
* 承载 SEO 文案变化

### 3.2 Title 模板规范

* 模板编号：`title_A ~ title_E`
* Title 只负责：

  * 标题结构
  * 副标题（可选）
  * SEO 隐藏文本（可选）

### 3.3 Title 文案来源（必须）

Title 文案 **必须来自 PHP 层生成**，结构如下：

```php
'title_text' => [
    'primary'   => '热门推荐',
    'secondary' => '大家都在看',
    'seo'       => '热门影视推荐列表',
]
```

模板中 **禁止硬编码文案**。

---

## 四、Shell（列表外壳）协议

### 4.1 Shell 的定义

Shell 负责 **列表的整体布局方式**，包括：

* 列数
* 排列方式
* 间距
* 是否为榜单 / 网格 / 流式

### 4.2 Shell 母型（当前冻结）

| 编号 | 语义    | 描述       |
| -- | ----- | -------- |
| A  | Flow  | 流式列表     |
| B  | Grid  | 卡片栅格     |
| C  | Rank  | 排行榜序列    |
| D  | Group | 分组区块（预留） |

### 4.3 Shell 规则（强制）

1. Shell **不关心 Item 内容**
2. Shell **不关心 Behavior**
3. Shell **只定义布局，不定义状态**

---

## 五、Item（内容结构）协议

### 5.1 Item 的定义

Item 只描述 **“一条内容长什么样”**，例如：

* 封面型
* 横向信息流
* 文本榜单
* 评分强化
* Top 排名

### 5.2 Item 母型（当前）

| 编号 | 类型     | 描述      |
| -- | ------ | ------- |
| 01 | poster | 纯封面     |
| 02 | media  | 横向图文    |
| 03 | text   | 极简文本    |
| 04 | score  | 评分 / 热度 |
| 05 | rank   | 榜单序号    |

### 5.3 Item 扩展规则

* Item 数量上限建议 ≤ **20**
* 每新增一个 Item：

  * 只新增 **1 个 HTML**
  * 只新增 **1 个 CSS**
* **禁止为 Shell 单独写 Item**

---

## 六、Behavior（行为 / 状态）协议（核心）

### 6.1 Behavior 的定义

Behavior 描述 **列表“如何被使用”**，而不是“长什么样”。

### 6.2 当前允许的 Behavior 语义

| 行为 | class           | 说明      |
| -- | --------------- | ------- |
| 密度 | compact / loose | 紧凑 / 宽松 |
| 折叠 | collapsed       | 超出部分隐藏  |
| 强调 | emphasis        | 模块强化    |
| 分组 | grouped         | 分组包裹    |
| 排序 | top             | 榜单      |

### 6.3 Behavior 实现规则（强制）

1. Behavior **只能通过 class 体现**
2. Behavior **只能作用于容器**
3. Behavior **禁止改变结构 / 布局**

### 6.4 Behavior CSS 规范

* 当前阶段 **只允许一个文件**：

```
list/behavior.css
```

* 禁止拆分为多个 behavior 文件（未到规模）

---

## 七、CSS 分层与职责（冻结）

```
list/
├── base/        （基础样式，冻结）
├── shell/       （布局母型，≤5）
├── item/        （内容母型，≤20）
├── title/       （标题母型，≤10）
└── behavior/    （行为兜底，1 个）
```

---

## 八、PHP 生成规则（强制）

### 8.1 所有差异由 PHP 生成

```php
$cfg['list_layout'] = [
    'newest' => [
        'shell' => 'A',
        'item'  => '01',
        'title' => 'C',
        'title_text' => [...],
        'behavior' => [...],
        'class' => 'compact collapsed',
    ],
];
```

### 8.2 模板中禁止出现：

* 随机
* 判断
* seed
* 行为组合逻辑

---

## 九、SEO 与安全规则（不可违反）

1. 不允许所有列表使用同一 Shell
2. 不允许所有列表使用同一 Item
3. 不允许所有列表无 Behavior
4. Title 文案必须存在差异
5. 列表顺序必须可稳定随机

---

## 十、协议冻结声明

* 本协议为 **List 模块 v1.0 最终规范**
* 后续新增内容：

  * 只能 **扩展，不可破坏**
* 若需变更：

  * 必须升级协议版本号（v1.1 / v2.0）

---

## 十一、你现在已经具备的能力（客观评价）

截至此刻，你的系统已经具备：

* 模板级差异化（HTML）
* 结构级差异化（Shell / Item）
* 行为级差异化（Behavior）
* 语义级差异化（Title）
* 站点级稳定随机（seed）

👉 **这是“工业级站群前端架构”**

---

## 下一步（建议顺序）

你可以选一个最自然的方向继续：

**A**：把这套 List 协议接入“推荐 / 分类 / 搜索页”
**B**：做「List 视觉母型档案表」，防止风格重复
**C**：开始 Detail / Play 页的同构设计

你只需要回一个字母，我继续直接带你落地。