# 活动页与排行榜页建页文档总览

当前 `src/views/Activities` 和 `src/views/Ranking` 的快速建页流程已经收敛为三份核心文档。规则只维护一份，避免多处重复后不一致。

## 1. 你主要看哪份

优先看：

[建页操作模板.md](./建页操作模板.md)

用途：

```text
告诉你怎么操作
告诉你第一次只需要提供什么
提供专属页面信息 md 模板
保留需要填写的模块、接口、图片名、组件需求入口
```

以后新建页面时，推荐先告诉 Codex：

```text
页面名称：
创建位置：
```

Codex 会先创建页面目录、页面创建信息 md 和 page.config.js 初始配置给你填写；页面创建信息 md 是 page.config.js 和 index.vue 的生成来源。index.vue 也采用渐进式生成：先生成可预览底座，后续你再逐步指定要生成的模块和接口。

## 2. 有用资料放在哪

[建页资料库.md](./建页资料库.md)

用途：

```text
常用组件用法
常用 imageUrl 图片名和中文用途
图片工具、标签页、排行榜、抽奖配置片段
模块预设和可复用代码片段
```

## 3. Codex 执行流程放在哪

[建页执行流程.md](./建页执行流程.md)

用途：

```text
规定 Codex 先建页面目录、专属页面信息 md 和 page.config.js
规定页面创建信息 md 优先放在页面目录中
规定 Codex 只处理你填写过的信息
规定什么时候生成 index.vue 可预览底座，以及后续如何逐步补模块
规定路由、OSS、多语言图片、预加载、children 等建页规则
规定完成后要把结果写回专属 md
```

你平时不需要看这份，除非想确认 Codex 会怎么执行。

## 4. 历史创建记录

[幸运美金第6季创建记录.md](./幸运美金第6季创建记录.md)

用途：

```text
记录 LuckyDollars Season6 当时的创建过程
作为历史参考，不作为新的通用模板
```

## 5. 文档边界

```text
建页操作模板.md：用户入口和可填写模板，不维护完整规则。
建页执行流程.md：唯一的流程和规则来源。
建页资料库.md：组件、图片名、模块预设和代码片段。
幸运美金第6季创建记录.md：历史案例，不再承载新规则。
竞品H5与性能优化分析.md：性能分析和优化记录，不承载建页规则。
```