# 个人主页子页面化能力评审设计（导航中枢模式）

## 1. 背景与目标

当前项目已经具备公开主页与多个公开子页面能力，用户可以从个人主页进入文章、时光机、阅读（RSS）等模块。  
本次评审目标是将 `@slug` 主页明确定位为“导航中枢”，避免主页继续演化为内容聚合长页。

目标如下：

- `@slug` 仅承担入口分发职责，不承担长内容阅读。
- 文章、时光机、阅读均为一等子页面，具备独立列表与分页能力。
- 公开、仅链接、私密三种可见性在公开侧严格边界清晰。
- 新增模块可按统一规范接入，保持长期可扩展性。

## 2. 方案结论

本次评审采用 **方案 1：导航中枢**。

- 主页只展示身份信息、模块入口卡片、每模块 1-2 条预览和“查看全部”。
- 子页面承载完整列表、详情跳转与后续模块特有能力。
- 首页不引入模块专属复杂交互（例如筛选、排序、阅读模式）。

## 3. 信息架构

### 3.1 页面定位

- `@slug`：个人站首页（目录页 / 导航中枢）
- `@slug/posts`：文章列表页
- `@slug/timeline`：时光机列表页
- `@slug/reading`：阅读（RSS）列表页

### 3.2 入口层级

- 一级入口：文章 / 时光机 / 阅读模块卡片
- 二级入口：卡片内最近 1-2 条预览
- 三级入口：统一“查看全部”按钮进入子页

### 3.3 内容边界

- 首页每模块最多展示 2 条预览（建议可配置，默认 2）。
- 首页不展示完整正文，不承载深度浏览流程。
- 详情阅读、历史翻页、重度交互全部下沉到子页面。

### 3.4 可扩展约束

新增公开模块必须满足：

- 提供 `@slug/<module>` 独立子页
- 在 `@slug` 提供模块卡片入口
- 提供统一“查看全部”跳转

## 4. 入口组件规范

### 4.1 卡片结构（统一骨架）

每个模块卡片应包含：

- 标题行：模块名 + 公开总数（如“文章 · 24”）
- 描述行：模块价值说明（10-18 字）
- 预览区：最近 1-2 条（标题 + 日期/来源）
- 操作区：主按钮“查看全部”，次按钮按需配置

### 4.2 文案规范

- 文章：查看全部文章
- 时光机：查看全部动态
- 阅读：查看阅读清单

文案采用“动作 + 对象”，避免“更多”等弱语义措辞。

### 4.3 状态规范

- 正常态：展示预览条目
- 空态：显示“暂无公开内容”并给出轻提示
- 异常态：显示“暂时不可用”，不暴露技术细节

### 4.4 一致性规则

- 固定顺序：文章 → 时光机 → 阅读
- 预览排序：统一按时间倒序
- 交互一致：卡片整体可点、预览可点、CTA 始终可见

## 5. 可见性与数据口径

### 5.1 公开侧展示规则

- `@slug` 主页仅展示 `public` 内容。
- `@slug/posts`、`@slug/timeline`、`@slug/reading` 公开访问仅返回 `public` 内容。
- 首页卡片计数与子页总数均以 `public` 口径计算。

### 5.2 仅链接（unlisted）规则

- 不进入 `@slug` 首页预览与计数。
- 不进入公开子页列表。
- 仅允许通过 token 链接访问（例如 `/p/:publicSlug/t/:shareToken`）。

### 5.3 私密（private）规则

- 仅后台站主可见。
- 不进入任何公开 API 返回。
- 不进入 sitemap 与公开聚合统计。

### 5.4 口径一致性要求

同一模块在以下位置的“数量与内容范围”必须一致：

- 首页卡片总数
- 子页分页总数
- 公开 SEO/结构化数据中的条目数

## 6. 风险评审结论

### 6.1 高风险

1. 统计口径不一致导致用户信任受损  
2. `unlisted` 意外进入公开列表导致泄漏

### 6.2 中风险

1. 主页功能膨胀回归为内容聚合页  
2. 主页与子页 SEO 信号冲突  
3. 新模块接入方式不统一导致维护复杂度上升

### 6.3 低风险

1. 首页聚合请求过重影响首屏性能

## 7. 验收标准（最小集）

1. 访客访问 `@slug` 仅看到公开模块与公开预览。  
2. `unlisted` 内容无法通过首页与公开子页列表发现，仅 token 可达。  
3. 子页分页总数与首页模块计数口径一致。  
4. 模块空态与异常态表现统一，不影响其他模块。  
5. 主页与子页 canonical 各自独立，`unlisted` 不进入 sitemap。  
6. 新模块可按“卡片入口 + 独立子页 + 查看全部”模板接入。

## 8. 实施边界（本次仅设计评审）

本文件仅确认信息架构与评审结论，不直接包含代码改造。  
下一步应进入实现规划阶段，将本设计拆分为可执行任务（路由、数据聚合、组件抽象、SEO 与测试）。

## 9. 规格自检（已完成）

- 已检查：无 TBD/TODO 占位符。  
- 已检查：信息架构、可见性规则、验收标准之间无明显冲突。  
- 已检查：范围聚焦于“导航中枢化评审”，未引入无关重构。  
- 已检查：关键术语（公开/仅链接/私密）定义明确，口径一致。